Jest 原生不支持 toBeTrue() 等扩展布尔匹配器，该功能由第三方库 jest-extended 提供；需单独安装并配置 setupFilesAfterEnv 才能使用。
jest 原生不支持 `tobetrue()` 等扩展布尔匹配器，该功能由第三方库 `jest-extended` 提供；需单独安装并配置 `setupfilesafterenv` 才能使用。
在 Jest 测试中，开发者常期望使用语义更清晰的断言方法，例如 expect(value).toBeTrue() 来明确表达“验证值为真值”的意图。但直接调用时却报错：
TypeError: expect(...).toBeTrue is not a function
这是因为 toBeTrue() 并非 Jest 官方内置匹配器，而是由社区维护的增强库 jest-extended 提供的功能。
✅ 正确使用步骤
-
安装依赖
npm install --save-dev jest-extended # 或使用 yarn yarn add --dev jest-extended
-
配置 Jest（推荐方式）
在 jest.config.js（或 package.json 的 jest 字段）中添加 setup 文件：// jest.config.js module.exports = { setupFilesAfterEnv: ['jest-extended/all'], // 其他配置... };⚠️ 注意：必须使用 setupFilesAfterEnv（而非 setupFiles），确保在 Jest 环境初始化后、测试运行前加载扩展匹配器。
-
编写测试（现在可安全使用）
it('should assert true', () => { expect(true).toBeTrue(); // ✅ 通过 expect(1).toBeTrue(); // ✅ 通过（1 是真值） expect('hello').toBeTrue(); // ✅ 通过 expect(0).not.toBeTrue(); // ✅ 通过 expect(null).not.toBeTrue(); // ✅ 通过 });
? 补充说明
- toBeTrue() 判断的是 JavaScript 真值（truthy），等价于 !!value === true，而非严格等于 true。若需严格比对布尔 true，仍应使用原生 toBe(true)。
- jest-extended 还提供 toBeFalse()、toBeEmpty()、toIncludeSameMembers() 等数十个实用匹配器，显著提升断言可读性。
- Codacy 等工具提示替换为 toBe(true)，是因其默认只识别 Jest 原生 API；启用 jest-extended 后，该警告可忽略或通过规则配置禁用。
✅ 最佳实践建议
- 在团队项目中，将 jest-extended 作为标准测试基础设施的一部分，并在文档中注明配置方式；
- 避免混用 toBeTrue() 与 toBe(true)，应在代码规范中明确定义语义差异：前者用于真值校验，后者专用于 === true 断言；
- 升级 Jest 或 jest-extended 时，关注其 兼容性矩阵，确保版本匹配。
配置完成后，toBeTrue() 将无缝集成至所有 expect() 调用中——简洁、语义明确，且完全类型安全（配合 TypeScript + @types/jest-extended）。
