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

Cấu hình

Dựa trên loại thiết lập (ví dụ: sử dụng các ràng buộc giao thức raw, WebdriverIO như gói độc lập hoặc trình chạy kiểm thử WDIO), có một tập hợp các tùy chọn khác nhau để điều khiển môi trường.

Tùy chọn WebDriver​

Các tùy chọn sau được định nghĩa khi sử dụng gói giao thức webdriver:

protocol​

Giao thức để sử dụng khi giao tiếp với máy chủ trình điều khiển.

Loại: String
Mặc định: http

hostname​

Host của máy chủ trình điều khiển.

Loại: String
Mặc định: 0.0.0.0

port​

Cổng mà máy chủ trình điều khiển đang sử dụng.

Loại: Number
Mặc định: undefined

path​

Đường dẫn đến điểm cuối máy chủ trình điều khiển.

Loại: String
Mặc định: /

queryParams​

Các tham số truy vấn được truyền đến máy chủ trình điều khiển.

Loại: Object
Mặc định: undefined

user​

Tên người dùng dịch vụ đám mây của bạn (chỉ hoạt động cho tài khoản Sauce Labs, Browserstack, TestingBot hoặc LambdaTest). Nếu được thiết lập, WebdriverIO sẽ tự động thiết lập các tùy chọn kết nối cho bạn. Nếu bạn không sử dụng nhà cung cấp đám mây, tùy chọn này có thể được sử dụng để xác thực bất kỳ máy chủ WebDriver nào khác.

Loại: String
Mặc định: undefined

key​

Khóa truy cập hoặc khóa bí mật dịch vụ đám mây của bạn (chỉ hoạt động cho tài khoản Sauce Labs, Browserstack, TestingBot hoặc LambdaTest). Nếu được thiết lập, WebdriverIO sẽ tự động thiết lập các tùy chọn kết nối cho bạn. Nếu bạn không sử dụng nhà cung cấp đám mây, tùy chọn này có thể được sử dụng để xác thực bất kỳ máy chủ WebDriver nào khác.

Loại: String
Mặc định: undefined

capabilities​

Xác định các khả năng bạn muốn chạy trong phiên WebDriver của mình. Xem thêm chi tiết trong Giao thức WebDriver. Nếu bạn chạy một trình điều khiển cũ không hỗ trợ giao thức WebDriver, bạn cần sử dụng khả năng JSONWireProtocol để chạy phiên thành công.

Bên cạnh các khả năng dựa trên WebDriver, bạn có thể áp dụng các tùy chọn cụ thể cho trình duyệt và nhà cung cấp, cho phép cấu hình sâu hơn cho trình duyệt từ xa hoặc thiết bị. Những tùy chọn này được ghi trong tài liệu của nhà cung cấp tương ứng, ví dụ:

Ngoài ra, một tiện ích hữu ích là Bộ cấu hình Kiểm thử Tự động của Sauce Labs, giúp bạn tạo đối tượng này bằng cách kết hợp các khả năng mong muốn.

Loại: Object
Mặc định: null

Ví dụ:

{
    browserName: 'chrome', // các tùy chọn: `chrome`, `edge`, `firefox`, `safari`
    browserVersion: '27.0', // phiên bản trình duyệt
    platformName: 'Windows 10' // nền tảng OS
}

Nếu bạn đang chạy kiểm thử web hoặc gốc trên thiết bị di động, capabilities khác với giao thức WebDriver. Xem Tài liệu Appium để biết thêm chi tiết.

logLevel​

Mức độ chi tiết của log.

Loại: String
Mặc định: info
Tùy chọn: trace | debug | info | warn | error | silent

outputDir​

Thư mục để lưu trữ tất cả các tệp log của trình chạy kiểm thử (bao gồm log của trình báo cáo và log wdio). Nếu không được thiết lập, tất cả log sẽ được truyền đến stdout. Vì hầu hết các trình báo cáo được tạo để ghi log vào stdout, nên chỉ nên sử dụng tùy chọn này cho các trình báo cáo cụ thể, nơi việc đẩy báo cáo vào một tệp có ý nghĩa hơn (như trình báo cáo junit, chẳng hạn).

Khi chạy ở chế độ độc lập, log duy nhất được tạo bởi WebdriverIO sẽ là log wdio.

Loại: String
Mặc định: null

connectionRetryTimeout​

Thời gian chờ cho bất kỳ yêu cầu WebDriver nào đến trình điều khiển hoặc lưới.

