쿼리(Queries)는 페이지에서 요소를 찾기 위해 테스트 라이브러리(Test Library)가 제공하는 방법입니다.

여러 유형의 쿼리(get, find, query)가 있습니다. 이들 간의 차이점은 요소가 발견되지 않으면 쿼리에서 오류(Error)가 발생하는지 또는 Promise를 반환하고 다시 시도하는지 여부입니다.

선택하는 페이지 콘텐츠에 따라 다른 쿼리가 다소 적절할 수 있습니다.

Types of Queries

getBy…

쿼리에 대해 일치하는 노드를 반환하고, 일치하는 요소가 없거나 둘 이상의 일치가 발견되면 오류를 발생시킵니다.

(둘 이상의 요소가 예상되는 경우 대신 getAllBy… 사용)

queryBy…

쿼리에 대해 일치하는 노드를 반환 하고 일치하는 요소가 없으면 null을 반환합니다.

이것이 존재하지 않는 요소를 반환하는데 유용합니다.

둘 이상의 일치하는 요소가 발견되면 오류를 발생시킵니다.

(둘 이상의 요소가 예상되는 경우 대신 queryAllBy… 사용)

findBy…

주어진 쿼리와 일치하는 요소가 발견되면 Promise를 반환합니다. 요소가 발견되지않거나 기본 제한 시간이 1000ms 후에 둘 이상의 요소가 발견되면 오류를 발생시킵니다.

(둘 이상의 요소가 예상되는 경우 대신 findByAll… 사용)

getBy + waitFor = findBy

*waitFor: 일정 시간 동안 기다려야 할 때 waitFor를 사용하여 Promise의 응답을 받을 때까지 기다릴 수 있습니다.*