Next.js App RouterのコンポーネントをJestとTesting Libraryでテストする

「NEXT BASE」(旧 NEXT TECH)では、ヘッダーやフッター、FAQ などのコンポーネントと各ページに Jest のテストを用意しています。Next.js 16・React 19 に上げたときに、Jest も 30 に上げました。next/jest を使うと、設定はほんの数行で済みます。
リポジトリ:Nextjs-TypeScript-MicroCMS-Site2 / デモ:https://next-tech-trigger.vercel.app/
セットアップ
npm i -D jest jest-environment-jsdom @testing-library/react @testing-library/dom @testing-library/jest-dom @testing-library/user-event @types/jest
React Testing Library の 16 からは、@testing-library/dom を自分で入れる必要があります。以前は一緒に入っていたので、上げたときに「@testing-library/dom が見つからない」というエラーが出たら、これを足してください。
// jest.config.mjs
import nextJest from 'next/jest.js'
const createJestConfig = nextJest({ dir: './' })
/** @type {import('jest').Config} */
const customJestConfig = {
testEnvironment: 'jsdom',
}
export default createJestConfig(customJestConfig)
next/jest が、SWC による TypeScript/JSX の変換、CSS Modules や画像のモック、.env の読み込みをまとめて設定してくれます。設定ファイルは require から import の書き方に変え、拡張子を .mjs にしました。ESM として読み込むので、next/jest は next/jest.js と拡張子まで書きます。
表示のテスト
コンポーネントに data-testid を付けておき、描画されているかを確認します。
import { render, screen } from '@testing-library/react'
import '@testing-library/jest-dom'
import { Header } from './Header'
test('Header component renders correctly', () => {
render(<Header />)
expect(screen.getByTestId('header')).toBeInTheDocument()
})
操作のテスト
スマホ用メニューの開閉ボタンを押すと、body に open クラスが付いたり外れたりすることを確認しています。
test('Navigation toggle button works correctly', () => {
render(<Header />)
const button = screen.getByTestId('jsNavToggle')
fireEvent.click(button)
expect(document.body.classList.contains('open')).toBe(true)
fireEvent.click(button)
expect(document.body.classList.contains('open')).toBe(false)
})
next/navigation を使うコンポーネント
お問い合わせフォームは、送信後に useRouter() で完了ページへ移動します。テストの中には Next.js のルーターがないので、next/navigation をモックして push だけを差し替えます。
const push = jest.fn()
jest.mock('next/navigation', () => ({
...jest.requireActual('next/navigation'),
useRouter: () => ({ push }),
}))
test('renders Contact component', () => {
render(<Contact />)
expect(screen.getByText(/Submit/i)).toBeInTheDocument()
})
メールアドレスの形式チェックは validateEmail という関数に切り出してあるので、画面を描画しなくても、関数だけをテストできます。
テストしやすくするために
data-testidよりも、可能ならgetByRole('button', { name: ... })のように役割と名前で探すほうが、アクセシビリティの確認も兼ねられる- 時計のように時間に依存するものは、
jest.useFakeTimers()で時間を固定する - microCMS を呼ぶ Server Component は単体テストせず、表示用のコンポーネントにデータを渡す形に分けるとテストしやすい
- 型チェック(
tsc --noEmit)の対象からテストファイルを外しておくと、テスト用の型と本番の型が混ざらない
まとめ
next/jest のおかげで、App Router のプロジェクトでも Client Component のテストはすぐ始められます。Next.js 16・Jest 30 に上げるときは、設定ファイルの ESM 化と @testing-library/dom の追加だけで、テスト本体はほとんどそのまま動きました。まずはヘッダーのメニュー開閉のような、壊れると困る操作から書いていくのがおすすめです。