在TypeScript（ts-jest）中结合Jest使用Chai遇阻，求技术指导

嘿，我之前在Jest+TypeScript项目里切换到Chai expect的时候也踩过坑，下面是一套经过验证的配置流程，能帮你顺利搞定，还能保证编辑器的自动补全和类型检查完全正常：

1. 安装必要依赖 #

首先把Chai和它的类型定义包装到开发依赖里：

npm install chai @types/chai --save-dev

如果想要让Chai的断言和Jest的测试钩子（比如beforeEach、describe）更好兼容，也可以装个jest-chai（可选，但能省不少事）：

npm install jest-chai --save-dev

2. 配置Jest来启用Chai #

打开你的Jest配置文件（jest.config.js或者jest.config.ts），添加或修改以下配置项：

module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node', // 或者你的项目对应的环境，比如jsdom
  setupFilesAfterEnv: [
    './jest.setup.js' // 这里指向我们的初始化脚本
  ],
  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
  transform: {
    '^.+\\.(ts|tsx)$': 'ts-jest'
  }
};

然后在项目根目录创建jest.setup.js文件，用来全局挂载Chai的expect（或者你也可以在每个测试文件里手动导入，全局挂载更方便）：

// jest.setup.js
const chai = require('chai');
global.expect = chai.expect;

// 如果装了jest-chai，也可以加上这行，让Chai和Jest的API更融合
require('jest-chai');

3. 配置TypeScript确保类型支持 #

打开tsconfig.json，在compilerOptions里的types数组中加入chai（如果用了jest-chai也要加上），这样TypeScript就能识别Chai的类型定义了：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "types": ["jest", "chai", "jest-chai"] // 这里要包含chai
  },
  "include": ["src/**/*", "__tests__/**/*"],
  "exclude": ["node_modules"]
}

4. 测试使用示例 #

现在你就可以在TypeScript测试文件里正常使用Chai的expect了，而且会有完整的自动补全和类型检查：

// __tests__/example.test.ts
describe('Chai expect test', () => {
  it('should work with Chai assertions', () => {
    const num = 10;
    expect(num).to.be.a('number');
    expect(num).to.equal(10);
    expect(num).to.be.greaterThan(5);
    // 这里编辑器会自动补全Chai的所有断言方法，而且不会有类型错误
  });
});

5. 解决可能的冲突问题 #

如果遇到Jest自带的expect和Chai的expect类型冲突，可以在tsconfig.json里把Jest的expect类型排除，或者在测试文件里明确导入Chai的expect：

// 手动导入，避免全局冲突
import { expect } from 'chai';

it('should work without global', () => {
  expect('hello').to.include('ell');
});

内容的提问来源于stack exchange，提问作者Victor