コンポーネントのユニットテスト
React Testing LibraryやJestなどのテストライブラリを使って、Reactコンポーネントの効果的なユニットテストを作成します
「コンポーネントのユニットテスト」はCoddyKit上の無料Next.js 15 Fullstack (App Router + Server Actions)レッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはNext.js 15 Fullstack (App Router + Server Actions)学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。
このレッスンの一部はまだ翻訳されておらず、英語で表示されています。
Intro to Unit Testing
Welcome to unit testing for React components! Unit testing helps ensure that the smallest, independent parts of your code — your components — work exactly as intended.
- What is a unit test? It's a test for a 'unit' of code, often a single function or component.
- Why test components? To catch bugs early, prevent regressions, and ensure your UI behaves predictably.
- We'll focus on isolating components and testing their specific functionality.
Jest: The Test Runner
Jest is a popular JavaScript testing framework developed by Facebook. It's often used with React because it's fast, feature-rich, and includes everything you need for testing.
- Test Runner: Executes your tests and reports results.
- Assertion Library: Provides functions like
expectto check if values meet certain conditions. - Mocking Library: Helps isolate code by replacing dependencies with 'mock' versions.
React Testing Library (RTL)
While Jest runs the tests, React Testing Library (RTL) helps you test React components in a way that mimics how users interact with them.
- User-centric: RTL encourages testing actual user behavior, not internal implementation details.
- Accessibility: Its querying methods (like
getByRole) promote good accessibility practices. - It provides utilities to render components, query the DOM, and simulate user events.
Setting Up Your Test Environment
Next.js projects often come with Jest and RTL already configured or easily added. Here's what you'll typically use:
jest: The core test runner.@testing-library/react: The main library for testing React components.@testing-library/jest-dom: Provides custom Jest matchers for better DOM assertions (e.g.,.toBeInTheDocument()).
These libraries work together to create a powerful testing setup.
Our First Component to Test
Let's create a simple MyButton component. It will display some text and execute a function when clicked. This is a common pattern for interactive UI elements.
We'll save this as components/MyButton.js:
import React from 'react';
function MyButton({ text, onClick }) {
return (
<button onClick={onClick}>
{text}
</button>
);
}
export default MyButton;Basic Test Structure & Render
Test files typically live alongside the component (e.g., components/MyButton.test.js). We use describe to group related tests and test (or it) for individual test cases.
First, let's just render our button and ensure it appears. We'll use render from RTL.
import { render, screen } from '@testing-library/react';
import MyButton from './MyButton';
describe('MyButton', () => {
test('renders with the correct text', () => {
render(<MyButton text="Click Me" onClick={() => {}} />);
const buttonElement = screen.getByText(/Click Me/i);
expect(buttonElement).toBeInTheDocument();
});
});Querying Elements with RTL
RTL provides various 'query' methods to find elements in the rendered component. It's best to use queries that resemble how a user would find elements, prioritizing accessibility.
getByRole: Finds elements by their ARIA role (e.g., 'button', 'heading'). Highly recommended!getByText: Finds elements containing specific text.getByLabelText: Finds elements associated with a label.
We used getByText in the previous example, which is great for text content.
Simulating Interaction & Assertions
Now, let's test if our button's onClick handler is called when clicked. We use fireEvent from RTL to simulate user events and jest.fn() to create a 'mock' function.
jest.fn() lets us track if the function was called, how many times, and with what arguments. .toHaveBeenCalledTimes() is a jest-dom matcher.
import { render, screen, fireEvent } from '@testing-library/react';
import MyButton from './MyButton';
describe('MyButton', () => {
test('calls onClick handler when clicked', () => {
const handleClick = jest.fn(); // Create a mock function
render(<MyButton text="Submit" onClick={handleClick} />);
const buttonElement = screen.getByRole('button', { name: /Submit/i });
fireEvent.click(buttonElement); // Simulate a click
expect(handleClick).toHaveBeenCalledTimes(1); // Assert it was called once
});
});Quick Check on Testing
You have a component called Greeting that displays 'Hello, [name]!'.
// components/Greeting.js
function Greeting({ name }) {
return <h1>Hello, {name}!</h1>;
}
export default Greeting;Which test snippet correctly asserts that 'Hello, Alice!' is rendered?
Recap: Unit Testing Components
Great job! You've taken your first steps into unit testing React components using Jest and React Testing Library.
- Jest is your test runner and assertion framework.
- React Testing Library helps you test components from a user's perspective.
- You learned to render components, query for elements, simulate user interactions, and make assertions about component behavior.
Keep practicing to build robust and reliable Next.js applications!
よくある質問
「コンポーネントのユニットテスト」レッスンは無料ですか?
はい。「コンポーネントのユニットテスト」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、Next.js 15 Fullstack (App Router + Server Actions)コースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。
「コンポーネントのユニットテスト」で何を学びますか?
React Testing LibraryやJestなどのテストライブラリを使って、Reactコンポーネントの効果的なユニットテストを作成します ブラウザで直接実行するハンズオンコードでNext.js 15 Fullstack (App Router + Server Actions)を演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Next.js 15 Fullstack (App Router + Server Actions)を始めるのに経験は必要ですか?
事前経験は必要ありません。CoddyKitのNext.js 15 Fullstack (App Router + Server Actions)は初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「コンポーネントのユニットテスト」レッスンにはどのくらい時間がかかりますか?
ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このNext.js 15 Fullstack (App Router + Server Actions)レッスンでコードを書いて実行できますか?
はい。すべてのNext.js 15 Fullstack (App Router + Server Actions)レッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- コンポーネントのユニットテスト
- ページの統合テスト
- Playwright/CypressによるE2Eテスト
- APIルートのモックとテスト