Playwright + TypeScript Thực chiến
Trang chủ / Module 14
📐 Module 14 / 15 · 1 tuần

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.

Best PracticesCode ReviewMaintainabilityAI
📌 Vì sao module này quan trọng

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ó E2ENê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ánMọ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ềnLogic tính toán (thuế, giảm giá, phí ship) → unit test + API test
Luồng đã từng gây sự cố productionMa 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ấyTrạ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ậtHợ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ấtBiể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 để failTest kiểm chứng một hành vi; fail là biết ngay cái gì hỏng
Độc lậpChạ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ấyAssert 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 địnhKhô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
NhanhChuẩn bị bằng API; phần lớn test dưới 10-15 giây
Fail dễ hiểuThô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-patternThay bằngModule
1page.waitForTimeout(n)Chờ điều kiện: web-first assertion, waitForResponse, expect.poll4
2expect(await locator.isVisible()).toBe(true)await expect(locator).toBeVisible()4
3Quên awaitLint no-floating-promises1, 2
4XPath, class CSS sinh tự động, nth() tuỳ tiệngetByRole/getByLabel, filter, test id3
5waitForLoadState('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 teststorageState + setup project7
8Chuẩn bị dữ liệu qua giao diệnAPI + fixture8
9Phụ thuộc dữ liệu có sẵn dùng chungMỗi test tự tạo dữ liệu duy nhất8
10Test phụ thuộc thứ tự; biến let dùng chungFixture; test độc lập5, 8
11beforeEach khổng lồ, BaseTest kế thừaFixture5
12Page object bọc từng thao tác; BasePage khổng lồPOM mỏng + component6
13Test "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ủ đích14
14Logic đ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 định8
15Mock backend của chính mình trong luồng chínhBackend thật; mock chỉ cho bên thứ ba và trạng thái biên9
16Tăng retry/timeout để hết đỏTìm nguyên nhân gốc11
17test.skip không lý do, sống mãiLý do + ticket + hạn; hoặc xoá10
18Test không có assertion ("chạy không lỗi là được")Khẳng định kết quả người dùng thấy4
19Dùng page.evaluate để bấm/điền thay thao tác thậtThao tác như người dùng12
20Bí mật, mật khẩu trong code; commit file authBiến môi trường, kho bí mật, .gitignore7, 13
💡 Về anti-pattern số 14

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ómCâ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ểuTê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?
LocatorCó dùng locator hướng người dùng? Có nth/CSS/XPath nào thiếu lý do?
Chờ và assertMọ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ệuTest 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ậpChạy một mình được? Song song được? Có biến dùng chung cấp file?
Cấu trúcDù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ệ sinhCòn test.only, page.pause(), console.log, bí mật? skip có lý do và ticket?
Khi failThô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ếtHà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 flakyMức độ nhiễuQuy 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ầmRà soát định kỳ: sửa hoặc xoá
Lỗi lọt ra production ở luồng có test E2ETest có kiểm tra đúng thứ khôngPhân tích sau sự cố → bổ sung/sửa test
Lỗi thật bộ test bắt được trước khi mergeGiá trị bộ test tạo raNế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/POMCả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ôngQuy 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ùngHữu ích choCầ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ỗiHay 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ậtAgent 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ấpTă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 flakyKiể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

Viết bộ quy ước và kiểm toán bộ test

(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

✅ 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