できない.dev

Jest で TypeScript が「SyntaxError: Unexpected token」で実行できない

SyntaxError: Unexpected token は、ts-jest か @babel/preset-typescript で .ts を変換させれば直る。
Jest 自体は TypeScript を理解しないためだ。

公開: 更新:

症状できない · exit 1
npx jest --noStackTrace
…
FAIL ./sum.test.ts
  ● Test suite failed to run
    SyntaxError: /tmp/tmp.C5oGmQFWJ3/sum.test.ts: Unexpected token, expected "," (1:14)
解決後できた · exit 0
npx jest
…
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        0.278 s
Ran all test suites.

2026-10-11 に node:20(Jest 29.7.0 / Node.js 20.20.2) で実際に打って取った出力。検証環境の詳細

要約

Jest 自体は TypeScript を解釈しない。

ts-jest か Babel(@babel/preset-typescript)で、テスト実行時に .ts / .tsx を JavaScript へ変換する設定が必要になる。

その設定が無いと、型注釈や import 文の位置で「SyntaxError: Unexpected token」が出る。
型検査つきで動かすなら ts-jest、速度優先なら Babel が定番。

実行例

トランスフォーマを設定していない Jest 29.7.0 に .ts のテストを流すと、型注釈の位置で SyntaxError: Unexpected token, expected "," となり、終了コードは 1 だった。
ts-jest の config:init で作った設定でも、babel-jest と @babel/preset-typescript の組み合わせでも、同じテストが通って終了コードは 0 になっている。

$ npx jest --noStackTrace
FAIL ./sum.test.ts
  ● Test suite failed to run
 
    SyntaxError: /tmp/tmp.C5oGmQFWJ3/sum.test.ts: Unexpected token, expected "," (1:14)
 
    > 1 | const sum = (a: number, b: number): number => a + b;
        |               ^
      2 |
      3 | test("sum", () => {
      4 |   expect(sum(1, 2)).toBe(3);
 
Test Suites: 1 failed, 1 total
Tests:       0 total
Snapshots:   0 total
Time:        0.261 s
Ran all test suites.
$ echo $?
1
$ npm install -D ts-jest@29 @types/jest@29 typescript@5
added 13 packages in 1s
$ npx ts-jest config:init
Jest configuration written to "/tmp/tmp.C5oGmQFWJ3/jest.config.js".
$ cat jest.config.js
const { createDefaultPreset } = require("ts-jest");
 
const tsJestTransformCfg = createDefaultPreset().transform;
 
/** @type {import("jest").Config} **/
module.exports = {
  testEnvironment: "node",
  transform: {
    ...tsJestTransformCfg,
  },
};
$ npx jest
PASS ./sum.test.ts
  ✓ sum (1 ms)
 
Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        0.654 s
Ran all test suites.
$ echo $?
0
$ npm install -D babel-jest@29 @babel/preset-env @babel/preset-typescript
added 89 packages in 2s
$ cat babel.config.js
module.exports = {
  presets: [
    ['@babel/preset-env', { targets: { node: 'current' } }],
    '@babel/preset-typescript',
  ],
};
$ npx jest
PASS ./sum.test.ts
  ✓ sum (1 ms)
 
Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Snapshots:   0 total
Time:        0.278 s
Ran all test suites.
$ echo $?
0

— 2026-10-11 時点の出力

検証環境Node.js 20.20.2 / npm 10.8.2 / Python 3.11.2 / 2026-10-11 検証(ほか 2 件)
検証日
実行環境
node:20 Debian GNU/Linux 12 (bookworm)
バージョン
  • Node.js 20.20.2
  • npm 10.8.2
  • Python 3.11.2
  • Git 2.39.5
  • Jest 29.7.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. ts-jest を使う(型もチェックする)

npm i -D ts-jest @types/jest
npx ts-jest config:init
// jest.config.js
module.exports = {
  preset: 'ts-jest',
  testEnvironment: 'node',
};

2. Babel を使う(高速・型検査なし)

npm i -D babel-jest @babel/preset-env @babel/preset-typescript
// babel.config.js
module.exports = {
  presets: [
    ['@babel/preset-env', { targets: { node: 'current' } }],
    '@babel/preset-typescript',
  ],
};

Babel は型注釈を落とすだけで型検査はしない。
型の担保は次のように別コマンドで行う。

npx tsc --noEmit

設定の詳細は Jest 公式の Getting Started(新しいタブで開く) の「Using TypeScript」を参照する。

よくある原因

  1. トランスフォーマ未設定: preset: 'ts-jest' も Babel の TypeScript preset も無い。
  2. Babel に TypeScript preset が無い: @babel/preset-typescript を入れていない。
  3. tsconfig の不整合: ts-jest が参照する tsconfig の jsx や esModuleInterop が実際のコードと合っていない。