Next.js 15 Fullstack (App Router + Server Actions) · レッスン

Playwright/CypressによるE2Eテスト

PlaywrightやCypressなどのツールを使って、ユーザー操作をシミュレートするエンドツーエンドテストを実装し、アプリケーション全体のフローを検証します。

レッスン 3/411 ステップ

「Playwright/CypressによるE2Eテスト」はCoddyKit上の無料Next.js 15 Fullstack (App Router + Server Actions)レッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはNext.js 15 Fullstack (App Router + Server Actions)学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

What is End-to-End Testing?

End-to-End (E2E) testing simulates a real user's journey through your application, from start to finish. It tests the entire flow, including the UI, database, network requests, and server logic.

Think of it as ensuring all the pieces of your Next.js application work together seamlessly, just like a user would expect.

Why E2E for Next.js?

For Next.js applications, E2E testing is crucial because they often involve complex interactions between client and server components, API routes, and external services.

  • Verifies Integrations: Checks if different parts (frontend, backend, database) communicate correctly.
  • User Experience: Ensures critical user flows, like login or checkout, function as intended.
  • Confidence: Provides high confidence that new features or changes haven't broken existing functionality.

Introducing Playwright

While Cypress is another popular choice, we'll focus on Playwright for E2E testing in Next.js. Playwright is a powerful open-source framework from Microsoft that enables reliable end-to-end testing.

Key features:

  • Supports all modern browsers (Chromium, Firefox, WebKit).
  • Fast and reliable test execution.
  • Auto-waits for elements to be ready.
  • Rich set of APIs for interacting with web pages.

Setting Up Playwright

Getting Playwright ready in your Next.js project is straightforward. You'll typically run an initialization command that sets up the necessary files and installs browser binaries.

Open your terminal in your Next.js project and run:

npm init playwright@latest

Your First E2E Test

Let's write a basic test to navigate to your application's homepage and verify its title. Playwright tests are written using a test runner similar to Jest.

After setup, you'll find a tests/example.spec.ts file. Modify it:

import { test, expect } from '@playwright/test';

test('homepage has title', async ({ page }) => {
  await page.goto('http://localhost:3000/');
  await expect(page).toHaveTitle(/Next.js App/);
});

Interacting with UI Elements

Playwright allows you to simulate user actions like clicking buttons or typing into input fields. You select elements using CSS selectors, text content, or specific roles.

Here's how to fill an input and click a button:

import { test, expect } from '@playwright/test';

test('user can interact with elements', async ({ page }) => {
  await page.goto('http://localhost:3000/contact'); // Assume a contact page
  await page.fill('input[name="name"]', 'Coddy Kit');
  await page.click('button[type="submit"]');
  // After clicking, we might expect a success message to appear
  await expect(page.locator('.success-message')).toBeVisible();
});

Assertions and Visibility

Assertions are key to E2E tests, verifying that your application behaves as expected. Playwright's expect provides many matchers to check element properties, text, and visibility.

Let's verify text content and visibility:

import { test, expect } from '@playwright/test';

test('elements display correct text', async ({ page }) => {
  await page.goto('http://localhost:3000/about');
  const heading = page.locator('h1');
  await expect(heading).toHaveText('About Us');
  const paragraph = page.locator('p');
  await expect(paragraph).toContainText('Our mission');
});

Testing Form Submissions

E2E tests are perfect for validating entire form submission flows, ensuring data is sent to the server, processed, and the UI updates correctly. This covers both client-side and server-side logic.

Consider a contact form:

import { test, expect } from '@playwright/test';

test('submit contact form successfully', async ({ page }) => {
  await page.goto('http://localhost:3000/contact');
  await page.fill('input[name="email"]', 'test@example.com');
  await page.fill('textarea[name="message"]', 'Hello CoddyKit!');
  await page.click('button[type="submit"]');
  await expect(page.locator('.form-status')).toHaveText('Message sent!');
});

Running Your Tests

Once your tests are written, you can easily run them from the command line. Playwright offers various options, like running tests in headless mode (without opening a browser) or with a UI for debugging.

To run all tests:

npx playwright test

E2E Best Practices

Writing effective E2E tests requires careful planning to make them robust and maintainable. Which of these are good practices?

Recap: E2E Testing

Congratulations! You've explored End-to-End testing for Next.js applications using Playwright.

  • E2E tests simulate real user journeys.
  • Playwright is a powerful tool for cross-browser E2E testing.
  • You learned to set up Playwright, write tests for navigation, user interaction, and form submissions.
  • Remember to follow best practices for robust and maintainable E2E tests.
無料で開始

AI チューターと学ぶ TypeScript — 無料

ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。

コース
22
レッスン
88

よくある質問

「Playwright/CypressによるE2Eテスト」レッスンは無料ですか?

はい。「Playwright/CypressによるE2Eテスト」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し(組み込みコードエディタと24時間対応のAIチューター)、Next.js 15 Fullstack (App Router + Server Actions)コースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Next.js 15 Fullstack (App Router + Server Actions)コースには全4レッスンが含まれています。

「Playwright/CypressによるE2Eテスト」で何を学びますか?

PlaywrightやCypressなどのツールを使って、ユーザー操作をシミュレートするエンドツーエンドテストを実装し、アプリケーション全体のフローを検証します。 ブラウザで直接実行するハンズオンコードで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)は初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。

「Playwright/CypressによるE2Eテスト」レッスンにはどのくらい時間がかかりますか?

ほとんどのCoddyKitレッスンは約5~10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNext.js 15 Fullstack (App Router + Server Actions)レッスンでコードを書いて実行できますか?

はい。すべてのNext.js 15 Fullstack (App Router + Server Actions)レッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. コンポーネントのユニットテスト
  2. ページの統合テスト
  3. Playwright/CypressによるE2Eテスト
  4. APIルートのモックとテスト
← Next.js 15 Fullstack (App Router + Server Actions)に戻る