Loại: Number
Mặc định: 120000

connectionRetryCount​

Số lần thử lại tối đa cho yêu cầu đến máy chủ Selenium.

Loại: Number
Mặc định: 3

agent​

Cho phép bạn sử dụng một http/https/http2 agent tùy chỉnh để thực hiện các yêu cầu.

Loại: Object
Mặc định:

{
    http: new http.Agent({ keepAlive: true }),
    https: new https.Agent({ keepAlive: true })
}

headers​

Chỉ định headers tùy chỉnh để truyền vào mọi yêu cầu WebDriver. Nếu Selenium Grid của bạn yêu cầu Xác thực Cơ bản, chúng tôi khuyên bạn nên truyền vào header Authorization thông qua tùy chọn này để xác thực các yêu cầu WebDriver của bạn, ví dụ:

import { Buffer } from 'buffer';
// Đọc tên người dùng và mật khẩu từ biến môi trường
const username = process.env.SELENIUM_GRID_USERNAME;
const password = process.env.SELENIUM_GRID_PASSWORD;

// Kết hợp tên người dùng và mật khẩu với dấu hai chấm ngăn cách
const credentials = `${username}:${password}`;
// Mã hóa thông tin đăng nhập bằng Base64
const encodedCredentials = Buffer.from(credentials).toString('base64');

export const config: WebdriverIO.Config = {
    // ...
    headers: {
        Authorization: `Basic ${encodedCredentials}`
    }
    // ...
}

Loại: Object
Mặc định: {}

transformRequest​

Hàm chặn tùy chọn yêu cầu HTTP trước khi yêu cầu WebDriver được thực hiện

Loại: (RequestOptions) => RequestOptions
Mặc định: không có

transformResponse​

Hàm chặn đối tượng phản hồi HTTP sau khi phản hồi WebDriver đã đến. Hàm này được truyền đối tượng phản hồi gốc là đối số đầu tiên và RequestOptions tương ứng là đối số thứ hai.

Loại: (Response, RequestOptions) => Response
Mặc định: không có

strictSSL​

Liệu có yêu cầu chứng chỉ SSL phải hợp lệ hay không. Nó có thể được thiết lập thông qua biến môi trường là STRICT_SSL hoặc strict_ssl.

Loại: Boolean
Mặc định: true

enableDirectConnect​

Liệu có bật tính năng kết nối trực tiếp của Appium hay không. Nó không làm gì nếu phản hồi không có các khóa thích hợp trong khi cờ này được bật.

Loại: Boolean
Mặc định: true

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 trình điều khiển được tải xuống khi cố gắng bắt đầu một phiên.

Loại: String
Mặc định: process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

WebdriverIO​

Các tùy chọn sau (bao gồm các tùy chọn đã liệt kê ở trên) có thể được sử dụng với WebdriverIO ở chế độ độc lập:

automationProtocol​

Xác định giao thức bạn muốn sử dụng cho tự động hóa trình duyệt. Hiện tại chỉ webdriver được hỗ trợ, vì đây là công nghệ tự động hóa trình duyệt chính mà WebdriverIO sử dụng.

Nếu bạn muốn tự động hóa trình duyệt bằng công nghệ tự động hóa khác, hãy đảm bảo bạn thiết lập thuộc tính này đến một đường dẫn giải quyết cho một module tuân thủ giao diện sau:

import type { Capabilities } from '@wdio/types';
import type { Client, AttachOptions } from 'webdriver';

export default class YourAutomationLibrary {
    /**
     * Bắt đầu một phiên tự động hóa và trả về một WebdriverIO [monad](https://github.com/webdriverio/webdriverio/blob/940cd30939864bdbdacb2e94ee6e8ada9b1cc74c/packages/wdio-utils/src/monad.ts)
     * với các lệnh tự động hóa tương ứng. Xem gói [webdriver](https://www.npmjs.com/package/webdriver)
     * làm triển khai tham khảo
     *
     * @param {Capabilities.RemoteConfig} options Tùy chọn WebdriverIO
     * @param {Function} hook cho phép sửa đổi client trước khi nó được phát hành từ hàm
     * @param {PropertyDescriptorMap} userPrototype cho phép người dùng thêm lệnh giao thức tùy chỉnh
     * @param {Function} customCommandWrapper cho phép sửa đổi lệnh thực thi
     * @returns một phiên bản client tương thích với WebdriverIO
     */
    static newSession(
        options: Capabilities.RemoteConfig,
        modifier?: (...args: any[]) => any,
        userPrototype?: PropertyDescriptorMap,
        customCommandWrapper?: (...args: any[]) => any
    ): Promise<Client>;

