열려 있는 브라우저 세션의 현재 화면을 읽어 접근성 스냅샷을 반환합니다. 스냅샷의 각 요소에는 e40 과 같은 ref 가 붙어 있으며, 이 ref 를 조작 커맨드에 넘깁니다. ref 는 화면을 읽을 때마다 새로 부여되므로 이전 관측의 ref 를 재사용하지 마세요.

조작 후에는 이 커맨드가 필요하지 않습니다. 조작 커맨드와 playwright-resize, playwright-open 은 각자 조작 직후의 화면을 observation 필드로 함께 반환하므로, 직전 커맨드가 돌려준 행의 ref 로 바로 다음 조작을 하면 됩니다. 이 커맨드는 아무 조작 없이 화면을 다시 볼 때 — 잠시 기다린 뒤나 직전 행의 스냅샷이 부족했을 때 — 사용합니다.

처음 보는 화면은 depth=3 부터 시작해 바깥에서 안으로 읽습니다. 화면의 최상위 컨테이너와 그 ref 만 나오므로, 그중 하나의 ref 를 target 으로 지정해 그 안을 읽고 여전히 크면 depth 로 다시 좁힙니다. 트리 전체를 요청하면 콘솔 화면은 행 길이 제한에 걸려 잘린 채 도착하고, 아직 보지 못한 부분이 잘려 나갑니다.

찾을 대상이 정해졌으면 text 나 regex 로 트리의 해당 부분만 받는 편이 더 저렴합니다. 어느 방식으로 좁히든 line_count 를 보면 실제로 받은 양보다 많이 담겼는지 알 수 있습니다.

session-id=값

필수. 관측할 브라우저 세션. 예: playwright-open 이 반환한 session_id

text=값

선택. 이 문자열을 포함한 부분만 반환합니다. 대소문자를 구분하지 않는 부분 일치이며 regex 와 함께 쓸 수 없습니다. 예: 차단 정책

regex=값

선택. 이 정규식에 일치하는 부분만 반환합니다. 슬래시로 감싸 플래그를 주지 않으면 대소문자를 구분하며 text 와 함께 쓸 수 없습니다. 예: /save|submit/i

depth=값

선택. 트리를 이 깊이까지만 포함합니다. 1 에서 30 사이이며, 화면의 큰 구조와 안으로 들어갈 컨테이너를 파악할 때 사용합니다. 예: 3 - 처음 읽는 화면의 시작 깊이

target=값

선택. 이 요소와 그 내부만 읽습니다. 앞선 관측에서 얻은 ref 로 지정합니다. 예: e18

after=값

선택. 트리 처음이 아니라 이 요소 다음부터 반환하므로, 잘려서 도착한 관측을 이어서 읽을 수 있습니다. 직전 행의 next_after 값을 그대로 넘기세요. 예: e120

limit=값

선택. 스냅샷을 이 줄 수까지만 반환합니다. 1 에서 5000 사이이며, after 와 함께 쓰면 큰 화면을 나눠 읽을 수 있습니다. 예: 200

출력 필드