Playwright + TypeScript Thực chiến
Trang chủ / Module 12
🖼️ Module 12 / 15 · 1-2 tuần

Visual, Accessibility & Các kỹ thuật nâng cao

So sánh ảnh chụp ổn định, ARIA snapshot, kiểm thử accessibility với axe, giả lập thiết bị và quyền, tải lên/tải xuống file, nhiều tab, và các trường hợp đặc biệt.

Visual RegressionAccessibilityEmulationFiles
📌 Vì sao module này quan trọng

Test chức năng trả lời "nó có chạy không"; còn một lớp lỗi mà chúng mù hoàn toàn: nút bị tràn khỏi khung, chữ trắng trên nền trắng, bố cục vỡ trên điện thoại, biểu mẫu không dùng được bằng bàn phím. Playwright có sẵn công cụ cho các lớp kiểm thử này — nhưng visual testing đặc biệt dễ trở thành nguồn nhiễu khổng lồ nếu làm không kỷ luật. Module này tập trung vào cách làm cho chúng ổn định và có tín hiệu, cùng các kỹ thuật cho những tình huống giao diện "khó nhằn". Khoá Advanced QA (Module 7, 13) có phần chiến lược cho visual và accessibility testing.

🎯 Mục tiêu học tập

  • Viết visual test ổn định: môi trường nhất quán, che vùng động, ngưỡng hợp lý, quy trình cập nhật baseline
  • Dùng ARIA snapshot để kiểm tra cấu trúc trang mà không phụ thuộc điểm ảnh
  • Tích hợp kiểm thử accessibility tự động bằng axe và hiểu giới hạn của nó
  • Giả lập thiết bị, vị trí, quyền, chế độ màu, và trạng thái mạng
  • Xử lý tải lên, tải xuống, nhiều tab, dialog, kéo thả, và clipboard

Visual regression với toHaveScreenshot

test('trang chi tiết sản phẩm', { tag: '@visual' }, async ({ page, product }) => {
  await page.goto(`/products/${product.slug}`);
  await expect(page.getByRole('heading', { name: product.name })).toBeVisible();

  await expect(page).toHaveScreenshot('product-detail.png', {
    fullPage: true,
    mask: [page.getByTestId('recommendations'), page.getByTestId('timestamp')],   // che vùng động
    maxDiffPixelRatio: 0.01,
  });
});

// Chụp theo component: ổn định và diff dễ đọc hơn chụp cả trang
await expect(page.getByTestId('price-card')).toHaveScreenshot('price-card.png');
// playwright.config.ts
expect: {
  toHaveScreenshot: {
    animations: 'disabled',          // dừng animation CSS trước khi chụp
    caret: 'hide',
    scale: 'css',
    maxDiffPixelRatio: 0.01,
    stylePath: './tests/visual.css', // CSS chèn khi chụp: ẩn quảng cáo, chat widget...
  },
},
snapshotPathTemplate: '{testDir}/__screenshots__/{projectName}/{testFilePath}/{arg}{ext}',

Lần chạy đầu tạo ảnh baseline; các lần sau so sánh với nó và tự chụp lại đến khi hai ảnh liên tiếp giống nhau (ổn định) rồi mới so. Cập nhật baseline: npx playwright test --update-snapshots.

Nguồn nhiễuCách khử
Khác hệ điều hành/font (ảnh chụp trên macOS khác Linux)Tạo và so baseline trong cùng một image Docker với CI. Đây là quy tắc quan trọng nhất của visual testing
Nội dung động: ngày giờ, số liệu, gợi ý, avatarmask; cố định dữ liệu bằng mock; page.clock
Animation, con trỏ nhấp nháyanimations: 'disabled', caret: 'hide'
Font web chưa tải, ảnh tải trễChờ document.fonts.ready; chờ ảnh hiển thị trước khi chụp
Khử răng cưa khác nhau vài điểm ảnhNgưỡng nhỏ (maxDiffPixelRatio); không đặt ngưỡng lớn để "cho qua"
Chụp cả trang quá rộngChụp theo component/vùng
⚠️ Kỷ luật baseline

Visual test chỉ có giá trị nếu mỗi thay đổi baseline được một người xem xét bằng mắt trong pull request. Nếu đội có thói quen chạy --update-snapshots rồi commit mà không nhìn diff, bộ visual test chỉ là nghi thức. Bắt đầu nhỏ: 10-20 ảnh cho các trang/component quan trọng nhất, giữ chúng xanh ổn định, rồi mới mở rộng.

ARIA snapshot: kiểm tra cấu trúc không phụ thuộc điểm ảnh

await expect(page.getByRole('navigation', { name: 'Chính' })).toMatchAriaSnapshot(`
  - navigation "Chính":
    - link "Trang chủ"
    - link "Sản phẩm"
    - link "Đơn hàng"
    - button "Tài khoản"
`);