    /**
     * cho phép người dùng kết nối với các phiên hiện có
     * @optional
     */
    static attachToSession(
        options?: AttachOptions,
        modifier?: (...args: any[]) => any, userPrototype?: {},
        commandWrapper?: (...args: any[]) => any
    ): Client;

    /**
     * Thay đổi ID phiên và khả năng trình duyệt cho phiên mới
     * trực tiếp vào đối tượng trình duyệt được truyền vào
     *
     * @optional
     * @param   {object} instance  đối tượng chúng ta nhận được từ phiên trình duyệt mới.
     * @returns {string}           id phiên mới của trình duyệt
     */
    static reloadSession(
        instance: Client,
        newCapabilities?: WebdriverIO.Capabilitie
    ): Promise<string>;
}

Loại: String
Mặc định: webdriver

baseUrl​

Rút ngắn các lệnh url bằng cách thiết lập một URL cơ sở.

  • Nếu tham số url của bạn bắt đầu bằng /, thì baseUrl được thêm vào phía trước (ngoại trừ đường dẫn baseUrl, nếu có).
  • Nếu tham số url của bạn bắt đầu mà không có scheme hoặc / (như some/path), thì toàn bộ baseUrl được thêm vào trực tiếp phía trước.

Loại: String
Mặc định: null

waitforTimeout​

Thời gian chờ mặc định cho tất cả các lệnh waitFor*. (Lưu ý chữ f viết thường trong tên tùy chọn.) Thời gian chờ này chỉ ảnh hưởng đến các lệnh bắt đầu bằng waitFor* và thời gian chờ mặc định của chúng.

Để tăng thời gian chờ cho một bài kiểm thử, vui lòng xem tài liệu về framework.

Loại: Number
Mặc định: 5000

waitforInterval​

Khoảng thời gian mặc định cho tất cả các lệnh waitFor* để kiểm tra xem trạng thái mong đợi (ví dụ: hiển thị) đã thay đổi hay chưa.

Loại: Number
Mặc định: 100

region​

Nếu chạy trên Sauce Labs, bạn có thể chọn chạy kiểm thử giữa các trung tâm dữ liệu khác nhau: US hoặc EU. Để thay đổi khu vực của bạn sang EU, hãy thêm region: 'eu' vào cấu hình của bạn.

Lưu ý: Điều này chỉ có tác dụng nếu bạn cung cấp các tùy chọn user và key được kết nối với tài khoản Sauce Labs của bạn.

Loại: String
Mặc định: us

(chỉ cho máy ảo và/hoặc giả lập/mô phỏng)

Tùy chọn Trình chạy kiểm thử​

Các tùy chọn sau (bao gồm các tùy chọn đã liệt kê ở trên) chỉ được định nghĩa khi chạy WebdriverIO với trình chạy kiểm thử WDIO:

specs​

Xác định specs cho việc thực thi kiểm thử. Bạn có thể chỉ định một mẫu glob để phù hợp với nhiều tệp cùng một lúc hoặc bọc một glob hoặc một tập hợp đường dẫn vào một mảng để chạy chúng trong một quá trình worker duy nhất. Tất cả các đường dẫn được xem là tương đối từ đường dẫn tệp cấu hình.

Loại: (String | String[])[]
Mặc định: []

exclude​

Loại trừ specs khỏi việc thực thi kiểm thử. Tất cả các đường dẫn được xem là tương đối từ đường dẫn tệp cấu hình.

Loại: String[]
Mặc định: []

suites​

Một đối tượng mô tả các bộ kiểm thử khác nhau, mà bạn có thể chỉ định với tùy chọn --suite trên CLI wdio.

Loại: Object
Mặc định: {}

capabilities​

Giống như phần capabilities được mô tả ở trên, ngoại trừ việc có tùy chọn để chỉ định một đối tượng multiremote, hoặc nhiều phiên WebDriver trong một mảng để thực thi song song.

Bạn có thể áp dụng các khả năng cụ thể cho nhà cung cấp và trình duyệt giống như được định nghĩa ở trên.

Loại: Object|Object[]
Mặc định: [{ 'wdio:maxInstances': 5, browserName: 'firefox' }]

