Jest 默认不提供 toBeTrue() 等扩展断言匹配器，该方法来自第三方库 jest-extended；需显式安装并配置 setupFilesAfterEnv 才能使用。
jest 默认不提供 `tobetrue()` 等扩展断言匹配器，该方法来自第三方库 `jest-extended`；需显式安装并配置 `setupfilesafterenv` 才能使用。
在 Jest 测试中，你可能会遇到如下错误：
TypeError: expect(...).toBeTrue is not a function
当你编写类似以下测试代码时：
it('should assert true', () => {
expect(true).toBeTrue();
});这是因为 toBeTrue() 并非 Jest 内置匹配器，而是由社区维护的增强库 jest-extended 提供的扩展断言之一。
✅ 正确使用 toBeTrue() 的步骤
1. 安装 jest-extended
npm install --save-dev jest-extended # 或使用 yarn yarn add --dev jest-extended
2. 配置 Jest 加载扩展匹配器
在 jest.config.js（或 package.json 中的 jest 字段）中，添加 setupFilesAfterEnv 配置项：
// jest.config.js
module.exports = {
setupFilesAfterEnv: ['jest-extended/all'],
// 其他配置...
};? jest-extended/all 会自动导入所有可用的扩展匹配器（如 toBeTrue(), toBeFalse(), toBeEmpty(), toIncludeSameMembers() 等）。你也可以按需导入单个匹配器（如 jest-extended/matchers/boolean），但通常推荐使用 all 以保持一致性。
3. 编写测试（现在可正常运行）
it('should assert true', () => {
expect(true).toBeTrue(); // ✅ 通过
expect(1).toBeTrue(); // ✅ 1 被视为 truthy，也会通过
expect('hello').toBeTrue(); // ✅ 非空字符串为 truthy
});
it('should assert false', () => {
expect(false).toBeFalse(); // ✅
expect(0).toBeFalse(); // ✅ 0 是 falsy
expect('').toBeFalse(); // ✅ 空字符串是 falsy
});⚠️ 注意：toBeTrue() 和 toBeFalse() 判断的是 JavaScript 的 truthy/falsy 值，而非严格等于 true 或 false。若需严格布尔值校验，请仍使用内置匹配器：
expect(value).toBe(true); // 仅当 value === true 时通过 expect(value).toBe(false); // 仅当 value === false 时通过
? 补充说明：为什么 Codacy 建议替换？
Codacy 等静态分析工具默认基于 Jest 核心 API 进行检查，未识别 jest-extended 的扩展匹配器，因此会误报 toBeTrue() 为“无效调用”，并建议降级为 toBe(true)。这并非错误，而是工具链未集成扩展库所致。正确配置 jest-extended 后，既可保留语义更清晰的断言，又能通过 CI/CD 检查（需确保 CI 环境也安装了依赖并加载了 setup 文件）。
✅ 总结
- toBeTrue() / toBeFalse() 属于 jest-extended，非 Jest 原生功能；
- 必须安装包 + 配置 setupFilesAfterEnv 才能启用；
- 它们基于 truthy/falsy 判断，与 toBe(true) 的严格相等语义不同，应按需选用；
- 在团队项目中，建议统一文档化此配置，避免新成员重复踩坑。
配置完成后，你的测试将语义更明确、可读性更强，同时完全兼容 Jest 生态。
