跳到主要内容

配置

根据安装类型（例如使用原始协议绑定、作为独立包的WebdriverIO或WDIO测试运行器），有不同的选项集可用于控制环境。

WebDriver 选项​

使用webdriver协议包时，定义了以下选项：

protocol​

与驱动程序服务器通信时使用的协议。

类型：String
默认值：http

hostname​

驱动程序服务器的主机。

类型：String
默认值：0.0.0.0

port​

驱动程序服务器所在的端口。

类型：Number
默认值：undefined

path​

驱动程序服务器端点的路径。

类型：String
默认值：/

queryParams​

传播到驱动程序服务器的查询参数。

类型：Object
默认值：undefined

user​

您的云服务用户名（仅适用于Sauce Labs、Browserstack、TestingBot或LambdaTest账户）。如果设置，WebdriverIO将自动为您设置连接选项。如果您不使用云提供商，这可用于验证任何其他WebDriver后端。

类型：String
默认值：undefined

key​

您的云服务访问密钥或秘密密钥（仅适用于Sauce Labs、Browserstack、TestingBot或LambdaTest账户）。如果设置，WebdriverIO将自动为您设置连接选项。如果您不使用云提供商，这可用于验证任何其他WebDriver后端。

类型：String
默认值：undefined

capabilities​

定义要在WebDriver会话中运行的功能。查看WebDriver协议了解更多详情。如果您运行的是不支持WebDriver协议的旧驱动程序，则需要使用JSONWireProtocol功能才能成功运行会话。

除了基于WebDriver的功能外，您还可以应用浏览器和供应商特定的选项，以便更深入地配置远程浏览器或设备。这些在相应的供应商文档中有记录，例如：

此外，Sauce Labs的自动测试配置器是一个有用的工具，它可以通过点击组合您所需的功能来帮助您创建此对象。

类型：Object
默认值：null

示例：

{
    browserName: 'chrome', // 选项: `chrome`, `edge`, `firefox`, `safari`
    browserVersion: '27.0', // 浏览器版本
    platformName: 'Windows 10' // 操作系统平台
}

如果您在移动设备上运行Web或原生测试，capabilities与WebDriver协议不同。有关更多详细信息，请参阅Appium文档。

logLevel​

日志记录的详细程度。

类型：String
默认值：info
选项：trace | debug | info | warn | error | silent

outputDir​

存储所有测试运行器日志文件的目录（包括报告器日志和wdio日志）。如果未设置，所有日志将流式传输到stdout。由于大多数报告器都是为日志记录到stdout而设计的，因此建议仅针对特定报告器使用此选项，这些报告器更适合将报告推送到文件中（例如junit报告器）。

在独立模式下运行时，WebdriverIO生成的唯一日志将是wdio日志。

类型：String
默认值：null

connectionRetryTimeout​

任何WebDriver请求到驱动程序或网格的超时时间。

类型：Number
默认值：120000

connectionRetryCount​

向Selenium服务器重试请求的最大次数。

类型：Number
默认值：3

agent​

允许您使用自定义的http/https/http2 agent发出请求。

类型：Object
默认值：

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

headers​

指定要传递到每个WebDriver请求的自定义headers。如果您的Selenium网格需要基本身份验证，我们建议通过此选项传递Authorization头来验证您的WebDriver请求，例如：

import { Buffer } from 'buffer';
// Read the username and password from environment variables
const username = process.env.SELENIUM_GRID_USERNAME;
const password = process.env.SELENIUM_GRID_PASSWORD;

// Combine the username and password with a colon separator
const credentials = `${username}:${password}`;
// Encode the credentials using Base64
const encodedCredentials = Buffer.from(credentials).toString('base64');

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

类型：Object
默认值：{}

transformRequest​

在发出WebDriver请求之前拦截HTTP请求选项的函数

类型：(RequestOptions) => RequestOptions
默认值：无

transformResponse​

WebDriver响应到达后拦截HTTP响应对象的函数。该函数接收原始响应对象作为第一个参数，相应的RequestOptions作为第二个参数。

类型：(Response, RequestOptions) => Response
默认值：无

strictSSL​

