Chromium 커넥터 방법

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 9분
  • Chromium 커넥터 메서드는 응용 프로그램, 화면 및 브라우저의 Google ChromeMicrosoft 에지 화면에 있는 요소에서 서로 다른 작업을 수행합니다.

    Chromium 커넥터 방법 수준

    애플리케이션 수준 메서드

    화면 수준 메서드

    요소 수준 메서드

    애플리케이션 수준 메서드

    이동

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

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

    WaitForAnyScreen

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

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

    화면 수준 메서드

    닫기

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

    초점

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

    GetFields

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

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

    GetInnerHtml

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

    GetPageSource

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

    스크린샷 받기

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

    제목 가져오기

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

    URL 가져오기

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

    GetValueByXPath

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

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

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

    IsCreated

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

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

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

    요소 수준 메서드

    클릭

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

    초점

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

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

    GetInnerHTML

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

    GetInnerText

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

    GetOuterHTML

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

    GetOuterText

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

    IsCreated

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

    암호 설정

    웹 기반 애플리케이션의 암호 필드에 안전하게 암호를 입력합니다. 예를 들어, 로그인 양식의 암호 필드에 안전하게 암호를 입력합니다.

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

    Send키

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

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

    GetInstanceCount

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

    GetOuterHTML

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

    Send키

    웹 페이지와 창에서 키 입력을 시뮬레이션합니다.
    입력
    ClearExistingValue
    TypeDelay

    SimulateMouseEvent

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

    시뮬레이션 이벤트

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

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

    HTML 이벤트

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