Best Practices, Anti-patterns & Bảo trì ở quy mô lớn
Tổng hợp nguyên tắc thành bộ quy ước của đội: nên test gì ở tầng E2E, cấu trúc một test tốt, bảng anti-pattern, checklist code review, chỉ số sức khoẻ bộ test, và dùng AI có kiểm soát.
Mười ba module trước cho bạn kỹ thuật. Module này trả lời câu hỏi khó hơn: làm sao một bộ test giữ được chất lượng khi có 1.500 test, 12 người đóng góp, và hai năm tuổi? Câu trả lời không nằm ở một kỹ thuật nào, mà ở quy ước được viết ra, được tự động kiểm tra khi có thể, và được giữ qua code review. Code test là code sản phẩm: nó cần thiết kế, review, refactor, và cả việc xoá bỏ. Đây cũng là module bạn nên quay lại đọc mỗi khi review pull request của đồng nghiệp.
🎯 Mục tiêu học tập
- Quyết định được cái gì đáng có test E2E và cái gì nên kiểm tra ở tầng thấp hơn
- Viết test có cấu trúc rõ, tên mô tả hành vi, và thất bại với thông báo dễ hiểu
- Nhận diện và sửa các anti-pattern phổ biến nhất của Playwright
- Dùng checklist code review và lint để giữ chuẩn một cách tự động
- Theo dõi sức khoẻ bộ test bằng chỉ số, và dùng công cụ AI một cách có kiểm soát
Nên test gì ở tầng E2E
E2E là tầng test đắt nhất: chậm nhất, dễ gãy nhất, khó debug nhất. Nó cũng là tầng duy nhất chứng minh được các mảnh ghép hoạt động cùng nhau từ góc nhìn người dùng. Hãy tiêu ngân sách đó có chủ đích.
| Đáng có E2E | Nên ở tầng thấp hơn |
|---|---|
| Hành trình tạo ra doanh thu/giá trị cốt lõi: đăng ký, đăng nhập, tìm kiếm, mua hàng, thanh toán | Mọi tổ hợp validation của một biểu mẫu → unit/component test |
| Tích hợp giữa nhiều hệ thống: thanh toán, email, phân quyền | Logic tính toán (thuế, giảm giá, phí ship) → unit test + API test |
| Luồng đã từng gây sự cố production | Ma trận phân quyền đầy đủ → API test |
| Một ca đại diện cho mỗi loại lỗi quan trọng người dùng thấy | Trạng thái hiển thị của từng component → component test / visual |
| Thứ chỉ sai khi chạy trên trình duyệt thật | Hợp đồng giữa các service → contract test |
Câu hỏi kiểm tra cho mỗi test E2E định viết: "Nếu test này fail, có phải người dùng đang gặp vấn đề thật không? Và có tầng nào rẻ hơn bắt được lỗi này không?" Một bộ 150 test E2E được chọn kỹ, chạy 6 phút, xanh ổn định có giá trị hơn nhiều so với 2.000 test chạy 2 tiếng mà ai cũng bỏ qua.
Giải phẫu một test tốt
test.describe('Mã giảm giá khi thanh toán', () => {
test('mã hợp lệ giảm đúng số tiền và hiển thị dòng giảm giá',
{ tag: ['@checkout', '@smoke'] },
async ({ checkoutPage, api, cartWithItems }) => {
// Arrange — trạng thái xuất phát dựng bằng fixture + API, nói rõ dữ liệu quyết định kết quả
const coupon = await api.coupons.create({ code: uniqueId('GIAM'), percentOff: 10 });
const subtotal = cartWithItems.subtotal; // 1.250.000
// Act — đúng một hành vi đang được kiểm chứng
await checkoutPage.applyCoupon(coupon.code);
// Assert — kết quả người dùng quan sát được
await expect(checkoutPage.discountLine).toHaveMoney(subtotal * 0.1);
await expect(checkoutPage.total).toHaveMoney(subtotal * 0.9);
});
});
| Tính chất | Biểu hiện |
|---|---|
| Tên mô tả hành vi và kết quả | "mã hết hạn bị từ chối và tổng tiền không đổi" — không phải "test coupon 2" hay "TC_0142" |
| Một lý do để fail | Test kiểm chứng một hành vi; fail là biết ngay cái gì hỏng |
| Độc lập | Chạy một mình, theo thứ tự bất kỳ, song song — đều pass |
| Tự chứa | Đọc thân test là hiểu kịch bản và dữ liệu quan trọng, không phải mở năm file |
| Kiểm chứng điều người dùng thấy | Assert trên giao diện/hành vi, không trên chi tiết cài đặt (class CSS, state nội bộ) |
| Tất định | Không sleep, không phụ thuộc thời gian thực, không dữ liệu ngẫu nhiên không kiểm soát |
| Nhanh | Chuẩn bị bằng API; phần lớn test dưới 10-15 giây |
| Fail dễ hiểu | Thông báo nói điều gì sai về mặt nghiệp vụ; có trace |
Lặp lại một chút trong test là chấp nhận được. Nguyên tắc DRY áp dụng cho code test lỏng hơn code sản phẩm: một test dễ đọc từ trên xuống dưới quý hơn một test "gọn" mà mọi thứ ẩn sau ba tầng helper. Trừu tượng hoá cách làm (page object, fixture), giữ tường minh điều đang kiểm tra.
Bảng anti-pattern tổng hợp
| # | Anti-pattern | Thay bằng | Module |
|---|---|---|---|
| 1 | page.waitForTimeout(n) | Chờ điều kiện: web-first assertion, waitForResponse, expect.poll | 4 |
| 2 | expect(await locator.isVisible()).toBe(true) | await expect(locator).toBeVisible() | 4 |
| 3 | Quên await | Lint no-floating-promises | 1, 2 |
| 4 | XPath, class CSS sinh tự động, nth() tuỳ tiện | getByRole/getByLabel, filter, test id | 3 |
| 5 | waitForLoadState('networkidle') | Chờ phần tử hoặc response cụ thể | 9 |
| 6 | { force: true } để "bấm cho được" | Tìm thứ đang che và xử lý nó | 11 |
| 7 | Đăng nhập qua giao diện trong mọi test | storageState + setup project | 7 |
| 8 | Chuẩn bị dữ liệu qua giao diện | API + fixture | 8 |
| 9 | Phụ thuộc dữ liệu có sẵn dùng chung | Mỗi test tự tạo dữ liệu duy nhất | 8 |
| 10 | Test phụ thuộc thứ tự; biến let dùng chung | Fixture; test độc lập | 5, 8 |
| 11 | beforeEach khổng lồ, BaseTest kế thừa | Fixture | 5 |
| 12 | Page object bọc từng thao tác; BasePage khổng lồ | POM mỏng + component | 6 |
| 13 | Test "khổng lồ" kiểm tra 15 thứ | Tách theo hành vi; hoặc test.step cho hành trình dài có chủ đích | 14 |
| 14 | Logic điều kiện trong test: if (await x.isVisible()) ... | Test phải biết trạng thái của mình: dựng trạng thái tất định | 8 |
| 15 | Mock backend của chính mình trong luồng chính | Backend thật; mock chỉ cho bên thứ ba và trạng thái biên | 9 |
| 16 | Tăng retry/timeout để hết đỏ | Tìm nguyên nhân gốc | 11 |
| 17 | test.skip không lý do, sống mãi | Lý do + ticket + hạn; hoặc xoá | 10 |
| 18 | Test không có assertion ("chạy không lỗi là được") | Khẳng định kết quả người dùng thấy | 4 |
| 19 | Dùng page.evaluate để bấm/điền thay thao tác thật | Thao tác như người dùng | 12 |
| 20 | Bí mật, mật khẩu trong code; commit file auth | Biến môi trường, kho bí mật, .gitignore | 7, 13 |
if (await banner.isVisible()) await banner.close() trông vô hại nhưng là dấu hiệu test không
kiểm soát trạng thái của mình — và isVisible() không chờ, nên nhánh được chọn tuỳ vào thời
điểm. Với thứ thật sự bất chợt (banner cookie), dùng addLocatorHandler; với mọi thứ khác,
dựng trạng thái sao cho test biết chắc điều gì sẽ xuất hiện.
Checklist code review cho test
| Nhóm | Câu hỏi |
|---|---|
| Giá trị | Test này bảo vệ hành vi nào của người dùng? Có nên ở tầng thấp hơn không? Có trùng với test sẵn có không? |
| Đọc hiểu | Tên có mô tả hành vi và kết quả? Đọc thân test có hiểu kịch bản mà không mở file khác? |
| Locator | Có dùng locator hướng người dùng? Có nth/CSS/XPath nào thiếu lý do? |
| Chờ và assert | Mọi assertion đều là web-first? Có sleep, networkidle, force không? Assertion phủ định có được "neo" sau một assertion tích cực? |
| Dữ liệu | Test tự tạo dữ liệu qua API? Dữ liệu duy nhất? Có dọn dẹp? Có khẳng định nào trên tập toàn cục? |
| Cô lập | Chạy một mình được? Song song được? Có biến dùng chung cấp file? |
| Cấu trúc | Dùng fixture/page object có sẵn thay vì viết lại? Trừu tượng mới có thật sự cần (quy tắc ba lần)? |
| Độ ổn định | Đã chạy --repeat-each=20 chưa? Có phụ thuộc thời gian, múi giờ, thứ tự không? |
| Vệ sinh | Còn test.only, page.pause(), console.log, bí mật? skip có lý do và ticket? |
| Khi fail | Thông báo lỗi có giúp người khác hiểu điều gì hỏng mà không cần hỏi tác giả? |
Tự động hoá mọi thứ tự động hoá được: phần "vệ sinh" và phần lớn "chờ và assert" nên do
lint bắt, để người review dành sức cho các câu hỏi về giá trị và thiết kế. Viết bộ quy ước của đội thành
một file CONTRIBUTING.md ngắn trong thư mục test — và cập nhật nó mỗi khi một cuộc tranh
luận trong review kết thúc bằng một quyết định.
Sức khoẻ bộ test: đo để quản
| Chỉ số | Cho biết | Hành động khi xấu |
|---|---|---|
| Thời gian phản hồi của PR (p50, p95) | Bộ test có còn đủ nhanh để người ta chờ | Sharding; đẩy test xuống tầng thấp; tối ưu 10 test chậm nhất |
| Tỉ lệ pipeline fail do flaky | Mức độ nhiễu | Quy trình cách ly (Module 11) |
| Số test skip / cách ly và tuổi của chúng | Độ phủ đang mất âm thầm | Rà soát định kỳ: sửa hoặc xoá |
| Lỗi lọt ra production ở luồng có test E2E | Test có kiểm tra đúng thứ không | Phân tích sau sự cố → bổ sung/sửa test |
| Lỗi thật bộ test bắt được trước khi merge | Giá trị bộ test tạo ra | Nếu gần 0 trong thời gian dài: test đang kiểm tra sai thứ |
| Tỉ lệ test fail do thay đổi giao diện không đổi hành vi | Độ giòn của locator/POM | Cải thiện locator (Module 3) |
| Thời gian sửa một lần đỏ trên nhánh chính | Đội có coi trọng bộ test không | Quy tắc "đỏ là ưu tiên số một" |
Bảo trì định kỳ (mỗi quý):
- Xoá test không còn giá trị: trùng lặp, tính năng đã bỏ, chưa từng bắt lỗi và đã có tầng thấp hơn phủ. Bộ test chỉ thêm mà không bao giờ xoá sẽ sụp dưới sức nặng của chính nó.
- Nâng cấp Playwright đều đặn (mỗi 1-2 tháng): bản mới thường sửa lỗi ổn định và thêm công cụ; để dồn lâu thì mỗi lần nâng cấp thành một dự án.
- Rà lại tầng chạy: tập smoke có còn đúng là các hành trình sống còn không?
- Đọc lại danh sách test chậm nhất và flaky nhất — hai danh sách này thường trùng nhau.
Dùng AI trong test automation — có kiểm soát
| Công cụ / cách dùng | Hữu ích cho | Cần cẩn trọng |
|---|---|---|
| Trợ lý code AI (trong IDE hoặc coding agent) | Viết khung test, page object, fixture từ mô tả; refactor hàng loạt (đổi sleep sang assertion); giải thích trace và thông báo lỗi | Hay sinh mẫu cũ (XPath, waitForTimeout, waitForSelector); test "pass" nhưng assert yếu |
| Playwright MCP — cho agent điều khiển trình duyệt thật | Agent tự khám phá ứng dụng và lấy locator đúng từ trang đang chạy thay vì đoán; kiểm thử thăm dò | Không tất định; không thay được bộ regression viết bằng code |
| Agent chuyên cho test (lập kế hoạch test, sinh test, tự sửa test gãy) do Playwright và các công cụ khác cung cấp | Tăng tốc viết test đầu tiên cho tính năng mới; đề xuất sửa khi locator đổi | "Tự sửa" có thể sửa test cho khớp với lỗi của sản phẩm |
| AI phân tích kết quả | Tóm tắt lần chạy fail, nhóm lỗi cùng nguyên nhân, gợi ý nhóm flaky | Kiểm chứng lại bằng trace trước khi tin |
Nguyên tắc sử dụng:
- Cho AI ngữ cảnh của dự án: file hướng dẫn (quy ước locator, fixture có sẵn, cấm sleep) để nó sinh code theo chuẩn của bạn, không theo mẫu chung chung. Bộ lint chặt là hàng rào thứ hai.
- Con người chịu trách nhiệm về điều test khẳng định. Câu hỏi khi review test do AI viết: assertion này có thật sự chứng minh tính năng hoạt động không, hay chỉ chứng minh trang đã tải?
- Một test gãy là một tín hiệu. Trước khi để công cụ "tự chữa", phải có người xác nhận đó là thay đổi có chủ đích của sản phẩm chứ không phải lỗi.
- Sản phẩm cuối vẫn là code tất định nằm trong repo, chạy trong CI, được review — AI giúp viết nó nhanh hơn, không thay nó.
Khoá AI Agents & Agentic AI (Module 12) giải thích cách agent điều khiển trình duyệt hoạt động bên dưới và các lưu ý an toàn khi cho agent quyền chạy lệnh.
🏋️ Bài tập thực hành
(1) Viết CONTRIBUTING.md cho thư mục test (tối đa 2 trang): nên/không nên có E2E cho
cái gì, cấu trúc thư mục, quy ước đặt tên, locator, vị trí assertion, dữ liệu, tag, và chính sách flaky. (2)
Kiểm toán: quét toàn bộ bộ test theo bảng 20 anti-pattern, đếm số lần xuất hiện của từng cái; với mỗi cái
xuất hiện nhiều, xác định có quy tắc lint nào bắt được không và bật nó. (3) Chọn 10 test tệ nhất và viết lại
theo "giải phẫu một test tốt". (4) Rà giá trị: liệt kê 20 test E2E chậm nhất, với mỗi test trả lời "có tầng
nào rẻ hơn bắt được lỗi này không" — đề xuất chuyển hoặc xoá ít nhất 5 test. (5) Dựng dashboard đơn giản (một
bảng tính cũng được) cho các chỉ số sức khoẻ, cập nhật hằng tuần trong một tháng. (6) Thử dùng một trợ lý AI
viết 3 test với và không có file ngữ cảnh của dự án; review kỹ và ghi lại những lỗi nó mắc theo bảng anti-pattern.
📚 Tài nguyên học tập
-
Playwright — Best PracticesDanh sách khuyến nghị chính thức — đối chiếu với quy ước của độiDocs
-
Kent C. Dodds — Write tests. Not too many. Mostly integration.Cách phân bổ nỗ lực giữa các tầng testBài viết
-
Martin Fowler — The Practical Test PyramidKim tự tháp test và vai trò của E2EBài viết
-
Google Testing Blog — Just Say No to More End-to-End TestsLập luận kinh điển về chi phí của E2EBài viết
-
Playwright — Test agentsCác agent lập kế hoạch, sinh và sửa test đi kèm PlaywrightDocs
-
Microsoft — Playwright MCPCho AI agent điều khiển trình duyệt qua cây accessibilityRepo
✅ Tự đánh giá hoàn thành
- Đội có CONTRIBUTING.md cho test, và nó được cập nhật khi có quyết định mới
- Quyết định được một kiểm tra nên nằm ở tầng E2E hay tầng thấp hơn, và giải thích được
- Nhận ra 20 anti-pattern khi review; phần bắt được bằng lint đã được bật
- Dùng checklist khi review pull request có test
- Theo dõi chỉ số sức khoẻ bộ test và có lịch bảo trì định kỳ, gồm cả việc xoá test