🎭 AI Agent + Playwright CLI: Tự Động Hóa Toàn Diện Kiểm Thử E2E
Playwright Agent CLI (playwright-cli) là công cụ dòng lệnh được Microsoft thiết kế chuyên biệt cho các AI Coding Agents (như Claude Code, Cursor, Copilot, Antigravity) để tương tác trực tiếp với trình duyệt một cách nhanh chóng và tối ưu hóa token vượt trội.
1. Các Khái Niệm Cốt Lõi (Core Concepts)
- Daemon Architecture: Khởi chạy một tiến trình trình duyệt chạy ngầm (persistent daemon). Phiên làm việc không bị tắt giữa các câu lệnh, giúp giữ nguyên trạng thái trang, cookies và local storage.
- Accessibility Snapshots & Ref IDs: Thay vì gửi toàn bộ mã HTML DOM khổng lồ (vốn ngốn hàng chục ngàn token của LLM),
playwright-clixuất ra cây Accessibility Tree cô đọng kèm các mã tham chiếu ngắn gọn nhưe1,e2,e3. - Token Efficiency: Tiết kiệm từ 80% – 90% lượng token so với việc nạp HTML DOM thô hay dùng các giao thức cồng kềnh.
2. Quick Start: Thao Tác Trình Duyệt Từng Bước
Lấy cảm hứng từ tài liệu chính thức của Playwright, bạn (hoặc AI Agent) có thể điều khiển trình duyệt qua terminal theo luồng sau:
1. Mở trang web
playwright-cli open https://demo.playwright.dev/todomvc/ --headed
Trình duyệt mở ra và duy trì phiên làm việc ngầm, sẵn sàng nhận các lệnh kế tiếp.
2. Tương tác nhập liệu
playwright-cli type "Buy groceries"
playwright-cli press Enter
3. Tương tác theo Snapshot Ref ID
Sau mỗi thao tác, CLI tự động xuất cây Accessibility Snapshot với các Ref ID. Ví dụ checkbox hoàn thành việc có mã e21:
# Đánh dấu checkbox hoàn thành công việc
playwright-cli check e21
4. Chụp ảnh màn hình kiểm chứng
playwright-cli screenshot
5. Đóng phiên làm việc
playwright-cli close
3. Cách Sử Dụng Với AI Agent
Bạn chỉ cần đưa yêu cầu kiểm thử cho AI Agent (như Claude Code hay Cursor) kèm kịch bản:
Hãy sử dụng skill /playwright-cli để xác minh tự động kịch bản E-Commerce Checkout Flow:
1. Mở trang sản phẩm tai nghe, kiểm tra còn hàng và bấm Add to Cart.
2. Kiểm tra drawer giỏ hàng hiển thị đúng tên và giá $99.00, bấm Checkout.
3. Điền thông tin giao hàng và chọn Standard Shipping.
4. Chọn Cash on Delivery (COD) và bấm Complete Order.
5. Kiểm tra chuyển hướng sang /order/confirmed, chụp screenshot và đóng trình duyệt.
AI Agent sẽ tự động chạy chuỗi lệnh tương ứng mà không cần bạn can thiệp:
playwright-cli open https://shop.example.com/products/headphones
playwright-cli snapshot
playwright-cli click e4 # Nút "Add to Cart"
playwright-cli click e7 # Nút "Proceed to Checkout"
playwright-cli fill e10 "customer@example.com"
playwright-cli click e14 # Chọn "Standard Shipping"
playwright-cli click e21 # Chọn COD
playwright-cli click e22 # Nút "Complete Order"
playwright-cli screenshot order-success.png
playwright-cli close
4. Cheat Sheet Các Lệnh Thường Dùng
| Lệnh | Mô tả | Ví dụ |
|---|---|---|
open <url> |
Mở trang web (tùy chọn --headed) |
playwright-cli open https://example.com |
snapshot |
Lấy cây accessibility và các ref ID | playwright-cli snapshot |
click <ref> |
Click vào phần tử theo ID hoặc text | playwright-cli click e3 |
fill <ref> <text> |
Điền text vào input | playwright-cli fill e1 "text" |
type <text> |
Gõ phím vào ô đang focus | playwright-cli type "hello" |
check <ref> |
Đánh dấu checkbox/radio | playwright-cli check e21 |
press <key> |
Nhấn phím bàn phím | playwright-cli press Enter |
screenshot |
Chụp ảnh màn hình | playwright-cli screenshot |
close |
Đóng phiên trình duyệt | playwright-cli close |
Tóm lại
playwright-cli mang lại cách tiếp cận tinh gọn, siêu nhẹ và bảo toàn ngữ cảnh cho AI Agent khi duyệt web. Đây là giải pháp hoàn hảo để tự động hóa kiểm thử E2E mà không lo tốn token hay gián đoạn phiên làm việc. 🚀
