[Playwright] Locator의 메서드

Playwright에서는 Locator를 대상으로 다양한 메서드를 제공한다. 메서드를 통해 특정 액션을 수행할 수도 있고 대상이 가진 정보를 가져올 수도 있다.

 

아래는 자주 사용될법한 메서드에 대해서만 정리하였다. 추가적인 다양한 메서드를 제공해주니 공식문서를 참조하자.

 

🎈 액션(이벤트)

액션	설명
blur	포커스를 해제한다.
click	한번 클릭한다.
check/uncheck	체크는 토글이 아니다. 체크와 언체크가 따로 존재한다.
dblclick	해당 액션은 click 이벤트를 두번과 더블클릭 이벤트 한번을 발생시킨다.(두 이벤트는 모두 발생시킨다.) - 사용자에의한 더블클릭도 동일하게 작동하기 때문
dragTo	대상을 타겟이 되는 Locator의 위치로 드래그한다.
fill	텍스트 입력가능한 요소에 텍스트를 입력한다. input, textarea, [contenteditable] 를 대상으로 할 수 있다. 텍스트 입력시 대부분은 해당 메서드를 사용하자.
focus	대상에 포커싱한다.
hover	대상에게 마우스를 올린다.
press	단일 키보드 액션을 수행한다. fill 과는 다르다. 한번에 하나의 문자만 입력이 가능하다. 하지만 단축키와 같은 경우에는 입력이 가능하다.
selectOption	select의 옵션 중 하나 또는 다중으로 선택한다.

 

 

📯 Locator 필터

대상 Locator로부터 좀 더 구체적 대상을 찾기위한 메서드를 제공해준다. 대상의 자식, 자손 또는 대상에 대한 필터 추가 등으로 원하는 대상의 범위를 좁힐 수 있다.

locate	메서드 설명
getBy*	기본적인 locate 메서드.
all	다수의 대상 포함하는 경우 개별 Locator로 반환하도록 해준다.
filter	대상의 범위를 좁히기 위한 필터 기능을 제공한다. 텍스트 또는 자식 Locator 포함 여부로 찾는다.
first	다수의 대상 중 첫번째 대상을 반환한다.
last	다수의 대상 중 마지막 대상을 반환한다.
nth	다수의 대상의 경우 인덱스 번호로 대상을 탐색할때 사용한다.
and	두 가지 이상의 locate 메서드를 통해서 대상을 찾을 때 사용한다.
or	두 가지 경우 중 하나에 해당하는 대상을 찾을 때 사용한다.
locator	선택자 또는 다양한 방법으로 Locator를 찾는 기능을 제공한다.

 

 

🛒 정보

Locator가 가진 정보 또는 Locator가 참조하는 실제 요소의 정보를 얻을 수 있다.

메서드	설명
boundingBox	대상 요소의 bounding box를 반환한다. x, y, width, height
count	다수의 Locator를 선택된 경우 대상의 총 개수를 반환한다.
getAttribute	대상 요소의 속성 값을 반환한다.
innerHTML	대상 요소의 innerHTML 값을 반환한다.
innerText	대상 요소의 innerText 값을 반환한다.
textContent	대상 요소의 textContent 값을 반환한다.
inputValue	input, select, textarea의 값을 반환한다.
isChecked	대상 요소가 checked 상태인지를 반환한다.
isEnabled/isDisabled	대상 요소가 enabled / disabled 상태인지를 반환한다.
isEditable	대상 요소가 isEditable 상태인지를 반환한다.
isVisible/isHidden	대상 요소가 isVisible/isHidden 상태인지를 반환한다.

✨ 해당 정보가 테스트 검증의 대상이라면 메서드를 통해서 가져오지 않고 매처를 활용하는 것이 좋다!