Đã 2 giờ sáng. CI pipeline vừa thất bại. Các end-to-end test lại bị timeout — không phải vì tính năng bị hỏng, mà vì ba API call không liên quan đang hoạt động không ổn định. Bạn đã từng ở đây rồi. Bạn nhìn chằm chằm vào màn hình, tự hỏi liệu có cách nào tốt hơn để bắt lỗi UI mà không cần khởi động toàn bộ ứng dụng không.
Đó chính xác là lúc tôi tìm thấy Playwright Component Testing. Nếu bạn đang xây dựng UI production với React hoặc Vue, công cụ này sẽ thay đổi cách bạn nghĩ về độ phủ kiểm thử.
Bắt Đầu Nhanh: Chạy Được trong 5 Phút
Playwright Component Testing cho phép bạn mount từng UI component riêng lẻ trong trình duyệt thực — Chrome, Firefox, Safari — mà không cần khởi động server ứng dụng đầy đủ. Hãy nghĩ nó như Storybook cho khả năng kiểm thử: render trình duyệt thực, được điều khiển bởi Playwright API mà bạn đã quen từ E2E test.
Bắt đầu bằng cách thêm package vào dự án hiện có:
# Cho dự án React
npm init playwright@latest -- --ct
# Nếu bạn đang thêm vào dự án Playwright đã có
npx playwright install
Khi trình hướng dẫn khởi tạo chạy, hãy chọn framework của bạn. Nó sẽ tạo ra playwright/index.html và một mục cấu hình trong playwright.config.ts:
// playwright.config.ts
import { defineConfig, devices } from '@playwright/test';
export default defineConfig({
testDir: './src',
use: { baseURL: 'http://localhost:3100' },
projects: [
{
name: 'chromium',
use: { ...devices['Desktop Chrome'] },
},
],
});
Bây giờ hãy viết component test đầu tiên. Giả sử bạn có một component Badge:
// Badge.spec.tsx (React)
import { test, expect } from '@playwright/experimental-ct-react';
import Badge from './Badge';
test('hiển thị trạng thái lỗi', async ({ mount }) => {
const component = await mount(<Badge status="error" label="Thất bại" />);
await expect(component).toHaveText('Thất bại');
await expect(component).toHaveCSS('background-color', 'rgb(220, 38, 38)');
});
Chạy lệnh:
npx playwright test --project=chromium Badge.spec.tsx
Vậy là xong. Không cần server, không cần mock toàn bộ ứng dụng, không cần chờ routing ổn định. Component được mount, Playwright kiểm tra, xong.
Đào Sâu: Điều Gì Thực Sự Xảy Ra Bên Dưới
Playwright Component Testing chạy trên Vite bên dưới. Gọi mount() và Playwright sẽ khởi động một trang do Vite phục vụ, inject component của bạn vào một fixture container, và trả về một Locator handle — cùng loại mà bạn sử dụng trong E2E test đầy đủ.
Điều này quan trọng vì các component test của bạn nhận được render trình duyệt thực, không phải jsdom. CSS transition, hành vi cuộn trang, focus trap — tất cả đều hoạt động chính xác như trong production.
Xử Lý Props, Slots và Events
Hàm mount() chấp nhận tùy chọn props (Vue) hoặc JSX props (React), cùng với event callback. Đây là ví dụ Vue với một dropdown tùy chỉnh:
// Dropdown.spec.ts (Vue)
import { test, expect } from '@playwright/experimental-ct-vue';
import Dropdown from './Dropdown.vue';
test('phát ra sự kiện select khi click vào item', async ({ mount }) => {
let selectedValue = '';
const component = await mount(Dropdown, {
props: {
options: ['Alpha', 'Beta', 'Gamma'],
onSelect: (val: string) => { selectedValue = val; },
},
});
await component.getByRole('button').click();
await component.getByText('Beta').click();
expect(selectedValue).toBe('Beta');
});
Lưu ý bạn không cần dùng thư viện spy. Event handler là JavaScript thuần — không có spy instance, không có cấu hình mock, không có gì cần dọn dẹp sau đó.
Mock Fetch và Dependencies Bên Ngoài
Các component fetch dữ liệu cần mock. API page.route() của Playwright cũng hoạt động bên trong component test:
test('hiển thị dữ liệu người dùng từ API', async ({ page, mount }) => {
await page.route('**/api/users/1', async route => {
await route.fulfill({
json: { id: 1, name: 'Hieu Nguyen', role: 'admin' },
});
});
const component = await mount(<UserProfile userId={1} />);
await expect(component.getByText('Hieu Nguyen')).toBeVisible();
await expect(component.getByText('admin')).toBeVisible();
});
Điều này vượt trội hơn so với cách tiếp cận jest.mock() kinh điển vì bạn đang chặn ở tầng mạng — chính xác những gì trình duyệt thực làm. Không có trò lừa đảo nào ở cấp độ module.
Sử Dụng Nâng Cao: Các Pattern Có Thể Mở Rộng
Kiểm Thử Chuyển Đổi Trạng Thái Component
Một trong những thứ khó kiểm thử nhất với snapshot testing hoặc unit test là hành vi có trạng thái — trạng thái loading, khôi phục lỗi, danh sách trống so với có dữ liệu. Playwright xử lý điều này rất gọn:
test('hiển thị skeleton, sau đó nội dung, sau đó xử lý refetch', async ({ page, mount }) => {
let resolveRequest: () => void;
const requestPending = new Promise<void>(res => { resolveRequest = res; });
await page.route('**/api/posts', async route => {
await requestPending;
await route.fulfill({ json: [{ id: 1, title: 'Bài Viết Đầu Tiên' }] });
});
const component = await mount(<PostList />);
// Trạng thái loading
await expect(component.getByTestId('skeleton')).toBeVisible();
// Kích hoạt dữ liệu
resolveRequest!();
await expect(component.getByText('Bài Viết Đầu Tiên')).toBeVisible();
await expect(component.getByTestId('skeleton')).not.toBeVisible();
});
Tái Sử Dụng Fixtures Trong Nhiều Test
Nếu nhiều test cần cùng một setup — theme provider, router context, Pinia store — hãy định nghĩa một fixture tùy chỉnh một lần:
// fixtures.ts
import { test as base } from '@playwright/experimental-ct-react';
import { MemoryRouter } from 'react-router-dom';
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
export const test = base.extend({
mount: async ({ mount }, use) => {
await use(async (component: JSX.Element) => {
const qc = new QueryClient();
return mount(
<QueryClientProvider client={qc}>
<MemoryRouter>{component}</MemoryRouter>
</QueryClientProvider>
);
});
},
});
Sau đó import test từ ./fixtures thay vì từ Playwright trực tiếp. Mọi component bạn mount bây giờ đều có routing và query context — không cần copy-paste wrapper qua các file.
Kiểm Thử Visual Regression với Screenshots
API toHaveScreenshot() của Playwright hoạt động bên trong component test. Nó bắt được các visual regression mà code review và lint đều bỏ sót — nút bị dịch chuyển hai pixel, icon ngừng render sau khi chỉnh sửa CSS:
test('Button visual regression — biến thể primary', async ({ mount }) => {
const component = await mount(<Button variant="primary">Gửi</Button>);
await expect(component).toHaveScreenshot('button-primary.png');
});
Ở lần chạy đầu tiên, Playwright lưu baseline. Sau đó, bất kỳ sự khác biệt pixel nào cũng sẽ làm test thất bại. Hãy commit các screenshot này vào Git để cả nhóm dùng chung một baseline.
Mẹo Thực Chiến
Giữ Test Hẹp
Component test nên kiểm tra một hành vi mỗi test, không phải một file. Nếu component Table của bạn có sorting, filtering và pagination, hãy viết ba test riêng biệt. Test hẹp dễ debug hơn khi thất bại lúc 2 giờ sáng.
Tránh Kiểm Thử Chi Tiết Triển Khai
Đừng kiểm tra biến trạng thái nội bộ hay private method. Hãy kiểm tra những gì người dùng thấy: text, visibility, CSS class, event được phát ra. Điều này làm cho test có khả năng chịu đựng refactor — bạn có thể viết lại phần nội bộ mà không cần chỉnh sửa một test nào.
Chạy Component Test trong CI Riêng Biệt so với E2E
Hầu hết component test hoàn thành trong 100–500ms. Giữ chúng trong một CI job riêng biệt chạy trên mỗi push. Dành full E2E run cho merge request hoặc nightly build theo lịch. Điều này rút ngắn vòng phản hồi từ vài phút xuống còn vài giây.
# .github/workflows/test.yml
jobs:
component-tests:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci
- run: npx playwright install chromium
- run: npx playwright test --project=chromium src/
Dùng update-snapshots Cẩn Thận
Khi bạn cố ý thay đổi giao diện của một component, hãy chạy:
npx playwright test --update-snapshots
Sau đó commit các screenshot mới. Đừng bao giờ tự động cập nhật snapshot trong CI — một thay đổi style ngoài ý muốn sẽ âm thầm ghi đè baseline của bạn và bạn sẽ không phát hiện ra cho đến khi khách hàng báo lỗi kèm ảnh đính kèm.
Debug Test Bị Thất Bại
Không gì tăng tốc debug như chế độ UI của Playwright. Mở nó lên và bạn có một trình duyệt trực tiếp, timeline của mọi action và DOM snapshot tại mỗi bước:
npx playwright test --ui
Khi một test hoạt động không ổn định, hãy thêm await page.pause() vào thân test. Trình duyệt sẽ dừng lại và cho bạn một DevTools console để khám phá. Tốt hơn nhiều so với việc đọc stack trace lúc 3 giờ sáng.
Khi Nào Dùng Component Testing so với E2E
Component testing không phải là sự thay thế cho end-to-end test — đó là sự bổ sung. Dùng component test cho những gì một component đơn lẻ làm trong điều kiện độc lập: render, tương tác người dùng, trạng thái visual. Dùng E2E test cho các luồng vượt ranh giới: xác thực, thanh toán, điều hướng đa trang.
Hướng đến 80% bề mặt UI của bạn được phủ bởi component test. Sau đó viết các E2E test tập trung cho những đường dẫn thực sự quan trọng — đăng nhập, thanh toán, bất kỳ luồng nào liên quan đến thanh toán hay xác thực. Sự kết hợp đó cho bạn phản hồi nhanh về hầu hết các thay đổi mà không hy sinh sự tự tin ở những nơi quan trọng.
Playwright Component Testing vẫn được phân phối dưới tên package @playwright/experimental-ct-*, nhưng API đã ổn định qua các phiên bản và các nhóm đang chạy nó trong production. Microsoft tiếp tục đầu tư tích cực vào nó. Nếu codebase React hoặc Vue của bạn có độ phức tạp UI thực sự, thời gian setup hai giờ sẽ hoàn vốn ngay trong sprint đầu tiên.