await expect(page.getByRole('form', { name: 'Thanh toán' })).toMatchAriaSnapshot(`
  - form "Thanh toán":
    - textbox "Họ và tên"
    - textbox "Số điện thoại"
    - combobox "Tỉnh/Thành"
    - button "Đặt hàng" [disabled]
`);

ARIA snapshot so sánh cây accessibility (vai trò, tên, trạng thái) dưới dạng YAML. Khớp từng phần: chỉ cần liệt kê những gì bạn quan tâm; hỗ trợ regex cho nội dung động.

Ảnh chụpARIA snapshot
Bắt đượcMọi thay đổi nhìn thấy: màu, khoảng cách, fontThay đổi cấu trúc và ngữ nghĩa: thiếu phần tử, sai nhãn, sai trạng thái
Độ ổn địnhNhạy với môi trườngRất ổn định, không phụ thuộc OS/font
DiffẢnh, phải nhìn bằng mắtVăn bản, đọc được trong code review
Phụ thêm—Ép giao diện có cây accessibility tử tế

Hai công cụ bổ sung nhau; với nhiều đội, ARIA snapshot cho phần lớn giá trị "phát hiện thay đổi ngoài ý muốn" với chi phí bảo trì thấp hơn hẳn.

Accessibility testing với axe

import AxeBuilder from '@axe-core/playwright';

test('trang thanh toán không có vi phạm WCAG A/AA', async ({ page, checkoutPage }) => {
  const results = await new AxeBuilder({ page })
    .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'])
    .exclude('[data-testid="third-party-widget"]')
    .analyze();

  expect(results.violations, formatViolations(results.violations)).toEqual([]);
});

