开源项目 `which-query` 使用教程

1. 项目介绍

which-query 是一个用于测试库的 Chrome 扩展，旨在帮助开发者在使用测试库时，根据最佳实践和指导原则来改进测试。该扩展提供了以下功能：

• 复制查询：从任何网页中复制查询。
• 元素检查面板：方便地检查页面元素。
• 查询控制台：在开发者工具控制台中直接使用查询。

2. 项目快速启动

安装

1. 打开 Chrome 浏览器，访问 Chrome Web Store。
2. 搜索 Testing Library: which query。
3. 点击“添加到 Chrome”按钮进行安装。

使用

安装完成后，打开开发者工具（按 F12 或右键选择“检查”），在“更多工具”中找到 Testing Library: which query 面板。

// 示例代码：在控制台中使用查询
const query = document.querySelector('.example-class');
console.log(query);

3. 应用案例和最佳实践

应用案例

假设你正在开发一个 React 应用，并使用 @testing-library/react 进行测试。你可以使用 which-query 扩展来快速找到合适的查询方法。

// 使用 getByText 查询
const { getByText } = render(<MyComponent />);
const element = getByText('Hello, World!');
expect(element).toBeInTheDocument();

最佳实践

• 优先使用可访问性查询：如 getByRole、getByLabelText 等，这些查询更符合用户实际使用场景。
• 避免使用 querySelector：虽然 querySelector 功能强大，但在测试中应尽量避免，以保持测试的可维护性。

4. 典型生态项目

• @testing-library/react：用于 React 组件的测试库。
• @testing-library/dom：用于 DOM 元素的测试库。
• @testing-library/jest-dom：提供了一系列 Jest 匹配器，方便 DOM 元素的断言。

通过这些生态项目，你可以构建一个完整的测试环境，确保应用的稳定性和可维护性。