로케이터

로케이터는 브라우저 페이지에서 조건에 맞는 요소를 찾고 조작·검증하는 Playwright 객체다. 저장된 DOM(Document Object Model, 브라우저가 문서를 객체 구조로 표현한 것) 요소 하나를 계속 들고 있는 대신 각 행동 시점의 페이지에서 대상을 다시 찾으며, 클릭할 때는 요소가 보이고 활성화되어 실제로 조작 가능한 상태인지 기다린다.

getByRole('button', { name: '저장' })과 getByLabel('이름')처럼 사용자가 인식하는 역할·이름·label을 우선하면 CSS 클래스나 중간 요소가 바뀌어도 같은 사용자 계약을 유지하는 테스트가 덜 깨진다.