Jest 中使用 toBeTrue() 匹配器的正确配置方法

Jest 原生不支持 toBeTrue() 匹配器，该功能由第三方扩展库 jest-extended 提供；需手动安装并配置 setupFilesAfterEnv 才能正常使用，否则会报错 “TypeError: expect(...).toBeTrue is not a function”。

jest 原生不支持 `tobetrue()` 匹配器，该功能由第三方扩展库 `jest-extended` 提供；需手动安装并配置 `setupfilesafterenv` 才能正常使用，否则会报错 “typeerror: expect(...).tobetrue is not a function”。

Jest 作为主流 JavaScript 测试框架，其内置匹配器（如 toBe(), toBeTruthy()）已覆盖大多数断言场景。但像 toBeTrue() 这样严格校验值是否精确等于 true（而非真值） 的语义化断言，并未被 Jest 官方纳入核心 API —— 它实际来自社区维护的增强库 jest-extended。

✅ 正确使用 toBeTrue() 的三步流程如下：

1. 安装依赖

   

   OneStory

   OneStory 是一款创新的AI故事生成助手，用AI快速生成连续性、一致性的角色和故事。

   下载

   npm install --save-dev jest-extended
   # 或
   yarn add --dev jest-extended

2. 配置 Jest
   在 jest.config.js（或 package.json 中的 jest 字段）中添加 setup 文件：

   // jest.config.js
   module.exports = {
     setupFilesAfterEnv: ['jest-extended/all'],
     // 其他配置...
   };

   ⚠️ 注意：必须使用 'jest-extended/all'（含路径），而非仅 'jest-extended'，否则匹配器不会自动注册。

3. 编写测试
   配置生效后，即可安全使用：

   it('should assert the value is strictly true', () => {
     expect(true).toBeTrue();      // ✅ 通过
     expect(1).not.toBeTrue();     // ✅ 通过（1 是 truthy，但 !== true）
     expect(false).toBeFalse();    // ✅ jest-extended 同时提供 toBeFalse()
   });

? 补充说明：

• expect(true).toBe(true) 功能等价，但可读性弱于 toBeTrue()；Codacy 的提示意在鼓励语义化断言，而非否定替代方案。
• 若项目已使用 TypeScript，建议额外安装类型声明：npm install --save-dev @types/jest-extended。
• 不推荐全局 patch expect（如在 setupFiles 中手动 extend），应优先采用官方推荐的 setupFilesAfterEnv + all preset 方式，确保匹配器加载时机正确、无副作用。

完成上述配置后，toBeTrue() 将成为你 Jest 断言工具箱中清晰、可靠且类型安全的一员。