跳至主要内容

快速上手

欢迎来到 WebdriverIO 文档。它将帮助您快速上手。如果您遇到问题，可以在我们的Discord 支持服务器上找到帮助和答案，或者您可以在Twitter上联系我。

信息

这些文档适用于 WebdriverIO 的最新版本（>=8.x）。如果您仍在使用旧版本，请访问旧版文档网站！

官方 YouTube 频道 🎥

您可以在官方 YouTube 频道上找到更多关于 WebdriverIO 的视频。请务必订阅！

初始化 WebdriverIO 设置​

要使用WebdriverIO 启动工具包将完整的 WebdriverIO 设置添加到现有或新项目中，请运行

如果您位于现有项目的根目录中，请运行

npm init wdio@latest .

或者如果您想创建一个新项目

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

此单个命令将下载 WebdriverIO CLI 工具并运行一个配置向导，该向导可帮助您配置测试套件。

向导将提示一系列问题，引导您完成设置过程。您可以传递一个--yes参数来选择默认设置，该设置将使用 Mocha 和 Chrome，并使用页面对象模式。

npm init wdio@latest . -- --yes

手动安装 CLI​

您还可以通过以下方式手动将 CLI 包添加到您的项目中：

npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`

# run configuration wizard
npx wdio config

运行测试​

您可以使用run命令并指向您刚刚创建的 WebdriverIO 配置来启动您的测试套件

npx wdio run ./wdio.conf.js

如果您想运行特定的测试文件，可以添加一个--spec参数

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

或者在您的配置文件中定义套件，并仅运行套件中定义的测试文件

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

在脚本中运行​

如果您想在 Node.JS 脚本中的独立模式下将 WebdriverIO 作为自动化引擎使用，您也可以直接安装 WebdriverIO 并将其用作包，例如生成网站的屏幕截图

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

注意：所有 WebdriverIO 命令都是异步的，需要使用async/await进行正确处理。

录制测试​

WebdriverIO 提供了工具来帮助您入门，方法是在屏幕上录制您的测试操作并自动生成 WebdriverIO 测试脚本。有关更多信息，请参阅使用 Chrome DevTools Recorder 录制测试。

系统要求​

您需要安装Node.js。

  • 至少安装 v18.20.0 或更高版本，因为这是最旧的活动 LTS 版本
  • 仅正式支持当前或即将成为 LTS 版本的版本

如果您的系统上尚未安装 Node，我们建议您使用NVM或Volta等工具来帮助管理多个活动的 Node.js 版本。NVM 是一个流行的选择，而 Volta 也是一个不错的替代方案。

欢迎！我如何帮助您？

WebdriverIO AI Copilot