ARIA 스냅샷과 테스트 제어 기능 확장
tracing에서 HAR 기록을 다루고, 드롭 시뮬레이션·ARIA 스냅샷·테스트 중단 API가 추가됐다.
교안에 영향
기존 문서에서 Locator.ariaRef(), exposeBinding의 handle 옵션, connect 계열의 logger 옵션, videosPath / videoSize 안내는 더 이상 맞지 않는다.
요약
- tracing.startHar() / tracing.stopHar()로 HAR 기록을 tracing API에서 직접 시작하고 끝낼 수 있게 됐다. - locator.drop()으로 파일이나 클립보드형 데이터를 요소에 드롭하는 동작을 시뮬레이션할 수 있게 됐다. - expect(page).toMatchAriaSnapshot()이 Page에서도 동작하고, locator.ariaSnapshot() / page.ariaSnapshot()에 boxes 옵션이 추가됐다. - test.abort()와 여러 새 API, 보고서·트레이스 뷰어 개선이 추가됐고, 일부 오래된 API는 제거됐다.
바뀐 것
새 기능
- tracing.startHar() / tracing.stopHar()가 HAR 기록을 tracing의 1급 API로 제공하며 content, mode, urlFilter 옵션과 Disposable 반환을 지원한다.
- locator.drop()이 파일이나 클립보드형 데이터를 요소에 드롭하는 동작을 시뮬레이션한다.
- expect(page).toMatchAriaSnapshot()이 Page에서도 동작하며, locator.ariaSnapshot() / page.ariaSnapshot()에 boxes 옵션이 추가됐다.
- test.abort()가 fixture, hook, route handler에서 현재 실행 중인 테스트를 중단할 수 있게 한다.
- browser.on('context') 이벤트와 BrowserContext의 페이지 생명주기 이벤트 미러링이 추가됐다.
- page.getByRole() / locator.getByRole() / frame.getByRole() / frameLocator.getByRole()에 description 옵션이 추가됐다.
- expect(locator).toHaveCSS()에 pseudo 옵션이 추가되어 ::before 또는 ::after의 계산된 스타일을 읽을 수 있다.
- locator.highlight()에 style 옵션이 추가되고, page.hideHighlight()로 모든 하이라이트를 지울 수 있게 됐다.
- webSocketRoute.protocols()가 페이지가 요청한 WebSocket subprotocols를 반환한다.
- browserType.connectOverCDP()에 noDefaults 옵션이 추가됐다.
- webError.location()과 reporter.onError()의 workerInfo 인자, testInfoError.errorContext가 추가됐다.
- testProject.snapshotPathTemplate에 {testFileBaseName} 토큰이 추가됐다.
개선
- HTML reporter가 .zip 파일을 직접 열 수 있고, 중첩 첨부물이 있는 단계 표시와 repeatEachIndex 표시를 개선했다.
- Trace Viewer에 네트워크 상세 패널의 JSON / form 본문 pretty-print 토글이 추가됐다.
기타
- 존재했던 오래된 API인 Locator.ariaRef(), BrowserContext.exposeBinding과 Page.exposeBinding의 handle 옵션, BrowserType.connect와 BrowserType.connectOverCDP의 logger 옵션, Context 옵션 videosPath / videoSize가 제거됐다.
수정
- test runner가 비옵션 fixture를 덮어쓰는 설정과 workers: 0 또는 음수 값을 더 이상 허용하지 않는다.