Chuyển đến nội dung chính

Bắt đầu

Chào mừng bạn đến với tài liệu WebdriverIO. Nó sẽ giúp bạn bắt đầu nhanh chóng. Nếu bạn gặp sự cố, bạn có thể tìm kiếm trợ giúp và câu trả lời trên Máy chủ Hỗ trợ Discord của chúng tôi hoặc bạn có thể liên hệ với tôi qua Twitter.

thông tin

Đây là tài liệu cho phiên bản mới nhất (>=9.x) của WebdriverIO. Nếu bạn vẫn đang sử dụng phiên bản cũ hơn, vui lòng truy cập các trang web tài liệu cũ!

Kênh YouTube Chính thức 🎥

Bạn có thể tìm thấy nhiều video về WebdriverIO trên kênh YouTube chính thức. Hãy đảm bảo bạn đăng ký!

Khởi tạo một Cài đặt WebdriverIO

Để thêm cài đặt WebdriverIO đầy đủ vào một dự án hiện có hoặc mới bằng cách sử dụng WebdriverIO Starter Toolkit, hãy chạy:

Nếu bạn đang ở thư mục gốc của một dự án hiện có, hãy chạy:

npm init wdio@latest .

hoặc nếu bạn muốn tạo một dự án mới:

npm init wdio@latest ./path/to/new/project

Lệnh này sẽ tải xuống công cụ CLI WebdriverIO và chạy một trình hướng dẫn cấu hình giúp bạn cấu hình bộ kiểm thử của mình.

Trình hướng dẫn sẽ hiển thị một loạt câu hỏi hướng dẫn bạn qua quá trình thiết lập. Bạn có thể truyền tham số --yes để chọn thiết lập mặc định sử dụng Mocha với Chrome theo mẫu Page Object.

npm init wdio@latest . -- --yes

Cài đặt CLI theo cách thủ công

Bạn cũng có thể thêm gói CLI vào dự án của mình theo cách thủ công thông qua:

npm i --save-dev @wdio/cli
npx wdio --version # in ra ví dụ: `8.13.10`

# chạy trình hướng dẫn cấu hình
npx wdio config

Chạy Kiểm thử

Bạn có thể bắt đầu bộ kiểm thử bằng cách sử dụng lệnh run và trỏ đến cấu hình WebdriverIO mà bạn vừa tạo:

npx wdio run ./wdio.conf.js

Nếu bạn muốn chạy các tệp kiểm thử cụ thể, bạn có thể thêm tham số --spec:

npx wdio run ./wdio.conf.js --spec example.e2e.js

hoặc định nghĩa các bộ kiểm thử trong tệp cấu hình của bạn và chỉ chạy các tệp kiểm thử được định nghĩa trong một bộ:

npx wdio run ./wdio.conf.js --suite exampleSuiteName

Chạy trong một script

Nếu bạn muốn sử dụng WebdriverIO như một công cụ tự động hóa ở Chế độ Độc lập trong một script Node.JS, bạn cũng có thể cài đặt WebdriverIO trực tiếp và sử dụng nó như một gói, ví dụ để tạo ảnh chụp màn hình của một trang web:

getting-started/run-in-script.js
loading...

Lưu ý: tất cả các lệnh WebdriverIO đều bất đồng bộ và cần được xử lý đúng cách bằng async/await.

Ghi lại các bài kiểm thử

WebdriverIO cung cấp các công cụ để giúp bạn bắt đầu bằng cách ghi lại các hành động kiểm thử trên màn hình và tự động tạo các script kiểm thử WebdriverIO. Xem Ghi lại bài kiểm thử với Chrome DevTools Recorder để biết thêm thông tin.

Yêu cầu Hệ thống

Bạn sẽ cần cài đặt Node.js.

  • Cài đặt ít nhất v18.20.0 trở lên vì đây là phiên bản LTS hoạt động cũ nhất
  • Chỉ các phiên bản hiện tại là LTS hoặc sẽ trở thành phiên bản LTS mới được hỗ trợ chính thức

Nếu Node hiện không được cài đặt trên hệ thống của bạn, chúng tôi đề xuất sử dụng công cụ như NVM hoặc Volta để hỗ trợ quản lý nhiều phiên bản Node.js hoạt động. NVM là một lựa chọn phổ biến, trong khi Volta cũng là một lựa chọn tốt.

Welcome! How can I help?

WebdriverIO AI Copilot