maxInstances​

Số lượng tối đa của tổng worker chạy song song.

Lưu ý: rằng nó có thể là một số cao tới 100, khi các bài kiểm thử được thực hiện trên một số nhà cung cấp bên ngoài như máy của Sauce Labs. Ở đó, các bài kiểm thử không được kiểm tra trên một máy duy nhất, mà là trên nhiều VM. Nếu các bài kiểm thử sẽ được chạy trên một máy phát triển cục bộ, hãy sử dụng một số hợp lý hơn, chẳng hạn như 3, 4, hoặc 5. Về cơ bản, đây là số lượng trình duyệt sẽ được khởi động đồng thời và chạy các bài kiểm thử của bạn cùng một lúc, vì vậy nó phụ thuộc vào dung lượng RAM trên máy của bạn, và có bao nhiêu ứng dụng khác đang chạy trên máy của bạn.

Bạn cũng có thể áp dụng maxInstances trong các đối tượng khả năng của mình bằng cách sử dụng khả năng wdio:maxInstances. Điều này sẽ giới hạn số lượng phiên song song cho khả năng cụ thể đó.

Loại: Number
Mặc định: 100

maxInstancesPerCapability​

Số lượng tối đa của tổng worker chạy song song cho mỗi khả năng.

Loại: Number
Mặc định: 100

injectGlobals​

Chèn các biến global của WebdriverIO (ví dụ: browser, $ và $$) vào môi trường toàn cục. Nếu bạn thiết lập thành false, bạn nên nhập từ @wdio/globals, ví dụ:

import { browser, $, $$, expect } from '@wdio/globals'

Lưu ý: WebdriverIO không xử lý việc chèn các biến global cụ thể cho framework kiểm thử.

Loại: Boolean
Mặc định: true

bail​

Nếu bạn muốn quá trình chạy kiểm thử dừng lại sau một số lượng cụ thể các bài kiểm thử thất bại, hãy sử dụng bail. (Mặc định là 0, tức là chạy tất cả các bài kiểm thử bất kể kết quả.) Lưu ý: Một bài kiểm thử trong ngữ cảnh này là tất cả các bài kiểm thử trong một tệp spec duy nhất (khi sử dụng Mocha hoặc Jasmine) hoặc tất cả các bước trong một tệp tính năng (khi sử dụng Cucumber). Nếu bạn muốn kiểm soát hành vi bail trong các bài kiểm thử của một tệp kiểm thử duy nhất, hãy xem các tùy chọn framework có sẵn.

Loại: Number
Mặc định: 0 (không bail; chạy tất cả các bài kiểm thử)

specFileRetries​

Số lần thử lại toàn bộ tệp spec khi nó thất bại toàn bộ.

Loại: Number
Mặc định: 0

specFileRetriesDelay​

Độ trễ tính bằng giây giữa các lần thử lại tệp spec

Loại: Number
Mặc định: 0

specFileRetriesDeferred​

Liệu các tệp spec được thử lại có nên được thử lại ngay lập tức hay trì hoãn đến cuối hàng đợi.

Loại: Boolean
Mặc định: true

groupLogsByTestSpec​

Chọn chế độ xem đầu ra log.

Nếu thiết lập thành false, log từ các tệp kiểm thử khác nhau sẽ được in ra theo thời gian thực. Lưu ý rằng điều này có thể dẫn đến việc trộn lẫn đầu ra log từ các tệp khác nhau khi chạy song song.

Nếu thiết lập thành true, đầu ra log sẽ được nhóm theo Test Spec và chỉ được in ra khi Test Spec hoàn thành.

Theo mặc định, nó được thiết lập thành false, vì vậy log được in ra theo thời gian thực.

Loại: Boolean
Mặc định: false

services​

Các dịch vụ đảm nhận một công việc cụ thể mà bạn không muốn quan tâm. Chúng nâng cao thiết lập kiểm thử của bạn với gần như không cần nỗ lực.

Loại: String[]|Object[]
Mặc định: []

framework​

Xác định framework kiểm thử được sử dụng bởi trình chạy kiểm thử WDIO.

Loại: String
Mặc định: mocha
Tùy chọn: mocha | jasmine

mochaOpts, jasmineOpts và cucumberOpts​

Các tùy chọn cụ thể cho framework. Xem tài liệu adapter framework để biết tùy chọn nào có sẵn. Đọc thêm về điều này trong Frameworks.

