Jest encountered an unexpected token に向き合う

# はじめに

JISOU で Vite + Rreact の環境に Jest でテストを書こう！という課題がありました。設定は難しいため、設定ファイルは課題の中に記載がありました。物好きなわたしは Jest の本家サイトからインストール手順を追いかけてみて、見事にエラーに出くわしたのでそれを記事にしました。

:warning: react testing library は未インストールです。

# エラー

## 抜粋

```
Jest encountered an unexpected token

Jest failed to parse a file. This happens e.g. when your code or its dependencies use non-standard JavaScript syntax, or when Jest is not configured to support such syntax.

（略）

If you are trying to use TypeScript, see https://jestjs.io/docs/getting-started#using-typescript

（略）
   
/Users/akira/Project/private/vite-ts/__test__/sum.test.ts:1
  ({"Object.<anonymous>":function(module,exports,require,__dirname,__filename,jest){import sum from './sum';
                                                                                    ^^^^^^

```

<details><summary>本文</summary>

```
  FAIL  __test__/sum.test.ts
  ● Test suite failed to run

    Jest encountered an unexpected token

    Jest failed to parse a file. This happens e.g. when your code or its dependencies use non-standard JavaScript syntax, or when Jest is not configured to support such syntax.

    Out of the box Jest supports Babel, which will be used to transform your files into valid JS based on your Babel configuration.

    By default "node_modules" folder is ignored by transformers.

    Here's what you can do:
     • If you are trying to use ECMAScript Modules, see https://jestjs.io/docs/ecmascript-modules for how to enable it.
     • If you are trying to use TypeScript, see https://jestjs.io/docs/getting-started#using-typescript
     • To have some of your "node_modules" files transformed, you can specify a custom "transformIgnorePatterns" in your config.
     • If you need a custom transformation specify a "transform" option in your config.
     • If you simply want to mock your non-JS modules (e.g. binary assets) you can stub them out with the "moduleNameMapper" config option.

    You'll find more details and examples of these config options in the docs:
    https://jestjs.io/docs/configuration
    For information about custom transformations, see:
    https://jestjs.io/docs/code-transformation

    Details:

    /Users/akira/Project/private/vite-ts/__test__/sum.test.ts:1
    ({"Object.<anonymous>":function(module,exports,require,__dirname,__filename,jest){import sum from './sum';
                                                                                      ^^^^^^

    SyntaxError: Cannot use import statement outside a module

      at Runtime.createScriptFromCode (node_modules/jest-runtime/build/index.js:1505:14)

Test Suites: 1 failed, 1 total
Tests:       0 total
Snapshots:   0 total
Time:        0.146 s
```

</details>

Jest で理解できない文法があり、そのためエラーになったようです。本家サイトでも

> Jest はプロジェクト内のコードを JavaScript として実行しますが、Node でサポートされていない構文 (JSX、TypeScript、Vue のテンプレート) を使用している場合は、ブラウザ用にビルドする場合と同様に、コードをプレーンな JavaScript に変換する必要があります。


[掲載ページ](https://jestjs.io/ja/docs/code-transformation#:~:text=Jest%20%E3%81%AF%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E5%86%85%E3%81%AE%E3%82%B3%E3%83%BC%E3%83%89%E3%82%92%20JavaScript%20%E3%81%A8%E3%81%97%E3%81%A6%E5%AE%9F%E8%A1%8C%E3%81%97%E3%81%BE%E3%81%99%E3%81%8C%E3%80%81Node%20%E3%81%A7%E3%82%B5%E3%83%9D%E3%83%BC%E3%83%88%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E6%A7%8B%E6%96%87%20(JSX%E3%80%81TypeScript%E3%80%81Vue%20%E3%81%AE%E3%83%86%E3%83%B3%E3%83%97%E3%83%AC%E3%83%BC%E3%83%88)%20%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%AF%E3%80%81%E3%83%96%E3%83%A9%E3%82%A6%E3%82%B6%E7%94%A8%E3%81%AB%E3%83%93%E3%83%AB%E3%83%89%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%A8%E5%90%8C%E6%A7%98%E3%81%AB%E3%80%81%E3%82%B3%E3%83%BC%E3%83%89%E3%82%92%E3%83%97%E3%83%AC%E3%83%BC%E3%83%B3%E3%81%AA%20JavaScript%20%E3%81%AB%E5%A4%89%E6%8F%9B%E3%81%99%E3%82%8B%E5%BF%85%E8%A6%81%E3%81%8C%E3%81%82%E3%82%8A%E3%81%BE%E3%81%99%E3%80%82)

と説明があり TypeScript を使う場合には工夫が必要です。取り組んだことはパッケージのインストールと設定ファイルの追加です。

# 取り組み

先程のエラー本文には

> If you are trying to use TypeScript, see https://jestjs.io/docs/getting-started#using-typescript

とあり TypeScript での対応が書いてあります。

```
npm install --save-dev ts-jest
```

:::note warn
`@babel/preset-typescript` はインストールしません。
型チェックが行われません。
:::

設定ファイルも必要になります。こちらを実行すると

```
npx ts-jest config:init
```

`jest.config.js` を生成してくれました。

```javascript
/** @type {import('ts-jest').JestConfigWithTsJest} **/
export default {
  testEnvironment: "node",
  transform: {
    "^.+.tsx?$": ["ts-jest",{}],
  },
};
```

:::note warn
jest.config.js がない場合 Jest は文法を理解できず冒頭のエラーになります。
:::

transform がキモで tsx ファイルを ts-jest を使ってトランスパイルしてくれます。

# 気づき

Javascript で Jest を使うときは `describe` / `expect` などテストに必要なものはグローバルで使えていますが、TypeScript では使えません。TypeScript でも `descripbe` / `expect` を使うには `@types/jest` が必要です。

```
npm install --save-dev @types/jest
```

# JISOUのメンバー募集中！
プログラミングコーチングJISOUでは、新たなメンバーを募集しています。
日本一のアウトプットコミュニティでキャリアアップしませんか？
興味のある方は、ぜひホームページをのぞいてみてくださ！
▼▼▼

https://projisou.jp