Playwright + TypeScript Thực chiến
Trang chủ / Module 15
🏆 Module 15 / 15 · 4-5 tuần

Dự án Capstone — Framework E2E cho một sản phẩm thật

Xây một bộ test Playwright + TypeScript production-ready từ đầu đến cuối: kiến trúc, 60+ test nhiều tầng, CI có sharding, báo cáo, và tài liệu đủ để trình bày khi phỏng vấn.

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

Nhà tuyển dụng vị trí Senior QA/SDET đã xem rất nhiều repo "Playwright framework" gồm một page object và ba test đăng nhập trên trang demo. Thứ họ hiếm khi thấy — và là thứ phân biệt cấp độ senior — là một bộ test thể hiện quyết định có lý do: vì sao test này ở tầng E2E, dữ liệu được cô lập ra sao, flaky được xử lý thế nào, pipeline mất bao lâu và vì sao. Capstone này được thiết kế để tạo ra đúng bằng chứng đó, và cũng là thứ bạn có thể mang về áp dụng ngay cho sản phẩm của công ty.

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

  • Thiết kế và xây một framework E2E hoàn chỉnh cho một ứng dụng có độ phức tạp thật
  • Áp dụng đầy đủ: fixture, POM, auth, dữ liệu qua API, mock, song song, CI
  • Chứng minh độ ổn định và tốc độ bằng số liệu
  • Viết tài liệu và chuẩn bị trình bày các quyết định thiết kế

Chọn ứng dụng mục tiêu

Lựa chọnƯuLưu ý
Sản phẩm của công ty bạn (môi trường staging)Giá trị thật, vấn đề thật, áp dụng được ngayKhông công khai được code — chuẩn bị một bản trình bày đã ẩn thông tin nhạy cảm
Ứng dụng mã nguồn mở tự chạy bằng Docker (một hệ e-commerce, quản lý dự án, hoặc CMS)Đủ phức tạp; có API; bạn kiểm soát môi trường và dữ liệu; công khai đượcTốn công dựng môi trường — nhưng đó cũng là một phần kỹ năng
Ứng dụng bạn tự viếtToàn quyền thêm test id, endpoint hỗ trợ testDễ quá đơn giản; đảm bảo có đủ các yếu tố bên dưới

Ứng dụng nên có tối thiểu: đăng nhập với ít nhất hai vai trò; một luồng nhiều bước có trạng thái (đặt hàng, phê duyệt); dữ liệu dạng danh sách có lọc/sắp xếp/phân trang; một REST API gọi được; một tích hợp bên ngoài để mock (thanh toán, email); và tải lên hoặc tải xuống file. Tránh các trang demo công khai dùng chung: bạn không kiểm soát được dữ liệu nên không thực hành được phần cô lập.

Yêu cầu bắt buộc

Hạng mụcYêu cầu tối thiểuModule
Nền móngTypeScript strict; tsc --noEmit và ESLint (có no-floating-promises và plugin Playwright) chạy trong CI và pre-commit; cấu trúc thư mục rõ ràng; biến môi trường được xác thực1, 2
Locator & assertion≥ 80% locator hướng người dùng; không sleep; không assertion tức thời; có ít nhất một custom matcher3, 4
FixtureFixture cho page object, API client, dữ liệu có teardown; ít nhất một fixture worker-scoped và một fixture auto; ghép bằng mergeTests5
POMPage object mỏng cho các trang chính; ít nhất 3 component object dùng lại6
Xác thựcSetup project + storageState; ≥ 2 vai trò; đăng nhập qua API; một test hai context; bộ test riêng cho trang đăng nhập7
Dữ liệuMọi test tự tạo dữ liệu qua API với định danh duy nhất; có dọn dẹp; không phụ thuộc dữ liệu có sẵn8
NetworkTest cho ≥ 4 trạng thái lỗi/biên bằng mock; mock một bên thứ ba; ≥ 15 API test trong project riêng9
Cấu hìnhfullyParallel; projects cho setup, api, chromium, một trình duyệt khác và di động (tập gắn tag); tag và ba tầng chạy10
Độ ổn địnhToàn bộ pass 10 lần liên tiếp với --workers=4, retry tắt; có chính sách flaky thành văn11
Phi chức năng≥ 6 visual test (baseline trong Docker); ARIA snapshot; quét axe trên ≥ 4 trang; ≥ 2 test bàn phím; một test tải lên và một test tải xuống12
CIWorkflow có sharding, gộp báo cáo, lưu artifact; PR nhận phản hồi dưới 10 phút; thông báo khi fail13
Quy ướcCONTRIBUTING.md; checklist review; mọi skip có lý do14