Loại: Object
Mặc định: { timeout: 10000 }

cucumberFeaturesWithLineNumbers​

Danh sách các tính năng cucumber với số dòng (khi sử dụng cucumber framework).

Loại: String[] Mặc định: []

reporters​

Danh sách các trình báo cáo để sử dụng. Một trình báo cáo có thể là một chuỗi, hoặc một mảng ['reporterName', { /* reporter options */}] trong đó phần tử đầu tiên là một chuỗi với tên trình báo cáo và phần tử thứ hai là một đối tượng với các tùy chọn trình báo cáo.

Loại: String[]|Object[]
Mặc định: []

Ví dụ:

reporters: [
    'dot',
    'spec'
    ['junit', {
        outputDir: `${__dirname}/reports`,
        otherOption: 'foobar'
    }]
]

reporterSyncInterval​

Xác định khoảng thời gian mà trình báo cáo nên kiểm tra xem chúng có được đồng bộ hóa hay không nếu chúng báo cáo log của mình một cách không đồng bộ (ví dụ: nếu log được truyền tới một nhà cung cấp bên thứ 3).

Loại: Number
Mặc định: 100 (ms)

reporterSyncTimeout​

Xác định thời gian tối đa mà các trình báo cáo có để hoàn thành việc tải lên tất cả log của họ cho đến khi một lỗi được ném ra bởi trình chạy kiểm thử.

Loại: Number
Mặc định: 5000 (ms)

execArgv​

Đối số Node để chỉ định khi khởi chạy các quá trình con.

Loại: String[]
Mặc định: null

filesToWatch​

Một danh sách các mẫu chuỗi hỗ trợ glob cho trình chạy kiểm thử để theo dõi thêm các tệp khác, ví dụ: các tệp ứng dụng, khi chạy nó với cờ --watch. Theo mặc định, trình chạy kiểm thử đã theo dõi tất cả các tệp spec.

Loại: String[]
Mặc định: []

updateSnapshots​

Đặt thành true nếu bạn muốn cập nhật snapshots của mình. Lý tưởng nhất là sử dụng như một phần của tham số CLI, ví dụ: wdio run wdio.conf.js --s.

Loại: 'new' | 'all' | 'none'
Mặc định: none nếu không được cung cấp và các bài kiểm thử chạy trong CI, new nếu không được cung cấp, nếu không thì những gì đã được cung cấp

resolveSnapshotPath​

Ghi đè đường dẫn snapshot mặc định. Ví dụ, để lưu trữ snapshots bên cạnh các tệp kiểm thử.

wdio.conf.ts
export const config: WebdriverIO.Config = {
    resolveSnapshotPath: (testPath, snapExtension) => testPath + snapExtension,
}

Loại: (testPath: string, snapExtension: string) => string
Mặc định: lưu trữ các tệp snapshot trong thư mục __snapshots__ bên cạnh tệp kiểm thử

tsConfigPath​

WDIO sử dụng tsx để biên dịch các tệp TypeScript. TSConfig của bạn được tự động phát hiện từ thư mục làm việc hiện tại nhưng bạn có thể chỉ định một đường dẫn tùy chỉnh tại đây hoặc bằng cách thiết lập biến môi trường TSX_TSCONFIG_PATH.

Xem tài liệu của tsx: https://tsx.is/dev-api/node-cli#custom-tsconfig-json-path

Loại: String
Mặc định: null

Hooks​

Trình chạy kiểm thử WDIO cho phép bạn thiết lập hooks để được kích hoạt tại thời điểm cụ thể của vòng đời kiểm thử. Điều này cho phép các hành động tùy chỉnh (ví dụ: chụp ảnh màn hình nếu một bài kiểm thử thất bại).

Mỗi hook có thông tin cụ thể về vòng đời (ví dụ: thông tin về bộ kiểm thử hoặc bài kiểm thử). Đọc thêm về tất cả các thuộc tính hook trong cấu hình ví dụ của chúng tôi.

Lưu ý: Một số hooks (onPrepare, onWorkerStart, onWorkerEnd và onComplete) được thực thi trong một quá trình khác và do đó không thể chia sẻ bất kỳ dữ liệu toàn cục nào với các hooks khác trong quá trình worker.

onPrepare​

Được thực thi một lần trước khi tất cả worker được khởi chạy.

Tham số:

  • config (object): đối tượng cấu hình WebdriverIO
  • param (object[]): danh sách chi tiết khả năng