是否不要求SSL证书有效。 可以通过环境变量STRICT_SSL或strict_ssl设置。

类型：Boolean
默认值：true

enableDirectConnect​

是否启用Appium直接连接功能。 如果响应在启用标志的情况下没有适当的键，它不会做任何事情。

类型：Boolean
默认值：true

cacheDir​

缓存目录的根路径。该目录用于存储尝试启动会话时下载的所有驱动程序。

类型：String
默认值：process.env.WEBDRIVER_CACHE_DIR || os.tmpdir()

WebdriverIO​

以下选项（包括上面列出的选项）可以与独立模式的WebdriverIO一起使用：

automationProtocol​

定义要用于浏览器自动化的协议。目前仅支持webdriver，因为它是WebdriverIO使用的主要浏览器自动化技术。

如果您想使用不同的自动化技术来自动化浏览器，请确保将此属性设置为解析为遵循以下接口的模块的路径：

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

export default class YourAutomationLibrary {
    /**
     * Start a automation session and return a WebdriverIO [monad](https://github.com/webdriverio/webdriverio/blob/940cd30939864bdbdacb2e94ee6e8ada9b1cc74c/packages/wdio-utils/src/monad.ts)
     * with respective automation commands. See the [webdriver](https://www.npmjs.com/package/webdriver) package
     * as a reference implementation
     *
     * @param {Capabilities.RemoteConfig} options WebdriverIO options
     * @param {Function} hook that allows to modify the client before it gets released from the function
     * @param {PropertyDescriptorMap} userPrototype allows user to add custom protocol commands
     * @param {Function} customCommandWrapper allows to modify the command execution
     * @returns a WebdriverIO compatible client instance
     */
    static newSession(
        options: Capabilities.RemoteConfig,
        modifier?: (...args: any[]) => any,
        userPrototype?: PropertyDescriptorMap,
        customCommandWrapper?: (...args: any[]) => any
    ): Promise<Client>;

    /**
     * allows user to attach to existing sessions
     * @optional
     */
    static attachToSession(
        options?: AttachOptions,
        modifier?: (...args: any[]) => any, userPrototype?: {},
        commandWrapper?: (...args: any[]) => any
    ): Client;

    /**
     * Changes The instance session id and browser capabilities for the new session
     * directly into the passed in browser object
     *
     * @optional
     * @param   {object} instance  the object we get from a new browser session.
     * @returns {string}           the new session id of the browser
     */
    static reloadSession(
        instance: Client,
        newCapabilities?: WebdriverIO.Capabilitie
    ): Promise<string>;
}

类型：String
默认值：webdriver

baseUrl​

通过设置基本URL来缩短url命令调用。

  • 如果您的url参数以/开头，则会预置baseUrl（除了baseUrl路径，如果它有的话）。
  • 如果您的url参数没有以方案或/开头（如some/path），则直接预置完整的baseUrl。

类型：String
默认值：null

waitforTimeout​

所有waitFor*命令的默认超时时间。（请注意选项名称中的小写f。）此超时__仅__影响以waitFor*开头的命令及其默认等待时间。

要增加_测试_的超时时间，请参阅框架文档。

类型：Number
默认值：5000

waitforInterval​

所有waitFor*命令检查预期状态（例如可见性）是否已更改的默认间隔。

类型：Number
默认值：100

region​

如果在Sauce Labs上运行，您可以选择在不同的数据中心之间运行测试：美国或欧盟。 要将您的区域更改为欧盟，请在配置中添加region: 'eu'。

__注意：__这仅在您提供与Sauce Labs帐户关联的user和key选项时才有效。

类型：String
默认值：us

（仅适用于vm和/或em/模拟器）

测试运行器选项​

以下选项（包括上面列出的选项）仅针对使用WDIO测试运行器运行WebdriverIO定义：

specs​

定义测试执行的规范。您可以指定一个glob模式一次匹配多个文件，或者将glob或一组路径包装到数组中，在单个工作进程中运行它们。所有路径都被视为相对于配置文件路径。

类型：(String | String[])[]
默认值：[]

exclude​

从测试执行中排除规范。所有路径都被视为相对于配置文件路径。

