Next.jsでJestをセットアップする
JestとReact Testing Libraryは、ユニットテストとスナップショットテストによく一緒に使用されます。このガイドでは、Next.jsでJestをセットアップし、最初のテストを記述する方法を紹介します。
補足:
async
Server ComponentsはReactエコシステムに新しいため、Jestは現在それらをサポートしていません。同期ServerおよびClient Componentsのユニットテストは引き続き実行できますが、async
コンポーネントにはE2Eテストの使用をお勧めします。
クイックスタート
create-next-app
をNext.jsのwith-jestの例と一緒に使用することで、素早く開始できます
npx create-next-app@latest --example with-jest with-jest-app
手動セットアップ
Next.js 12のリリース以降、Next.jsにはJest用の組み込み設定があります。
Jestをセットアップするには、jest
と以下のパッケージを開発依存関係としてインストールします
npm install -D jest jest-environment-jsdom @testing-library/react @testing-library/dom @testing-library/jest-dom ts-node
# or
yarn add -D jest jest-environment-jsdom @testing-library/react @testing-library/dom @testing-library/jest-dom ts-node
# or
pnpm install -D jest jest-environment-jsdom @testing-library/react @testing-library/dom @testing-library/jest-dom ts-node
以下のコマンドを実行して、基本的なJest設定ファイルを生成します
npm init jest@latest
# or
yarn create jest@latest
# or
pnpm create jest@latest
これにより、jest.config.ts|js
ファイルの自動作成を含め、プロジェクトのJest設定を行うための一連のプロンプトが表示されます。
設定ファイルをnext/jest
を使用するように更新します。このトランスフォーマーには、JestがNext.jsで動作するために必要なすべての設定オプションが含まれています
import type { Config } from 'jest'
import nextJest from 'next/jest.js'
const createJestConfig = nextJest({
// Provide the path to your Next.js app to load next.config.js and .env files in your test environment
dir: './',
})
// Add any custom config to be passed to Jest
const config: Config = {
coverageProvider: 'v8',
testEnvironment: 'jsdom',
// Add more setup options before each test is run
// setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
}
// createJestConfig is exported this way to ensure that next/jest can load the Next.js config which is async
export default createJestConfig(config)
内部では、next/jest
が自動的にJestを設定しています。これには以下が含まれます
- Next.jsコンパイラを使用して
transform
を設定する。 - スタイルシート(
.css
、.module.css
、およびそのscssバリアント)、画像インポート、next/font
を自動的にモックする。 .env
(およびすべてのバリアント)をprocess.env
にロードする。- テストの解決と変換から
node_modules
を無視する。 - テストの解決から
.next
を無視する。 - SWC変換を有効にするフラグのために
next.config.js
をロードする。
補足: 環境変数を直接テストするには、個別のセットアップスクリプトまたは
jest.config.ts
ファイルで手動でロードしてください。詳細については、テスト環境変数を参照してください。
Jestのセットアップ (Babel使用)
Next.jsコンパイラの使用を中止し、代わりにBabelを使用する場合、Jestを手動で設定し、上記のパッケージに加えてbabel-jest
とidentity-obj-proxy
をインストールする必要があります。
Next.jsでJestを設定するための推奨オプションは以下の通りです
module.exports = {
collectCoverage: true,
// on node 14.x coverage provider v8 offers good speed and more or less good report
coverageProvider: 'v8',
collectCoverageFrom: [
'**/*.{js,jsx,ts,tsx}',
'!**/*.d.ts',
'!**/node_modules/**',
'!<rootDir>/out/**',
'!<rootDir>/.next/**',
'!<rootDir>/*.config.js',
'!<rootDir>/coverage/**',
],
moduleNameMapper: {
// Handle CSS imports (with CSS modules)
// https://jest.dokyumento.jp/docs/webpack#mocking-css-modules
'^.+\\.module\\.(css|sass|scss)$': 'identity-obj-proxy',
// Handle CSS imports (without CSS modules)
'^.+\\.(css|sass|scss)$': '<rootDir>/__mocks__/styleMock.js',
// Handle image imports
// https://jest.dokyumento.jp/docs/webpack#handling-static-assets
'^.+\\.(png|jpg|jpeg|gif|webp|avif|ico|bmp|svg)$': `<rootDir>/__mocks__/fileMock.js`,
// Handle module aliases
'^@/components/(.*)$': '<rootDir>/components/$1',
// Handle @next/font
'@next/font/(.*)': `<rootDir>/__mocks__/nextFontMock.js`,
// Handle next/font
'next/font/(.*)': `<rootDir>/__mocks__/nextFontMock.js`,
// Disable server-only
'server-only': `<rootDir>/__mocks__/empty.js`,
},
// Add more setup options before each test is run
// setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
testPathIgnorePatterns: ['<rootDir>/node_modules/', '<rootDir>/.next/'],
testEnvironment: 'jsdom',
transform: {
// Use babel-jest to transpile tests with the next/babel preset
// https://jest.dokyumento.jp/docs/configuration#transform-objectstring-pathtotransformer--pathtotransformer-object
'^.+\\.(js|jsx|ts|tsx)$': ['babel-jest', { presets: ['next/babel'] }],
},
transformIgnorePatterns: [
'/node_modules/',
'^.+\\.module\\.(css|sass|scss)$',
],
}
各設定オプションの詳細については、Jestドキュメントで確認できます。また、Next.jsがJestをどのように設定しているかを確認するために、next/jest
設定をレビューすることもお勧めします。
スタイルシートと画像のインポートの処理
スタイルシートと画像はテストでは使用されませんが、それらをインポートするとエラーが発生する可能性があるため、モックする必要があります。
上記の設定で参照されているモックファイル - fileMock.js
とstyleMock.js
- を__mocks__
ディレクトリ内に作成します
module.exports = 'test-file-stub'
module.exports = {}
静的アセットの処理に関する詳細については、Jestドキュメントを参照してください。
フォントの処理
フォントを処理するには、__mocks__
ディレクトリ内にnextFontMock.js
ファイルを作成し、以下の設定を追加します
module.exports = new Proxy(
{},
{
get: function getter() {
return () => ({
className: 'className',
variable: 'variable',
style: { fontFamily: 'fontFamily' },
})
},
}
)
オプション: 絶対インポートとモジュールパスエイリアスの処理
プロジェクトでモジュールパスエイリアスを使用している場合、jsconfig.json
ファイルのpathsオプションとjest.config.js
ファイルのmoduleNameMapper
オプションを一致させることで、Jestがインポートを解決するように設定する必要があります。例:
{
"compilerOptions": {
"module": "esnext",
"moduleResolution": "bundler",
"baseUrl": "./",
"paths": {
"@/components/*": ["components/*"]
}
}
}
moduleNameMapper: {
// ...
'^@/components/(.*)$': '<rootDir>/components/$1',
}
オプション: カスタムマッチャーでJestを拡張
@testing-library/jest-dom
には、.toBeInTheDocument()
のような便利なカスタムマッチャーが含まれており、テストをより簡単に記述できます。Jest設定ファイルに次のオプションを追加することで、すべてのテストでカスタムマッチャーをインポートできます
setupFilesAfterEnv: ['<rootDir>/jest.setup.ts']
次に、jest.setup
内に、以下のインポートを追加します
import '@testing-library/jest-dom'
補足:
extend-expect
はv6.0
で削除されました。したがって、バージョン6より前の@testing-library/jest-dom
を使用している場合は、代わりに@testing-library/jest-dom/extend-expect
をインポートする必要があります。
各テストの前にさらにセットアップオプションを追加する必要がある場合は、上記のjest.setup
ファイルに追加できます。
package.json
にテストスクリプトを追加
最後に、Jestのtest
スクリプトをpackage.json
ファイルに追加します
{
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start",
"test": "jest",
"test:watch": "jest --watch"
}
}
jest --watch
は、ファイルが変更されるとテストを再実行します。その他のJest CLIオプションについては、Jestドキュメントを参照してください。
最初のテストを作成する
これでプロジェクトはテストを実行する準備ができました。プロジェクトのルートディレクトリに__tests__
という名前のフォルダを作成します。
例えば、<Home />
コンポーネントが正常にヘディングをレンダリングするかどうかをチェックするテストを追加できます
export default function Home() {
return <h1>Home</h1>
}
import '@testing-library/jest-dom'
import { render, screen } from '@testing-library/react'
import Home from '../pages/index'
describe('Home', () => {
it('renders a heading', () => {
render(<Home />)
const heading = screen.getByRole('heading', { level: 1 })
expect(heading).toBeInTheDocument()
})
})
オプションで、コンポーネントの予期しない変更を追跡するために、スナップショットテストを追加できます
import { render } from '@testing-library/react'
import Home from '../pages/index'
it('renders homepage unchanged', () => {
const { container } = render(<Home />)
expect(container).toMatchSnapshot()
})
補足: Pages Router内のファイルはルートと見なされるため、テストファイルをPages Router内に含めるべきではありません。
テストの実行
次に、以下のコマンドを実行してテストを実行します
npm run test
# or
yarn test
# or
pnpm test
追加リソース
さらに詳しく知りたい場合は、以下のリソースが役立つでしょう
- Jestを使用したNext.jsの例
- Jestドキュメント
- React Testing Libraryドキュメント
- Testing Playground - 要素を照合するための良いテストプラクティスを使用します。
この情報は役に立ちましたか?