配置Jest支持Node.js TypeScript：TS测试代码语法错误排查

Hey, I see exactly what's going on here—your Jest configuration is missing the critical setup to use ts-jest for transpiling TypeScript files. That's why Jest is throwing a syntax error when it hits the import statement in your test file. Let's get this sorted out step by step.

The Root Cause #

Jest doesn't natively understand TypeScript syntax (like import/export or TypeScript type annotations). While you've installed ts-jest (the tool that bridges Jest and TypeScript), you haven't told Jest to actually use it to transform your .ts test files.

Step 1: Update Your jest.config.js #

Modify your jest.config.js to include the transform option, along with a few other helpful settings for Node/Express projects:

module.exports = {
  roots: ['./tests'],
  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
  // Tell Jest to use ts-jest for all TypeScript files
  transform: {
    '^.+\\.tsx?$': 'ts-jest',
  },
  // Ensure Jest finds your .spec.ts test files
  testMatch: ['**/tests/**/*.spec.ts'],
  // Set the test environment to Node.js (since this is a backend app)
  testEnvironment: 'node',
  // Optional: Enable source maps for better error tracing
  moduleNameMapper: {
    '^src/(.*)$': '<rootDir>/src/$1',
  },
};

Key Config Explanations: #

• transform: This tells Jest to run any .ts or .tsx file through ts-jest, which transpiles TypeScript to JavaScript that Jest can execute.
• testMatch: Explicitly defines which files Jest should treat as tests—this avoids confusion if you have other .ts files in the tests directory.
• testEnvironment: Sets the runtime environment to Node.js, which is essential for testing Express/Node backend code (instead of the default browser-like jsdom environment).

Step 2: Verify Your tsconfig.json #

Make sure your tsconfig.json has settings that play nicely with ts-jest. Here's a recommended base config:

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "tests"]
}

The esModuleInterop: true setting is especially important—it fixes common issues when importing CommonJS modules (like Express) into TypeScript files.

Step 3: Test It Out #

Run your test command again:

npm run test

Jest should now properly transpile your TypeScript test files and execute them without syntax errors.

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