测试运行器

WebdriverIO 自带一个测试运行器，可以帮助您尽快开始测试。它应该为您完成所有工作，允许集成到第三方服务，并帮助您尽可能高效地运行测试。

WebdriverIO 的测试运行器在 NPM 包 @wdio/cli 中单独捆绑。

像这样安装它

npm

npm install @wdio/cli

Yarn

yarn add @wdio/cli

pnpm

pnpm add @wdio/cli

要查看命令行界面帮助，请在您的终端中键入以下命令

$ npx wdio --help

wdio <command>

Commands:
  wdio config                           Initialize WebdriverIO and setup configuration in
                                        your current project.
  wdio install <type> <name>            Add a `reporter`, `service`, or `framework` to
                                        your WebdriverIO project
  wdio repl <option> [capabilities]     Run WebDriver session in command line
  wdio run <configPath>                 Run your WDIO configuration file to initialize
                                        your tests.

Options:
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]

太棒了！现在您需要定义一个配置文件，其中包含有关您的测试、功能和设置的所有信息。切换到配置文件部分以查看该文件的外观。

使用 wdio 配置助手，生成配置文件非常容易。只需运行

$ npx wdio config

…它将启动助手实用程序。

它将向您提问并在不到一分钟的时间内为您生成一个配置文件。

设置好配置文件后，您可以通过运行以下命令启动测试

npx wdio run wdio.conf.js

您也可以在没有 run 命令的情况下初始化测试运行

npx wdio wdio.conf.js

就是这样！现在，您可以通过全局变量 browser 访问 selenium 实例。

命令

wdio config

config 命令运行 WebdriverIO 配置助手。此助手将询问您一些关于 WebdriverIO 项目的问题，并根据您的答案创建一个 wdio.conf.js 文件。

示例

wdio config

选项

--help            prints WebdriverIO help menu                                [boolean]
--npm             Wether to install the packages using NPM instead of yarn    [boolean]

wdio run

这是运行配置的默认命令。

run 命令初始化您的 WebdriverIO 配置文件并运行您的测试。

示例

wdio run ./wdio.conf.js --watch

选项

--help                prints WebdriverIO help menu                   [boolean]
--version             prints WebdriverIO version                     [boolean]
--hostname, -h        automation driver host address                  [string]
--port, -p            automation driver port                          [number]
--user, -u            username if using a cloud service as automation backend
                                                                        [string]
--key, -k             corresponding access key to the user            [string]
--watch               watch specs for changes                        [boolean]
--logLevel, -l        level of logging verbosity
                            [choices: "trace", "debug", "info", "warn", "error", "silent"]
--bail                stop test runner after specific amount of tests have
                        failed                                          [number]
--baseUrl             shorten url command calls by setting a base url [string]
--waitforTimeout, -w  timeout for all waitForXXX commands             [number]
--framework, -f       defines the framework (Mocha, Jasmine or Cucumber) to
                        run the specs                                   [string]
--reporters, -r       reporters to print out the results on stdout      [array]
--suite               overwrites the specs attribute and runs the defined
                        suite                                            [array]
--spec                run only a certain spec file - overrides specs piped
                        from stdin                                       [array]
--exclude             exclude spec file(s) from a run - overrides specs piped
                        from stdin                                       [array]
--repeat              Repeat specific specs and/or suites N times        [number]
--mochaOpts           Mocha options
--jasmineOpts         Jasmine options
--cucumberOpts        Cucumber options

注意：可以使用 tsx ENV 变量轻松控制自动编译。另请参阅TypeScript 文档。

wdio install

install 命令允许您通过 CLI 将报告器和服务添加到您的 WebdriverIO 项目中。

示例

wdio install service sauce # installs @wdio/sauce-service
wdio install reporter dot # installs @wdio/dot-reporter
wdio install framework mocha # installs @wdio/mocha-framework

如果要使用 yarn 安装软件包，则可以将 --yarn 标志传递给命令

wdio install service sauce --yarn

如果您正在使用的 WDIO 配置文件不在您正在工作的同一个文件夹中，您也可以传递自定义配置路径

wdio install service sauce --config="./path/to/wdio.conf.js"

支持的服务列表

sauce
testingbot
firefox-profile
devtools
browserstack
appium
intercept
zafira-listener
reportportal
docker
wiremock
lambdatest
vite
nuxt

支持的报告器列表

dot
spec
junit
allure
sumologic
concise
reportportal
video
html
json
mochawesome
timeline

支持的框架列表

mocha
jasmine
cucumber

wdio repl

repl 命令允许启动一个交互式命令行界面来运行 WebdriverIO 命令。它可用于测试目的或快速启动 WebdriverIO 会话。

在本地 Chrome 中运行测试

wdio repl chrome

或在 Sauce Labs 上运行测试

wdio repl chrome -u $SAUCE_USERNAME -k $SAUCE_ACCESS_KEY

您可以应用与run 命令中相同的参数。