类型：String[]
默认值：[]

suites​

描述各种套件的对象，您可以在wdio CLI上使用--suite选项指定。

类型：Object
默认值：{}

capabilities​

与上面描述的capabilities部分相同，但有选项可以指定multiremote对象，或者在数组中指定多个WebDriver会话以进行并行执行。

您可以应用与上面定义的相同的供应商和浏览器特定功能。

类型：Object|Object[]
默认值：[{ 'wdio:maxInstances': 5, browserName: 'firefox' }]

maxInstances​

并行运行的工作程序的最大总数。

__注意：__当测试在某些外部供应商（如Sauce Labs）的机器上执行时，这个数字可能高达100。在那里，测试不是在单台机器上测试，而是在多个虚拟机上测试。如果测试要在本地开发机器上运行，请使用更合理的数字，如3、4或5。本质上，这是将同时启动并同时运行测试的浏览器数量，因此它取决于您的机器上有多少RAM以及您的机器上运行的其他应用程序数量。

您还可以使用wdio:maxInstances功能在功能对象中应用maxInstances。这将限制该特定功能的并行会话数量。

类型：Number
默认值：100

maxInstancesPerCapability​

每种功能的并行运行的工作程序的最大总数。

类型：Number
默认值：100

injectGlobals​

将WebdriverIO的全局变量（例如browser、$和$$）插入到全局环境中。 如果设置为false，您应该从@wdio/globals导入，例如：

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

注意：WebdriverIO不处理测试框架特定全局变量的注入。

类型：Boolean
默认值：true

bail​

如果您希望测试运行在特定数量的测试失败后停止，请使用bail。 （默认为0，无论如何都会运行所有测试。）**注意：**在这种情况下，测试是指单个规范文件中的所有测试（使用Mocha或Jasmine时）或特性文件中的所有步骤（使用Cucumber时）。如果您想控制单个测试文件中测试的bail行为，请查看可用的框架选项。

类型：Number
默认值：0（不退出；运行所有测试）

specFileRetries​

当整个规范文件作为一个整体失败时重试的次数。

类型：Number
默认值：0

specFileRetriesDelay​

规范文件重试尝试之间的延迟（以秒为单位）

类型：Number
默认值：0

specFileRetriesDeferred​

重试的规范文件是立即重试还是推迟到队列末尾。

类型：Boolean
默认值：true

groupLogsByTestSpec​

选择日志输出视图。

如果设置为false，来自不同测试文件的日志将实时打印。请注意，并行运行时，这可能会导致来自不同文件的日志输出混合。

如果设置为true，日志输出将按测试规范分组，并且仅在测试规范完成时打印。

默认情况下，它设置为false，因此日志是实时打印的。

类型：Boolean
默认值：false

services​

服务接管您不想关心的特定工作。它们几乎不费力地增强您的测试设置。

类型：String[]|Object[]
默认值：[]

framework​

定义WDIO测试运行器使用的测试框架。

类型：String
默认值：mocha
选项：mocha | jasmine

mochaOpts, jasmineOpts和cucumberOpts​

特定框架相关的选项。有关哪些选项可用，请参阅框架适配器文档。在框架中了解更多相关信息。

类型：Object
默认值：{ timeout: 10000 }

cucumberFeaturesWithLineNumbers​

带行号的cucumber特性列表（当使用cucumber框架时）。

类型：String[] 默认值：[]

reporters​

要使用的报告器列表。报告器可以是字符串，也可以是 ['reporterName', { /* reporter options */}]数组，其中第一个元素是带有报告器名称的字符串，第二个元素是带有报告器选项的对象。

类型：String[]|Object[]
默认值：[]

示例：

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

reporterSyncInterval​

确定报告器检查它们是否同步的时间间隔，如果它们异步报告其日志（例如，如果日志流式传输到第三方供应商）。

类型：Number
默认值：100（毫秒）

reporterSyncTimeout​

确定报告器完成上传所有日志的最长时间，直到测试运行器抛出错误。

类型：Number
默认值：5000（毫秒）

execArgv​

启动子进程时要指定的Node参数。

类型：String[]
默认值：null

filesToWatch​

