브라우저 기본 액션

기본 액션은 agent-browser의 명령 이름을 그대로 사용합니다. 작업은 이 명령들을 현재 화면의 대상과 입력값에 적용하는 시퀀스입니다. 필터 설정이나 메시지 미리보기도 아래 명령의 조합으로 설명합니다.

화면을 읽고 조작하기

1. open으로 대상 화면을 엽니다.
2. snapshot -i로 현재 조작 가능한 요소를 읽습니다.
3. 역할, 이름과 주변 기록을 대조한 뒤 해당 ref로 조작합니다.
4. 화면이 바뀌면 snapshot을 다시 읽습니다. 결과는 get 또는 is로 읽고 예상값과 대조합니다.

페이지 이동이나 요소 교체 후에는 이전 ref를 재사용하지 않습니다. 같은 DOM 요소가 남아 있으면 ref가 유지될 수 있지만 문서에 고정값으로 저장하지 않습니다. 본문을 확인할 때는 전체 snapshot, 시각 맥락이 필요하면 screenshot --annotate를 사용하세요.

전체 기능과 준비사항의 시퀀스에서 실행할 작업을 고르세요.

기본 명령

• open: 페이지 열기
• snapshot: 화면과 ref 읽기
• click: 클릭하기
• fill: 입력값 바꾸기
• press: 키 누르기
• select: 기본 선택 목록의 값 고르기
• check: 체크하기
• uncheck: 체크 해제하기
• wait: 조건 기다리기
• get: 화면 값 읽기
• is: 요소 상태 읽기
• reload: 페이지 새로 읽기
• upload: 파일 입력하기
• screenshot: 화면 캡처하기
• record: 화면 녹화하기

대상 선택과 검증

스크립트에서 접근성 이름이 유일할 때는 find role button click --name "이름" --exact 같은 semantic locator도 사용할 수 있습니다. 현재 화면을 해석하는 에이전트는 snapshot의 ref를 우선 사용합니다. CSS와 위치 번호는 화면에서 확인한 경우에만 사용합니다.

검색형 combobox는 select로 가정하지 않습니다. 입력을 클릭하고 필요한 키를 누른 뒤 새 snapshot의 option을 클릭합니다. 체크박스는 check와 uncheck로 원하는 상태를 지정합니다.

get과 is는 값을 반환합니다. 값의 의미와 성공 여부는 시퀀스에 적힌 예상값으로 판단합니다. 실제 수신과 결제 결과는 해당 요청 ID로 확인해야 합니다.

테스트와 녹화

테스트는 입력과 예상값을 정한 뒤 같은 시퀀스를 수행합니다. 조작 이후의 관측값을 assertion으로 검사하고 실패한 단계에서 멈춥니다. 녹화는 그 실행 앞뒤에 record start와 record stop을 붙입니다. 영상이 존재한다는 사실만으로 성공을 판단하지 않습니다.

외부 심사, 전화기와 결제 단말에서 할 일은 시퀀스의 해당 위치에 담당자와 결과를 적습니다. 브라우저 명령으로 가장하지 않습니다. 일반 UI 조작에는 별도의 plugin이나 업무 명령을 만들지 않습니다.

공식 문서: Selectors, Snapshots, Commands, Recording.