Quy mô gợi ý: 60-100 test, trong đó khoảng 15-25 API test, 35-60 E2E, 6-10 visual, và một tập smoke 8-12 test chạy dưới 2 phút. Chất lượng quan trọng hơn số lượng — 60 test được thiết kế kỹ thuyết phục hơn 300 test sinh hàng loạt.

Tuỳ chọn nâng cao (chọn 1-2): môi trường tạm thời cho mỗi lần chạy bằng Docker Compose; reporter tuỳ biến đẩy số liệu lên dashboard; contract test bằng schema dùng chung; job phát hiện flaky tự động từ lịch sử chạy; test hiệu năng cơ bản (đo Web Vitals qua Playwright); file hướng dẫn cho trợ lý AI kèm đánh giá chất lượng test nó sinh ra.

Lộ trình 5 tuần

TuầnViệcSản phẩm
1Dựng môi trường ứng dụng; khởi tạo dự án, lint, CI tối thiểu (lint + 1 test). Viết kế hoạch test một trang: các hành trình quan trọng, cái gì ở tầng nào, rủi ro chính. Viết lớp API client và factoryRepo chạy được trên CI + kế hoạch test
2Xác thực (setup project, vai trò). Fixture nền tảng. Page object cho 3-4 trang chính. 15 E2E đầu tiên cho hành trình sống còn + 15 API testTập smoke xanh, chạy song song
3Mở rộng E2E; test trạng thái lỗi/biên bằng mock; component object; tài khoản theo worker; bật fullyParallel và sửa mọi xung đột45+ test, pass ổn định khi song song
4Visual, ARIA snapshot, accessibility, di động, file. Sharding và gộp báo cáo. Chạy lặp để săn flaky và sửa tận gốcPipeline đầy đủ dưới 10 phút; 10 lần chạy xanh liên tiếp
5Hạng mục nâng cao. Tài liệu. Số liệu. Quay video demo. Tự review theo checklist Module 14 và sửaRepo hoàn chỉnh, sẵn sàng trình bày
💡 CI từ ngày đầu tiên

Đưa pipeline lên ngay tuần 1, khi mới có một test. Mọi vấn đề về môi trường, song song, dữ liệu sẽ lộ ra sớm và từng cái một — thay vì dồn lại thành một đống khi bạn đưa 80 test lên CI lần đầu ở tuần 4.

Số liệu cần có

Một dự án senior được trình bày bằng số liệu, không bằng tính từ. Thu thập và đưa vào README:

Số liệuCách đo
Số test theo tầng (API / E2E / visual / smoke)npx playwright test --list theo project và tag
Thời gian chạy: cục bộ, CI một máy, CI có shardingLog pipeline; nêu rõ số worker và shard
Thời gian tuần tự so với song songChạy với --workers=1 và cấu hình thật
Độ ổn định: tỉ lệ pass qua N lần chạy liên tiếp, retry tắtJob lặp trên CI
Tác động của các tối ưu chínhTrước/sau: đăng nhập qua UI → storageState → API; chuẩn bị dữ liệu qua UI → API
Phân bố locator theo mức ưu tiênScript đếm hoặc thống kê thủ công
Lỗi thật bộ test tìm được trong ứng dụngDanh sách kèm trace — bằng chứng giá trị mạnh nhất
Vi phạm accessibility: hiện trạng và sau khi sửa (nếu sửa được)Kết quả axe

