Next.js 15 Fullstack (App Router + Server Actions) · 课时

使用 Playwright/Cypress 进行端到端测试

使用 Playwright 或 Cypress 等工具模拟用户交互，实施端到端测试并验证完整的应用流程。

使用 Playwright/Cypress 进行端到端测试 是 CoddyKit 上的免费 Next.js 15 Fullstack (App Router + Server Actions) 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 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.

常见问题解答

「使用 Playwright/Cypress 进行端到端测试」课时是免费的吗？

是的 — 「使用 Playwright/Cypress 进行端到端测试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Next.js 15 Fullstack (App Router + Server Actions) 课程的其余内容，请升级到 CoddyKit PRO。 Next.js 15 Fullstack (App Router + Server Actions) 课程共包含 4 节课。

「使用 Playwright/Cypress 进行端到端测试」这节课中我会学到什么？

使用 Playwright 或 Cypress 等工具模拟用户交互，实施端到端测试并验证完整的应用流程。你通过在浏览器中直接运行的动手代码来练习 Next.js 15 Fullstack (App Router + Server Actions)，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Next.js 15 Fullstack (App Router + Server Actions) 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Next.js 15 Fullstack (App Router + Server Actions) 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「使用 Playwright/Cypress 进行端到端测试」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Next.js 15 Fullstack (App Router + Server Actions) 课中编写并运行代码吗？

能。每节 Next.js 15 Fullstack (App Router + Server Actions) 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

组件单元测试
页面集成测试
使用 Playwright/Cypress 进行端到端测试
模拟与测试 API 路由

← 返回 Next.js 15 Fullstack (App Router + Server Actions)