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

Khả năng

Một khả năng (capability) là định nghĩa cho giao diện từ xa. Nó giúp WebdriverIO hiểu được môi trường trình duyệt hoặc di động mà bạn muốn chạy các bài kiểm thử của mình. Khả năng ít quan trọng hơn khi phát triển các bài kiểm thử cục bộ vì bạn thường chạy chúng trên một giao diện từ xa hầu hết thời gian, nhưng trở nên quan trọng hơn khi chạy một bộ lớn các bài kiểm thử tích hợp trong CI/CD.

thông tin

Format của đối tượng capability được định nghĩa rõ ràng bởi đặc tả WebDriver. Trình chạy kiểm thử WebdriverIO sẽ thất bại sớm nếu người dùng định nghĩa capabilities không tuân thủ đặc tả đó.

Các Capabilities Tùy chỉnh​

Mặc dù số lượng capabilities cố định được xác định rất thấp, mọi người đều có thể cung cấp và chấp nhận các capabilities tùy chỉnh dành riêng cho trình điều khiển tự động hoặc giao diện từ xa:

Các Phần Mở rộng Capability Dành riêng cho Trình duyệt​

  • goog:chromeOptions: Phần mở rộng Chromedriver, chỉ áp dụng cho kiểm thử trong Chrome
  • moz:firefoxOptions: Phần mở rộng Geckodriver, chỉ áp dụng cho kiểm thử trong Firefox
  • ms:edgeOptions: EdgeOptions để chỉ định môi trường khi sử dụng EdgeDriver để kiểm thử Chromium Edge

Các Phần Mở rộng Capability của Nhà cung cấp Đám mây​

Các Phần Mở rộng Capability của Công cụ Tự động hóa​

Các Capabilities của WebdriverIO để quản lý tùy chọn trình điều khiển trình duyệt​

WebdriverIO quản lý việc cài đặt và chạy trình điều khiển trình duyệt cho bạn. WebdriverIO sử dụng một capability tùy chỉnh cho phép bạn truyền các tham số vào trình điều khiển.

wdio:chromedriverOptions​

Các tùy chọn cụ thể được truyền vào Chromedriver khi khởi động.

wdio:geckodriverOptions​

Các tùy chọn cụ thể được truyền vào Geckodriver khi khởi động.

wdio:edgedriverOptions​

Các tùy chọn cụ thể được truyền vào Edgedriver khi khởi động.

wdio:safaridriverOptions​

Các tùy chọn cụ thể được truyền vào Safari khi khởi động.

wdio:maxInstances​

Số lượng tối đa của tổng số worker chạy song song cho trình duyệt/capability cụ thể. Có độ ưu tiên cao hơn maxInstances và maxInstancesPerCapability.

Kiểu: number

wdio:specs​

Xác định specs cho việc thực thi kiểm thử cho trình duyệt/capability đó. Giống như tùy chọn cấu hình specs thông thường, nhưng dành riêng cho trình duyệt/capability. Có độ ưu tiên cao hơn specs.

Kiểu: (String | String[])[]

wdio:exclude​

Loại trừ specs khỏi việc thực thi kiểm thử cho trình duyệt/capability đó. Giống như tùy chọn cấu hình exclude thông thường, nhưng dành riêng cho trình duyệt/capability. Có độ ưu tiên cao hơn exclude.

Kiểu: String[]

wdio:enforceWebDriverClassic​

Mặc định, WebdriverIO cố gắng thiết lập một phiên WebDriver Bidi. Nếu bạn không thích điều đó, bạn có thể đặt cờ này để vô hiệu hóa hành vi này.

Kiểu: boolean

Các Tùy chọn Driver Phổ biến​

Mặc dù tất cả các driver đều cung cấp các tham số cấu hình khác nhau, có một số tham số phổ biến mà WebdriverIO hiểu và sử dụng để thiết lập driver hoặc trình duyệt của bạn:

cacheDir​

Đường dẫn đến thư mục gốc của bộ nhớ cache. Thư mục này được sử dụng để lưu trữ tất cả các driver được tải xuống khi cố gắng bắt đầu một phiên.

Kiểu: string
Mặc định: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

binary​

Đường dẫn đến một binary driver tùy chỉnh. Nếu được đặt, WebdriverIO sẽ không cố gắng tải xuống driver mà sẽ sử dụng driver được cung cấp bởi đường dẫn này. Hãy đảm bảo driver tương thích với trình duyệt bạn đang sử dụng.

Bạn có thể cung cấp đường dẫn này thông qua các biến môi trường CHROMEDRIVER_PATH, GECKODRIVER_PATH hoặc EDGEDRIVER_PATH.

Kiểu: string

thận trọng

Nếu binary của driver được đặt, WebdriverIO sẽ không cố gắng tải xuống driver mà sẽ sử dụng driver được cung cấp bởi đường dẫn này. Hãy đảm bảo driver tương thích với trình duyệt bạn đang sử dụng.

Các Tùy chọn Driver Dành riêng cho Trình duyệt​

Để truyền các tùy chọn đến driver, bạn có thể sử dụng các capabilities tùy chỉnh sau:

  • Chrome hoặc Chromium: wdio:chromedriverOptions
  • Firefox: wdio:geckodriverOptions
  • Microsoft Edge: wdio:edgedriverOptions
  • Safari: wdio:safaridriverOptions
adbPort​

Cổng mà driver ADB nên chạy.

Ví dụ: 9515

Kiểu: number