支持glob的字符串模式列表，告诉测试运行器在使用--watch标志运行时额外监视其他文件，例如应用程序文件。默认情况下，测试运行器已经监视所有规范文件。

类型：String[]
默认值：[]

updateSnapshots​

如果要更新快照，则设置为true。理想情况下作为CLI参数的一部分使用，例如wdio run wdio.conf.js --s。

类型：'new' | 'all' | 'none'
默认值：如果未提供且测试在CI中运行，则为none；如果未提供，则为new；否则为提供的值

resolveSnapshotPath​

覆盖默认快照路径。例如，将快照存储在测试文件旁边。

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

类型：(testPath: string, snapExtension: string) => string
默认值：在测试文件旁边的__snapshots__目录中存储快照文件

tsConfigPath​

WDIO使用tsx编译TypeScript文件。自动从当前工作目录检测您的TSConfig，但您可以在此处指定自定义路径或通过设置TSX_TSCONFIG_PATH环境变量来指定。

请参阅tsx文档：https://tsx.is/dev-api/node-cli#custom-tsconfig-json-path

类型：String
默认值：null

钩子​

WDIO测试运行器允许您设置钩子，以便在测试生命周期的特定时间触发。这允许自定义操作（例如，如果测试失败则拍摄屏幕截图）。

每个钩子都以生命周期的特定信息作为参数（例如有关测试套件或测试的信息）。在我们的示例配置中阅读有关所有钩子属性的更多信息。

**注意：**某些钩子（onPrepare、onWorkerStart、onWorkerEnd和onComplete）在不同的进程中执行，因此不能与工作进程中的其他钩子共享任何全局数据。

onPrepare​

在所有工作程序启动前执行一次。

参数：

  • config (object)：WebdriverIO配置对象
  • param (object[])：功能详情列表

onWorkerStart​

在生成工作进程之前执行，可用于初始化该工作进程的特定服务以及以异步方式修改运行时环境。

参数：

  • cid (string)：功能ID（例如0-0）
  • caps (object)：包含将在工作进程中生成的会话的功能
  • specs (string[])：要在工作进程中运行的规范
  • args (object)：工作进程初始化后将与主配置合并的对象
  • execArgv (string[])：传递给工作进程的字符串参数列表

onWorkerEnd​

在工作进程退出后立即执行。

参数：

  • cid (string)：功能ID（例如0-0）
  • exitCode (number)：0 - 成功，1 - 失败
  • specs (string[])：要在工作进程中运行的规范
  • retries (number)：按照"按规范文件基础添加重试"中定义的规范级别重试次数

beforeSession​

在初始化webdriver会话和测试框架之前执行。它允许您根据功能或规范操作配置。

参数：

  • config (object)：WebdriverIO配置对象
  • caps (object)：包含将在工作进程中生成的会话的功能
  • specs (string[])：要在工作进程中运行的规范

before​

在测试执行开始之前执行。此时，您可以访问所有全局变量，如browser。这是定义自定义命令的理想位置。

参数：

  • caps (object)：包含将在工作进程中生成的会话的功能
  • specs (string[])：要在工作进程中运行的规范
  • browser (object)：创建的浏览器/设备会话实例

beforeSuite​

在套件开始之前执行的钩子（仅在Mocha/Jasmine中）

参数：

  • suite (object)：套件详情

beforeHook​

在套件中的钩子开始之前执行的钩子（例如，在Mocha中调用beforeEach之前运行）

参数：

  • test (object)：测试详情
  • context (object)：测试上下文（在Cucumber中代表World对象）

afterHook​

在套件中的钩子结束之后执行的钩子（例如，在Mocha中调用afterEach之后运行）

参数：

  • test (object)：测试详情
  • context (object)：测试上下文（在Cucumber中代表World对象）
  • result (object)：钩子结果（包含error、result、duration、passed、retries属性）

beforeTest​

在测试之前执行的函数（仅在Mocha/Jasmine中）。

参数：

  • test (object)：测试详情
  • context (object)：测试执行时的作用域对象

beforeCommand​

在执行WebdriverIO命令之前运行。

参数：

  • commandName (string)：命令名称
  • args (*)：命令将接收的参数

