크롬 커넥터 방식

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 9분
  • Chromium 커넥터 메서드는 애플리케이션, 화면, 및 브라우저 화면 Google ChromeMicrosoft Edge 의 요소에 대해 서로 다른 작업을 수행합니다.

    Chromium 커넥터 방법 수준

    애플리케이션 수준 메서드

    화면 수준 메서드

    요소 수준 메서드

    애플리케이션 수준 메서드

    이동

    지정된 URL을 기반으로 웹 페이지를 시작합니다.

    입력을 제공하려면 다음을 참조하십시오. 포트 속성 구성
    표 1. 메서드 매개변수 탐색
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    URL 웹 페이지의 URL입니다. 데이터 입력 문자열 기본값 없음 아니요
    시간 제한 작업 시간이 초과되기까지의 시간(초)을 지정하는 옵션입니다. 데이터 입력 정수 기본값 없음 아니요
    반환 True이면 웹 페이지가 시작된 것입니다. 그렇지 않으면 False인 경우 웹 페이지가 시작되지 않은 것입니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    WaitForAnyScreen (영문일 대기)

    지정된 화면이 로드되기 전의 지연을 설정합니다.

    화면을 지정하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 화면 선택(CHOOSE SCREENS) 창에서 필요한 화면을 선택합니다.
    3. 확인을 클릭합니다.
    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.
    표 2. 메서드 매개변수 탐색
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    MatchAllChildren (모든 어린이) True이면 화면을 로드하기 전에 메서드가 웹 페이지에서 캡처된 요소와 일치합니다. 그렇지 않으면 False이면 메서드가 요소와 일치하지 않습니다. 데이터 입력 부울 기본값 없음 아니요 요소는 Chromium 커넥터 창의 하위 일치 섹션에서 찾을 수 있습니다.
    시간 제한 작업 시간이 초과될 때까지의 시간(초)을 지정합니다. 데이터 입력 정수 기본값 없음 아니요

    화면 수준 메서드

    닫기

    캡처된 화면 창을 닫습니다.

    포커스

    캡처된 창에 포커스를 설정합니다.
    표 3. 메서드 매개변수 탐색
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 True이면 포커스가 캡처된 창에 설정되었습니다. 그렇지 않으면 False인 경우 포커스가 캡처된 창에 설정되지 않은 것입니다. 데이터 출력 부울 기본값 없음 해당 사항 없음

    GetFields

    지정된 필드 또는 요소의 값을 반환합니다. 예를 들어 버튼의 텍스트를 반환할 수 있습니다.

    필드를 지정하려면 다음 단계를 수행합니다.
    1. 방법 설정 아이콘( 방법 설정 아이콘. )을 클릭합니다.
    2. 양식 요소 선택 창에서 필수 필드를 선택합니다.
    3. 확인을 클릭합니다.
    표 4. GetFields 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    필드 또는 요소의 이름 메서드가 값을 반환하는 필드 또는 요소입니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    GetInnerHtml 님

    캡처된 화면의 내부 HTML을 반환합니다.
    표 5. GetInnerHtml 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 화면의 내부 HTML을 반환합니다. 데이터 출력 객체 해당 사항 없음 해당 사항 없음

    페이지 소스 가져오기

    캡처된 화면의 페이지 소스를 반환합니다.
    표 6. GetPageSource 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 화면의 페이지 소스를 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음

    스크린 샷 구하기

    구성된 화면의 스크린샷을 반환합니다.
    표 7. GetScreenShot 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 구성된 화면의 스크린샷을 반환합니다. 데이터 출력 비트맵 기본값 없음 해당 사항 없음

    제목 가져오기

    캡처된 웹 페이지의 제목을 반환합니다.
    표 8. GetTitle 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 웹 페이지의 제목을 반환합니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    GetURL 가져오기

    캡처된 웹 페이지의 URL을 반환합니다.
    표 9. GetURL 메서드 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 웹 페이지의 URL을 반환합니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    GetValueByXPath

    지정된 XML 경로에서 XML 노드 내의 값을 반환합니다.

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

    표 10. GetValueByXPath 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    XPath 캡처된 웹 페이지의 XPath입니다. 데이터 입력 문자열 기본값 없음 아니요
    반환 XML 노드에서 값을 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음

    IsCreated (영문)

    화면이 웹 애플리케이션에서 성공적으로 렌더링되는지 여부에 따라 부울 값을 반환합니다.

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.

    표 11. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본 유형 필수? 참고 사항
    MatchAllChildren (모든 어린이) True이면 화면이 렌더링되기 전에 메서드는 캡처된 모든 요소와 일치시키려고 시도합니다. 그렇지 않으면 False인 경우 일치가 수행되지 않습니다. 데이터 입력 부울 기본값 없음 아니요 Chromium 커넥터 창의 MATCH CHILDREN 섹션에서 캡처된 요소를 찾을 수 있습니다.
    반환 True이면 화면이 성공적으로 렌더링됩니다. 그렇지 않으면 False인 경우 화면을 성공적으로 렌더링하지 못한 것입니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    요소 수준 메서드

    먼저

    요소에 대해 클릭 작업을 수행합니다.

    포커스

    요소에 포커스를 설정합니다.

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.
    표 12. 초점 방법 매개변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    scrollIntoView True이면 메서드는 스크롤 막대를 사용하여 웹 페이지에서 캡처된 요소로 이동합니다. 그렇지 않으면 False인 경우 캡처된 요소로 스크롤되지 않습니다. 데이터 입력 부울 기본값 없음 아니요
    반환 True이면 메서드는 요소에 포커스를 설정합니다. 그렇지 않으면 False이면 메서드가 요소에 포커스를 설정하지 못한 것입니다. 데이터 출력 부울 해당 사항 없음 해당 사항 없음

    GetInnerHTML

    캡처된 요소의 내부 HTML을 반환합니다.
    표 13. GetInnerHTML 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 요소의 내부 HTML을 반환합니다. 데이터 출력 문자열 기본 유형 없음 해당 사항 없음

    GetInnerText

    캡처된 요소의 내부 텍스트를 반환합니다.
    표 14. GetInnerText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 요소의 내부 텍스트를 반환합니다. 데이터 출력 문자열 해당 사항 없음 해당 사항 없음

    GetOuterHTML

    HTML 요소와 캡처된 요소의 속성, start 및 end 태그를 반환합니다.
    표 15. GetOuterHTML 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 요소의 외부 HTML을 반환합니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    GetOuterText

    캡처된 요소의 텍스트 내용을 반환합니다.
    표 16. GetOuterText 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 캡처된 요소의 텍스트 내용을 반환합니다. 데이터 출력 문자열 기본값 없음 해당 사항 없음

    IsCreated (영문)

    캡처된 요소가 로드되었는지 여부에 대한 부울 상태를 반환합니다.
    표 17. IsCreated 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    반환 True이면 캡처된 요소가 로드된 것입니다. 그렇지 않으면 False이면 캡처된 요소를 로드하지 못한 것입니다. 데이터 출력 부울 기본값 없음 해당 사항 없음

    SetPassword (암호 설정)

    웹 기반 애플리케이션의 암호 필드에 안전하게 암호 입력을 자동화합니다(예: 로그인 양식의 암호 필드에 안전하게 암호 입력).

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.
    표 18. SetPassword 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    암호 암호를 보안 문자열로 수락합니다. 데이터 입력 보안 문자열 없음 암호를 보안 문자열로 허용하기 때문에 매개변수를 마우스 오른쪽 버튼으로 클릭한 다음 데이터 미리 보기를 클릭할 때만 문자열의 길이가 표시됩니다.
    UseSendKeys (영문) SendKeys는 문자, 숫자 및 기호와 같은 키보드 입력을 응용 프로그램 내의 텍스트 상자로 보내는 데 사용되는 메서드입니다. 데이터 입력 부울 거짓
    팁:
    SetPassword 메서드가 암호 필드에 암호를 입력하지 못하면 값을 True로 설정하고 메서드를 다시 실행합니다.

    SendKeys (영문)

    캡처된 요소에 바로 가기 키를 전달합니다.

    필드에 입력을 제공하려면 다음 문서를 참조하십시오 포트 속성 구성.
    표 19. SendKeys 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    바로 가기 키를 사용합니다. 데이터 입력 문자열 기본값 없음 아니요
    ClearExistingValue (기존 값 지우기) True이면 메서드는 필드의 기존 값을 지웁니다. 그렇지 않으면 False인 경우 기존 값을 지우지 않습니다. 데이터 입력 부울 기본값 없음 아니요
    TypeDelay (유형지연) 각 키 사이의 입력 지연을 설정합니다. 데이터 입력 두 번 기본값 없음 아니요

    GetInstanceCount (영문)

    요소를 사용할 수 있는 인스턴스 수를 반환합니다.

    GetOuterHTML

    캡처된 요소의 외부 HTML을 가져옵니다.

    SendKeys (영문)

    웹 페이지와 창에서 키 입력을 시뮬레이션합니다.
    입력
    ClearExistingValue (기존 값 지우기)
    TypeDelay (유형지연)

    SimulateMouseEvent (마우스 이벤트 시뮬레이션)

    웹 기반 응용 프로그램의 요소에 지정한 마우스 이벤트를 시뮬레이션합니다. 예를 들어, 요소에 대한 마우스 오른쪽 버튼 클릭을 시뮬레이션합니다.
    중요사항:
    요소에서 마우스 이벤트를 시뮬레이션하려면 웹 페이지 HTML에 정의된 특정 이벤트가 이미 있어야 합니다. 예를 들어, 요소에서 contextmenu 이벤트를 시뮬레이션하려면 요소에 HTML에 정의된 contextmenu 이벤트가 이미 있어야 합니다.
    필드에 입력을 제공하려면 다음을 참조하십시오. 포트 속성 구성
    표 20. SimulateMouseEvent 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수? 참고 사항
    마우스 이벤트(MouseEvent) 캡처된 웹 페이지 요소에서 발생하는 마우스 이벤트입니다. 웹 페이지 요소에서 mouse 이벤트가 발생할 때 해당 요소에는 이미 HTML에 정의된 mouse 이벤트가 있어야 합니다. 데이터 입력 MouseEventType (마우스 이벤트 유형) 클릭 이 메서드는 이러한 마우스 이벤트를 지원합니다.
    • 클릭
    • dblclick
    • mousedown
    • mouseup
    • mouseover
    • mousemove
    • mouseout
    • 컨텍스트메뉴
    MouseButton (마우스 버튼) 캡처된 웹 페이지 요소에서 마우스 버튼 클릭을 시뮬레이션합니다. 데이터 입력 MouseButtonType (영문) 왼쪽 이 메서드는 이러한 마우스 단추 동작을 지원합니다.
    • 왼쪽
    • 중간
    • 오른쪽

    이벤트 시뮬레이션

    Chrome 페이지 또는 페이지의 요소에 지정한 Google HTML 이벤트를 시뮬레이션합니다.

    필드에 입력을 제공하려면 다음을 참조하십시오. 포트 속성 구성
    표 21. SimulateEvent 메서드 매개 변수
    매개변수 설명 데이터 포트 유형 데이터 유형 기본값 필수?
    EventName HTML 이벤트의 이름입니다. 메서드는 제공된 이벤트를 지원하며 지정된 대로 정확하게 이벤트 이름을 입력해야 합니다.

    HTML 이벤트

    • 로드
    • 언로드
    • 중단
    • 오류
    • 선택
    • 변경
    • 제출
    • 재설정
    • 포커스
    • 흐리게
    • 크기 조정
    • 스크롤
    데이터 입력 문자열 없음