onWorkerStart​

Được thực thi trước khi một quá trình worker được tạo ra và có thể được sử dụng để khởi tạo dịch vụ cụ thể cho worker đó cũng như sửa đổi môi trường thực thi theo cách không đồng bộ.

Tham số:

  • cid (string): id khả năng (ví dụ 0-0)
  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • specs (string[]): specs sẽ được chạy trong quá trình worker
  • args (object): đối tượng sẽ được hợp nhất với cấu hình chính sau khi worker được khởi tạo
  • execArgv (string[]): danh sách các đối số chuỗi được truyền vào quá trình worker

onWorkerEnd​

Được thực thi ngay sau khi một quá trình worker đã thoát.

Tham số:

  • cid (string): id khả năng (ví dụ 0-0)
  • exitCode (number): 0 - thành công, 1 - thất bại
  • specs (string[]): specs sẽ được chạy trong quá trình worker
  • retries (number): số lần thử lại cấp spec được sử dụng như được định nghĩa trong "Thêm thử lại trên cơ sở mỗi tệp spec"

beforeSession​

Được thực thi ngay trước khi khởi tạo phiên webdriver và framework kiểm thử. Nó cho phép bạn thao tác cấu hình dựa trên khả năng hoặc spec.

Tham số:

  • config (object): đối tượng cấu hình WebdriverIO
  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • specs (string[]): specs sẽ được chạy trong quá trình worker

before​

Được thực thi trước khi việc thực thi kiểm thử bắt đầu. Tại thời điểm này, bạn có thể truy cập tất cả các biến toàn cục như browser. Đây là nơi hoàn hảo để định nghĩa các lệnh tùy chỉnh.

Tham số:

  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • specs (string[]): specs sẽ được chạy trong quá trình worker
  • browser (object): phiên trình duyệt/thiết bị đã tạo

beforeSuite​

Hook được thực thi trước khi bộ kiểm thử bắt đầu (chỉ trong Mocha/Jasmine)

Tham số:

  • suite (object): chi tiết bộ kiểm thử

beforeHook​

Hook được thực thi trước một hook trong bộ kiểm thử bắt đầu (ví dụ: chạy trước khi gọi beforeEach trong Mocha)

Tham số:

  • test (object): chi tiết kiểm thử
  • context (object): ngữ cảnh kiểm thử (đại diện cho đối tượng World trong Cucumber)

afterHook​

Hook được thực thi sau khi một hook trong bộ kiểm thử kết thúc (ví dụ: chạy sau khi gọi afterEach trong Mocha)

Tham số:

  • test (object): chi tiết kiểm thử
  • context (object): ngữ cảnh kiểm thử (đại diện cho đối tượng World trong Cucumber)
  • result (object): kết quả hook (chứa thuộc tính error, result, duration, passed, retries)

beforeTest​

Hàm được thực thi trước một bài kiểm thử (chỉ trong Mocha/Jasmine).

Tham số:

  • test (object): chi tiết kiểm thử
  • context (object): đối tượng phạm vi mà bài kiểm thử được thực thi với

beforeCommand​

Chạy trước khi một lệnh WebdriverIO được thực thi.

Tham số:

  • commandName (string): tên lệnh
  • args (*): đối số mà lệnh sẽ nhận

afterCommand​

Chạy sau khi một lệnh WebdriverIO được thực thi.

Tham số:

  • commandName (string): tên lệnh
  • args (*): đối số mà lệnh sẽ nhận
  • result (number): 0 - lệnh thành công, 1 - lệnh lỗi
  • error (Error): đối tượng lỗi nếu có

afterTest​

Hàm được thực thi sau khi một bài kiểm thử (trong Mocha/Jasmine) kết thúc.

Tham số:

  • test (object): chi tiết kiểm thử
  • context (object): đối tượng phạm vi mà bài kiểm thử được thực thi với
  • result.error (Error): đối tượng lỗi trong trường hợp bài kiểm thử thất bại, nếu không là undefined
  • result.result (Any): đối tượng trả về của hàm kiểm thử
  • result.duration (Number): thời gian của bài kiểm thử
  • result.passed (Boolean): true nếu bài kiểm thử đã vượt qua, nếu không là false
  • result.retries (Object): thông tin về các lần thử lại liên quan đến bài kiểm thử đơn lẻ như được định nghĩa cho Mocha và Jasmine cũng như Cucumber, ví dụ: { attempts: 0, limit: 0 }, xem
  • result (object): kết quả hook (chứa thuộc tính error, result, duration, passed, retries)