afterCommand​

在执行WebdriverIO命令之后运行。

参数：

  • commandName (string)：命令名称
  • args (*)：命令将接收的参数
  • result (number)：0 - 命令成功，1 - 命令错误
  • error (Error)：如果有错误对象

afterTest​

测试（在Mocha/Jasmine中）结束后要执行的函数。

参数：

  • test (object)：测试详情
  • context (object)：测试执行时的作用域对象
  • result.error (Error)：测试失败时的错误对象，否则为undefined
  • result.result (Any)：测试函数的返回对象
  • result.duration (Number)：测试持续时间
  • result.passed (Boolean)：如果测试通过则为true，否则为false
  • result.retries (Object)：有关单个测试相关重试的信息，如为Mocha和Jasmine以及Cucumber定义的，例如{ attempts: 0, limit: 0 }，请参见
  • result (object)：钩子结果（包含error、result、duration、passed、retries属性）

afterSuite​

套件结束后执行的钩子（仅在Mocha/Jasmine中）

参数：

  • suite (object)：套件详情

after​

所有测试完成后执行。您仍然可以访问测试中的所有全局变量。

参数：

  • result (number)：0 - 测试通过，1 - 测试失败
  • caps (object)：包含将在工作进程中生成的会话的功能
  • specs (string[])：要在工作进程中运行的规范

afterSession​

在终止webdriver会话后立即执行。

参数：

  • config (object)：WebdriverIO配置对象
  • caps (object)：包含将在工作进程中生成的会话的功能
  • specs (string[])：要在工作进程中运行的规范

onComplete​

在所有工作进程关闭且进程即将退出后执行。在onComplete钩子中抛出的错误将导致测试运行失败。

参数：

  • exitCode (number)：0 - 成功，1 - 失败
  • config (object)：WebdriverIO配置对象
  • caps (object)：包含将在工作进程中生成的会话的功能
  • result (object)：包含测试结果的结果对象

onReload​

在刷新发生时执行。

参数：

  • oldSessionId (string)：旧会话的会话ID
  • newSessionId (string)：新会话的会话ID

beforeFeature​

在Cucumber特性之前运行。

参数：

afterFeature​

在Cucumber特性之后运行。

参数：

beforeScenario​

在Cucumber场景之前运行。

参数：

  • world (ITestCaseHookParameter)：包含有关pickle和测试步骤信息的world对象
  • context (object)：Cucumber World对象

afterScenario​

在Cucumber场景之后运行。

参数：

  • world (ITestCaseHookParameter)：包含有关pickle和测试步骤信息的world对象
  • result (object)：包含场景结果的结果对象
  • result.passed (boolean)：如果场景通过则为true
  • result.error (string)：如果场景失败则为错误堆栈
  • result.duration (number)：场景持续时间（毫秒）
  • context (object)：Cucumber World对象

beforeStep​

在Cucumber步骤之前运行。

参数：

  • step (Pickle.IPickleStep)：Cucumber步骤对象
  • scenario (IPickle)：Cucumber场景对象
  • context (object)：Cucumber World对象

afterStep​

在Cucumber步骤之后运行。

参数：

  • step (Pickle.IPickleStep)：Cucumber步骤对象
  • scenario (IPickle)：Cucumber场景对象
  • result: (object)：包含步骤结果的结果对象
  • result.passed (boolean)：如果场景通过则为true
  • result.error (string)：如果场景失败则为错误堆栈
  • result.duration (number)：场景持续时间（毫秒）
  • context (object)：Cucumber World对象

beforeAssertion​

在WebdriverIO断言发生之前执行的钩子。

参数：

  • params：断言信息
  • params.matcherName (string)：匹配器的名称（例如toHaveTitle）
  • params.expectedValue：传递给匹配器的值
  • params.options：断言选项

afterAssertion​

在WebdriverIO断言发生后执行的钩子。

参数：

  • params：断言信息
  • params.matcherName (string)：匹配器的名称（例如toHaveTitle）
  • params.expectedValue：传递给匹配器的值
  • params.options：断言选项
  • params.result：断言结果

Welcome! How can I help?

WebdriverIO AI Copilot