playwright-click
열려 있는 브라우저 세션에서 요소 하나를 클릭하고 그 결과 화면을 반환합니다.
만료된 ref, 다른 요소에 가려진 경우처럼 사이트가 거부하면 쿼리 실패가 아니라 error 필드로 반환되며 대신 시도할 방법을 알려줍니다. 내용을 읽고 다른 방법을 쓰세요. 같은 클릭은 같은 이유로 다시 거부됩니다.
클릭 후 화면은 이 행의 observation 필드에 새 ref 와 함께 담기므로 다음 동작을 위해 따로 관측할 필요가 없습니다.
읽기 전용 세션에서는 링크만 클릭할 수 있습니다. 읽을 화면에 도달하려면 링크 이동이 필요하기 때문입니다.
playwright-click session-id=값 ref=값 [screenshot=값]
- session-id=값
- 필수. 클릭할 브라우저 세션. 예: playwright-open 이 반환한 session_id
- ref=값
- 필수. 클릭할 요소를 직전 관측의 ref 로 지정합니다. ref 는 관측할 때마다 새로 부여되므로 가장 최근 관측의 값을 사용하세요. 예: e45
- screenshot=값
- 선택. 결과 화면의 스크린샷을 저장합니다. 미지정 시 t. 예: f
출력 필드
| 필드 | 타입 | 이름 | 설명 |
|---|---|---|---|
| session_id | 문자열 | 세션 식별자 | 예: 6f1c2a08-6c1e-4a1b-9a5e-9b2f0d3c7e11 |
| ref | 문자열 | 요소 ref | 예: e45 |
| target | 문자열 | 대상 요소 | 조작한 요소의 스냅샷 라인. 예: - button "저장" [ref=e45] |
| result | 문자열 | 결과 | 서버가 보고한 동작 결과. 예: Ran Playwright code |
| error | 문자열 | 오류 | 사이트가 동작을 거부한 경우 설정되며, 쿼리가 실패하는 대신 행으로 반환됩니다. 예: click blocked: another element covers this one |
| url | 문자열 | 동작 후 URL | 예: https://fw.example.com/policy/edit?id=12 |
| title | 문자열 | 동작 후 페이지 제목 | 예: 정책 편집 - 방화벽 콘솔 |
| element_count | 32비트 정수 | 요소 수 | 동작 후 도달한 화면에서 지목 가능한 요소 개수. 예: 108 |
| screenshot_guid | 문자열 | 스크린샷 파일 식별자 | 예: 3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| screenshot_url | 문자열 | 스크린샷 URL | 인라인으로 제공되므로 답변에  형태로 첨부할 수 있습니다. 예: /files/3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| sonar_url | 문자열 | 파일 스토어 URL | sonar-ai-ask-image 로 판독할 수 있습니다. 예: sonar://3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| observation | 문자열 | 관측 결과 | 동작 후 화면의 접근성 스냅샷이며 ref 가 새로 부여됩니다. 다시 관측하지 말고 여기의 ref 로 다음 동작을 하세요. 예: - button "저장" [ref=e45] |