TestDriver Assert (kiểm tra màn hình)
Hướng dẫn dùng testdriver.assert() để AI xác minh trạng thái màn hình bằng câu mô tả tự nhiên.
Lập trìnhTrung cấp★ 239⑂ 35Điểm AI 6/10Cập nhật lần cuối: 16 thg 8, 2026
Làm được gì
Đây là tài liệu tham chiếu giúp Claude dùng đúng phương thức assert() của TestDriver.
- Cú pháp và tham số để kiểm tra màn hình bằng ngôn ngữ tự nhiên, ví dụ
await testdriver.assert('trang đăng nhập đang hiển thị'), kèm tùy chọn AI (temperature,top.p,top.k). - Nguyên tắc viết câu assert đáng tin cậy: càng cụ thể càng ổn định, kiểm tra trạng thái trước và sau hành động.
- Mẫu hàm polling
waitForAssertionđể chờ điều kiện thành đúng, và ví dụ tích hợp với vitest.
Phù hợp với ai
- QA/dev viết test E2E cho web hoặc ứng dụng desktop bằng TestDriver
- Nhóm bị test flaky do selector thay đổi, muốn kiểm tra theo ngữ nghĩa/hình ảnh
- Người muốn Claude Code tự sinh mã test TestDriver
Ví dụ sử dụng
- Kiểm tra form: sau khi submit form trống,
assert('email field shows required error')để xác nhận thông báo lỗi. - Chuyển trang: sau khi bấm đăng nhập, dùng
waitForAssertion(testdriver, 'user dashboard is displayed', 10000)để chờ dashboard. - Luồng nhiều bước: mỗi bước xác minh
assert('step 2 is active')vàassert('step 1 is completed').
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/testdriverai/testdriverai/HEAD/ai/skills/testdriver-assert/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục ai/skills/testdriver-assert từ repo GitHub testdriverai/testdriverai vào ~/.claude/skills/testdriver-assert/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/testdriverai/testdriverai.git /tmp/testdriverai && mkdir -p ~/.claude/skills/testdriver-assert && cp -r /tmp/testdriverai/ai/skills/testdriver-assert/* ~/.claude/skills/testdriver-assert/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal.
- Tải mã nguồn:
git clone https://github.com/testdriverai/testdriverai.git /tmp/testdriverai - Tạo thư mục skill:
mkdir -p ~/.claude/skills/testdriver-assert - Sao chép file:
cp -r /tmp/testdriverai/ai/skills/testdriver-assert/* ~/.claude/skills/testdriver-assert/ - Cài SDK trong project:
npm i testdriverai - Đặt biến môi trường
TD_API_KEYbằng API key của TestDriver. - Khởi động lại Claude Code và yêu cầu: "Viết test luồng đăng nhập bằng testdriver.assert".