Tài liệu và trình bày

Repo nên có:

  • README: ứng dụng được test, cách chạy bằng một lệnh, sơ đồ kiến trúc bộ test, bảng số liệu chính, ảnh báo cáo HTML và một trace.
  • docs/STRATEGY.md: kế hoạch test — hành trình nào được phủ, cái gì cố ý không test ở tầng E2E và vì sao.
  • docs/ARCHITECTURE.md: các quyết định thiết kế theo mẫu "bối cảnh → phương án cân nhắc → lựa chọn → đánh đổi": cấu trúc fixture, chiến lược dữ liệu, chiến lược xác thực, cái gì mock.
  • CONTRIBUTING.md: quy ước và checklist review.
  • docs/FLAKY.md: nhật ký các flaky đã gặp — triệu chứng, nguyên nhân gốc, cách sửa. Tài liệu này thể hiện kỹ năng chẩn đoán rõ hơn bất kỳ thứ gì khác.

Câu hỏi phỏng vấn nên chuẩn bị, mỗi câu kèm một ví dụ cụ thể từ dự án:

  • Vì sao chọn Playwright? Nó khác gì công cụ bạn dùng trước đây ở mức kiến trúc?
  • Bạn quyết định một kiểm tra nằm ở tầng E2E hay API bằng cách nào? Cho ví dụ một test bạn đã chuyển tầng.
  • Các test của bạn chạy song song an toàn nhờ đâu? Điều gì xảy ra nếu hai worker cùng đặt một đơn hàng?
  • Kể về flaky test khó nhất bạn đã sửa: triệu chứng, cách tìm nguyên nhân, cách sửa.
  • Fixture giải quyết vấn đề gì mà beforeEach và lớp base không giải quyết được?
  • Pipeline mất bao lâu? Nếu bộ test lớn gấp 10 lần, bạn làm gì để giữ thời gian phản hồi?
  • Bạn mock những gì, không mock những gì, và làm sao để mock không lệch khỏi API thật?
  • Nếu một lập trình viên nói "E2E toàn flaky, bỏ đi", bạn trả lời thế nào — bằng số liệu?

Khoá Career Positioning & Job Search hướng dẫn cách đưa capstone vào CV và kể thành câu chuyện phỏng vấn; khoá Advanced QA & Test Engineering bổ sung phần chiến lược (contract test, mutation test, chỉ số chất lượng) để hoàn thiện hồ sơ Senior QA/SDET.

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

Nộp bài capstone

Hoàn thành dự án theo yêu cầu bắt buộc. Trước khi coi là xong, tự kiểm tra bằng bốn phép thử: (1) một người lạ clone repo, làm theo README, và chạy được toàn bộ bộ test trong dưới 15 phút; (2) pipeline xanh 10 lần liên tiếp với retry tắt; (3) nhờ một đồng nghiệp review 5 file test bất kỳ bằng checklist Module 14 và sửa mọi điểm họ nêu; (4) bạn trả lời được tám câu hỏi phỏng vấn ở trên, mỗi câu trỏ tới một đoạn code hoặc một con số cụ thể trong repo.

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

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

  • Đáp ứng đủ mười hai hạng mục yêu cầu bắt buộc
  • Pipeline xanh 10 lần liên tiếp với retry tắt, phản hồi PR dưới 10 phút
  • README có bảng số liệu; có STRATEGY, ARCHITECTURE, CONTRIBUTING và nhật ký flaky
  • Người lạ chạy được bộ test chỉ bằng README
  • Trả lời được tám câu hỏi phỏng vấn bằng ví dụ cụ thể từ dự án