road: Testing Library에서 Queries 구분하기

roads/2024/01/15.mdx

@@ -0,0 +1,36 @@
+---
+title: 'Testing Library에서 Queries 구분하기'
+date: '2024-01-15'
+slug: '2024-01-15'
+type: 'road'
+---
+
+<Image
+  src="https://raw.githubusercontent.com/jgjgill/blog/main/roads/images/testing-library-queries.png"
+  alt="Testing Library Queries"
+/>
+
+### getBy...
+
+- **쿼리에 대해 일치하는 노드를 반환**한다.
+- 일치하는 요소가 없거나 일치하는 요소가 두 개 이상이면 오류를 발생시킨다.
+- 복수의 경우 `getAllBy`을 사용한다.
+
+### queryBy...
+
+- 쿼리에 대해 일치하는 노드를 반환한다.
+- 일치하는 요소가 없으면 `null`을 반환한다. **존재하지 않는 요소를 판별할 때 유용**하다.
+- 일치하는 요소가 두 개 이상이면 오류를 발생시킨다.
+- 복수의 경우 `queryAllBy`을 사용하고 일치하는 요소가 없는 경우 `[]`를 반환한다.
+
+### findBy...
+
+- 주어진 쿼리와 일치하는 요소가 발견될 때까지 이행되는 **`Promise`를 반환**한다.
+- 일치하는 요소가 없거나 기본 시간 초과 (1000ms) 이후에 일치하는 요소가 두 개 이상이면 `Promise`가 거부된다.
+- 복수의 경우 `findAllBy`를 사용한다.
+
+## 참고 문서
+
+- [Queries](https://testing-library.com/docs/dom-testing-library/cheatsheet/#queries)
+- [Types of Queries](https://testing-library.com/docs/queries/about/#types-of-queries)
+- [Async Methods](https://testing-library.com/docs/dom-testing-library/api-async/)