urlBase​

Tiền tố đường dẫn URL cơ sở cho các lệnh, ví dụ: wd/url.

Ví dụ: /

Kiểu: string

logPath​

Ghi nhật ký máy chủ vào tệp thay vì stderr, tăng mức nhật ký lên INFO

Kiểu: string

logLevel​

Đặt mức nhật ký. Các tùy chọn có thể là ALL, DEBUG, INFO, WARNING, SEVERE, OFF.

Kiểu: string

verbose​

Ghi nhật ký chi tiết (tương đương với --log-level=ALL)

Kiểu: boolean

silent​

Không ghi nhật ký (tương đương với --log-level=OFF)

Kiểu: boolean

appendLog​

Thêm vào tệp nhật ký thay vì viết lại.

Kiểu: boolean

replayable​

Ghi nhật ký chi tiết và không cắt ngắn chuỗi dài để nhật ký có thể được phát lại (thử nghiệm).

Kiểu: boolean

readableTimestamp​

Thêm dấu thời gian dễ đọc vào nhật ký.

Kiểu: boolean

enableChromeLogs​

Hiển thị nhật ký từ trình duyệt (ghi đè các tùy chọn ghi nhật ký khác).

Kiểu: boolean

bidiMapperPath​

Đường dẫn bộ ánh xạ bidi tùy chỉnh.

Kiểu: string

allowedIps​

Danh sách cho phép các địa chỉ IP từ xa được phép kết nối với EdgeDriver, phân cách bằng dấu phẩy.

Kiểu: string[]
Mặc định: ['']

allowedOrigins​

Danh sách cho phép các nguồn gốc yêu cầu được phép kết nối với EdgeDriver, phân cách bằng dấu phẩy. Sử dụng * để cho phép bất kỳ nguồn gốc máy chủ nào là nguy hiểm!

Kiểu: string[]
Mặc định: ['*']

spawnOpts​

Các tùy chọn được truyền vào quá trình driver.

Kiểu: SpawnOptionsWithoutStdio | SpawnOptionsWithStdioTuple<StdioOption, StdioOption, StdioOption>
Mặc định: undefined

Các Capabilities Đặc biệt cho Các Trường hợp Sử dụng Cụ thể​

Đây là danh sách các ví dụ cho thấy những capabilities nào cần được áp dụng để đạt được một trường hợp sử dụng nhất định.

Chạy Trình duyệt Headless​

Chạy trình duyệt headless có nghĩa là chạy một phiên bản trình duyệt mà không có cửa sổ hoặc giao diện người dùng. Điều này chủ yếu được sử dụng trong môi trường CI/CD nơi không có màn hình hiển thị. Để chạy trình duyệt ở chế độ headless, hãy áp dụng các capabilities sau:

{
    browserName: 'chrome',   // hoặc 'chromium'
    'goog:chromeOptions': {
        args: ['headless', 'disable-gpu']
    }
}

Tự động hóa Các Kênh Trình duyệt Khác nhau​

Nếu bạn muốn kiểm thử phiên bản trình duyệt chưa được phát hành ở dạng ổn định, ví dụ: Chrome Canary, bạn có thể làm điều đó bằng cách thiết lập capabilities và trỏ đến trình duyệt bạn muốn khởi động, ví dụ:

Khi kiểm thử trên Chrome, WebdriverIO sẽ tự động tải xuống phiên bản trình duyệt và driver mong muốn cho bạn dựa trên browserVersion được xác định, ví dụ:

{
    browserName: 'chrome', // hoặc 'chromium'
    browserVersion: '116' // hoặc '116.0.5845.96', 'stable', 'dev', 'canary', 'beta' hoặc 'latest' (giống như 'canary')
}

Nếu bạn muốn kiểm thử trình duyệt đã tải xuống thủ công, bạn có thể cung cấp đường dẫn binary đến trình duyệt qua:

{
    browserName: 'chrome',  // hoặc 'chromium'
    'goog:chromeOptions': {
        binary: '/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary'
    }
}

Ngoài ra, nếu bạn muốn sử dụng driver đã tải xuống thủ công, bạn có thể cung cấp đường dẫn binary đến driver qua:

{
    browserName: 'chrome', // hoặc 'chromium'
    'wdio:chromedriverOptions': {
        binary: '/path/to/chromdriver'
    }
}

Mở rộng Capabilities Tùy chỉnh​

Nếu bạn muốn định nghĩa bộ capabilities riêng của mình để ví dụ: lưu trữ dữ liệu tùy ý để sử dụng trong các bài kiểm thử cho capability cụ thể đó, bạn có thể làm như vậy bằng cách thiết lập:

export const config = {
    // ...
    capabilities: [{
        browserName: 'chrome',
        'custom:caps': {
            // cấu hình tùy chỉnh
        }
    }]
}

Bạn nên tuân theo giao thức W3C khi đặt tên capability, cần có ký tự : (dấu hai chấm), biểu thị không gian tên cụ thể cho việc triển khai. Trong các bài kiểm thử của bạn, bạn có thể truy cập capability tùy chỉnh của mình qua:

browser.capabilities['custom:caps']

Để đảm bảo tính an toàn về kiểu, bạn có thể mở rộng giao diện capability của WebdriverIO qua:

declare global {
    namespace WebdriverIO {
        interface Capabilities {
            'custom:caps': {
                // ...
            }
        }
    }
}

Welcome! How can I help?

WebdriverIO AI Copilot