afterSuite​

Hook được thực thi sau khi bộ kiểm thử đã kết thúc (chỉ trong Mocha/Jasmine)

Tham số:

  • suite (object): chi tiết bộ kiểm thử

after​

Được thực thi sau khi tất cả các bài kiểm thử đã hoàn thành. Bạn vẫn có quyền truy cập vào tất cả các biến toàn cục từ bài kiểm thử.

Tham số:

  • result (number): 0 - kiểm thử vượt qua, 1 - kiểm thử thất bại
  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • specs (string[]): specs sẽ được chạy trong quá trình worker

afterSession​

Được thực thi ngay sau khi kết thúc phiên webdriver.

Tham số:

  • config (object): đối tượng cấu hình WebdriverIO
  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • specs (string[]): specs sẽ được chạy trong quá trình worker

onComplete​

Được thực thi sau khi tất cả các worker đã bị tắt và quá trình sắp thoát. Một lỗi được ném ra trong hook onComplete sẽ dẫn đến việc chạy kiểm thử thất bại.

Tham số:

  • exitCode (number): 0 - thành công, 1 - thất bại
  • config (object): đối tượng cấu hình WebdriverIO
  • caps (object): chứa khả năng cho phiên sẽ được tạo ra trong worker
  • result (object): đối tượng kết quả chứa kết quả kiểm thử

onReload​

Được thực thi khi có làm mới.

Tham số:

  • oldSessionId (string): ID phiên của phiên cũ
  • newSessionId (string): ID phiên của phiên mới

beforeFeature​

Chạy trước một Tính năng Cucumber.

Tham số:

  • uri (string): đường dẫn đến tệp tính năng
  • feature (GherkinDocument.IFeature): đối tượng tính năng Cucumber

afterFeature​

Chạy sau một Tính năng Cucumber.

Tham số:

  • uri (string): đường dẫn đến tệp tính năng
  • feature (GherkinDocument.IFeature): đối tượng tính năng Cucumber

beforeScenario​

Chạy trước một Kịch bản Cucumber.

Tham số:

  • world (ITestCaseHookParameter): đối tượng world chứa thông tin về pickle và bước kiểm thử
  • context (object): đối tượng Cucumber World

afterScenario​

Chạy sau một Kịch bản Cucumber.

Tham số:

  • world (ITestCaseHookParameter): đối tượng world chứa thông tin về pickle và bước kiểm thử
  • result (object): đối tượng kết quả chứa kết quả kịch bản
  • result.passed (boolean): true nếu kịch bản đã vượt qua
  • result.error (string): stack lỗi nếu kịch bản thất bại
  • result.duration (number): thời gian của kịch bản tính bằng mili giây
  • context (object): đối tượng Cucumber World

beforeStep​

Chạy trước một Bước Cucumber.

Tham số:

  • step (Pickle.IPickleStep): đối tượng bước Cucumber
  • scenario (IPickle): đối tượng kịch bản Cucumber
  • context (object): đối tượng Cucumber World

afterStep​

Chạy sau một Bước Cucumber.

Tham số:

  • step (Pickle.IPickleStep): đối tượng bước Cucumber
  • scenario (IPickle): đối tượng kịch bản Cucumber
  • result: (object): đối tượng kết quả chứa kết quả bước
  • result.passed (boolean): true nếu kịch bản đã vượt qua
  • result.error (string): stack lỗi nếu kịch bản thất bại
  • result.duration (number): thời gian của kịch bản tính bằng mili giây
  • context (object): đối tượng Cucumber World

beforeAssertion​

Hook được thực thi trước khi một khẳng định WebdriverIO xảy ra.

Tham số:

  • params: thông tin khẳng định
  • params.matcherName (string): tên của matcher (ví dụ: toHaveTitle)
  • params.expectedValue: giá trị được truyền vào matcher
  • params.options: tùy chọn khẳng định

afterAssertion​

Hook được thực thi sau khi một khẳng định WebdriverIO đã xảy ra.

Tham số:

  • params: thông tin khẳng định
  • params.matcherName (string): tên của matcher (ví dụ: toHaveTitle)
  • params.expectedValue: giá trị được truyền vào matcher
  • params.options: tùy chọn khẳng định
  • params.result: kết quả khẳng định

Welcome! How can I help?

WebdriverIO AI Copilot