// Fixture dùng chung cấu hình cho cả dự án
export const test = base.extend<{ makeAxeBuilder: () => AxeBuilder }>({
  makeAxeBuilder: async ({ page }, use) => {
    await use(() => new AxeBuilder({ page }).withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa']));
  },
});
  • Quét sau khi trang ở đúng trạng thái: mở dialog, hiện thông báo lỗi của biểu mẫu rồi mới quét — nhiều vi phạm chỉ xuất hiện ở trạng thái tương tác.
  • Áp dụng dần cho ứng dụng có sẵn nhiều vi phạm: ghi nhận hiện trạng làm baseline (bằng disableRules có kèm ticket), chặn vi phạm mới, rồi giảm dần danh sách.
  • Công cụ tự động chỉ bắt được một phần (thường ước lượng khoảng một phần ba đến một nửa) các vấn đề accessibility: thiếu nhãn, độ tương phản, vai trò sai. Nó không biết thứ tự focus có hợp lý không, hay văn bản thay thế có đúng nghĩa không.

Bổ sung bằng test bàn phím — thứ Playwright làm rất tốt:

test('dialog giữ focus và đóng được bằng Escape', async ({ page }) => {
  const trigger = page.getByRole('button', { name: 'Xoá sản phẩm' });
  await trigger.focus();
  await page.keyboard.press('Enter');

  const dialog = page.getByRole('dialog', { name: 'Xoá sản phẩm' });
  await expect(dialog.getByRole('button', { name: 'Huỷ' })).toBeFocused();   // focus vào trong dialog

  await page.keyboard.press('Escape');
  await expect(dialog).toBeHidden();
  await expect(trigger).toBeFocused();                                       // focus quay lại nút mở
});

Và nhớ: dùng getByRole/getByLabel làm locator mặc định (Module 3) đã là một lớp kiểm thử accessibility ngầm cho toàn bộ bộ test.

Giả lập thiết bị và môi trường

// Theo project (config) hoặc theo nhóm test
test.use({
  ...devices['iPhone 15'],                       // viewport, user agent, touch, tỉ lệ điểm ảnh
  colorScheme: 'dark',
  locale: 'en-US',
  timezoneId: 'America/New_York',
  geolocation: { latitude: 10.7769, longitude: 106.7009 },
  permissions: ['geolocation', 'notifications'],
  offline: false,
});

test('gợi ý cửa hàng gần nhất theo vị trí', async ({ page, context }) => {
  await page.goto('/stores');
  await expect(page.getByTestId('nearest-store')).toContainText('Quận 1');

  await context.setGeolocation({ latitude: 21.0278, longitude: 105.8342 });
  await page.getByRole('button', { name: 'Cập nhật vị trí' }).click();
  await expect(page.getByTestId('nearest-store')).toContainText('Hoàn Kiếm');
});

// Chuyển đổi trong lúc chạy
await page.emulateMedia({ colorScheme: 'dark', reducedMotion: 'reduce' });
await page.setViewportSize({ width: 375, height: 812 });
await context.setOffline(true);

Giới hạn cần biết: giả lập di động là trình duyệt máy tính với viewport, user agent và sự kiện chạm của điện thoại — không phải thiết bị thật. Nó bắt tốt lỗi bố cục responsive và luồng chạm; nó không tái hiện được khác biệt của engine trình duyệt di động thật, hiệu năng thiết bị, hay bàn phím ảo. Project webkit gần với Safari hơn nhiều so với không test gì, nhưng vẫn không phải Safari trên iPhone thật. Với sản phẩm mà di động là kênh chính, bổ sung một lượng nhỏ test trên thiết bị thật/farm thiết bị.

File, tab, dialog và các tương tác đặc biệt

// Tải lên
await page.getByLabel('Ảnh sản phẩm').setInputFiles('fixtures/files/binh.jpg');
await page.getByLabel('Tài liệu').setInputFiles([
  { name: 'hop-dong.pdf', mimeType: 'application/pdf', buffer: Buffer.from(pdfBytes) },   // file tạo trong bộ nhớ
]);
// Vùng kéo thả không có input hiển thị: bắt sự kiện filechooser
const chooser = page.waitForEvent('filechooser');
await page.getByText('Kéo thả hoặc bấm để chọn file').click();
await (await chooser).setFiles('fixtures/files/import.csv');

// Tải xuống: kiểm tra cả tên file LẪN nội dung
const downloadPromise = page.waitForEvent('download');
await page.getByRole('button', { name: 'Xuất Excel' }).click();
const download = await downloadPromise;
expect(download.suggestedFilename()).toMatch(/^don-hang-\d{8}\.xlsx$/);
const filePath = testInfo.outputPath(download.suggestedFilename());
await download.saveAs(filePath);
const rows = await readXlsx(filePath);
expect(rows).toHaveLength(order.items.length + 1);

// Tab mới
const popupPromise = page.waitForEvent('popup');
await page.getByRole('link', { name: 'Xem hoá đơn' }).click();
const invoice = await popupPromise;
await expect(invoice.getByRole('heading', { name: /Hoá đơn/ })).toBeVisible();

// Dialog của trình duyệt (alert/confirm/prompt): đăng ký TRƯỚC hành động
page.once('dialog', dialog => dialog.accept());
await page.getByRole('button', { name: 'Xoá' }).click();

// Kéo thả, bàn phím, clipboard
await page.getByTestId('task-1').dragTo(page.getByTestId('column-done'));
await page.getByRole('textbox').press('ControlOrMeta+A');
await context.grantPermissions(['clipboard-read', 'clipboard-write']);
const copied = await page.evaluate(() => navigator.clipboard.readText());
Tình huốngLưu ý
File tải xuốngMặc định bị xoá khi context đóng — saveAs nếu cần giữ. Kiểm tra nội dung, không chỉ kiểm tra "có tải"
PDFTải về rồi phân tích bằng thư viện đọc PDF; không cố kiểm tra qua trình xem PDF của trình duyệt
Dialog trình duyệtNếu không có handler, Playwright tự đóng (dismiss) — hành động xoá sẽ âm thầm không xảy ra
Kéo thả tuỳ biếnThư viện dùng sự kiện chuột riêng có thể cần chuỗi hover → mouse.down → mouse.move (nhiều bước) → mouse.up
Canvas, biểu đồ, bản đồKhông có DOM để tìm: kiểm tra dữ liệu đầu vào qua API/trạng thái ứng dụng, cộng một ảnh chụp cho phần hiển thị
WebSocket, sự kiện thời gian thựcHai context trong một test; hoặc page.routeWebSocket để giả lập server
Chạy JavaScript trong trangpage.evaluate — dùng để đọc trạng thái hoặc chuẩn bị, không dùng để thay thao tác người dùng

🏋️ Bài tập thực hành

Bổ sung ba lớp kiểm thử phi chức năng

(1) Visual: chọn 8 trang/component quan trọng, viết visual test với mask và cấu hình ổn định hoá; tạo baseline trong đúng image Docker của CI; chạy 10 lần liên tiếp và đạt 0 lần fail giả. Sau đó cố ý tạo một lỗi CSS nhỏ và xác nhận test bắt được. (2) ARIA snapshot: viết snapshot cho thanh điều hướng và hai biểu mẫu chính; so sánh công bảo trì với visual test sau một lần giao diện thay đổi. (3) Accessibility: thêm fixture axe, quét 5 trang ở cả trạng thái thường và trạng thái tương tác (dialog mở, biểu mẫu có lỗi); ghi nhận hiện trạng, phân loại vi phạm theo mức độ, lập kế hoạch giảm dần. Viết 3 test bàn phím cho dialog, menu thả xuống, và biểu mẫu. (4) Giả lập: chạy tập @mobile trên một project di động và sửa những gì vỡ; viết một test chế độ tối và một test mất mạng. (5) File: viết test tải lên (cả ca file sai định dạng/quá lớn) và test tải xuống kiểm tra nội dung file xuất ra.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Visual test tạo baseline trong cùng image với CI, có mask, và chạy lặp không fail giả
  • Mọi thay đổi baseline được xem xét bằng mắt trong pull request
  • Có ARIA snapshot cho các vùng cấu trúc quan trọng
  • Có kiểm thử axe tự động và test bàn phím cho các thành phần tương tác chính
  • Xử lý được tải lên, tải xuống (kiểm tra nội dung), tab mới, và dialog trình duyệt