webdriverio

一套 API 跑通浏览器和手机自动化测试

开源 🏷️完全免费 ✅ 目前可打开 自动化工作流 🍴 复刻 2721 🐛 待处理 277 👀 关注 211
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 9884
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,MIT 许可证

项目预览

webdriverio 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队webdriverio
定价模式🏷️完全免费
价格说明开源免费,MIT 许可证
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型automation,cucumber,devtools,jasmine,javascript,mocha,node,performance,performance-test,test,webdriver,webdriverio
GitHub 星标★ 9884
上线时间2011-08-30 00:00:00
代码更新2026-11-19
仓库体积414.8 MB
本站数据更新2026-11-22
维护状态活跃
收录时间2026-10-08
浏览次数3

项目介绍

WebdriverIO 是一个面向 Node.js 的下一代浏览器与移动端自动化测试框架。它基于 WebDriver 协议并兼容 Chrome DevTools 协议,让开发者用同一套 API 驱动真实浏览器、模拟器或真机执行端到端测试。项目解决的核心问题是:传统 Selenium 绑定繁琐、跨浏览器与移动端配置割裂、测试脚本可维护性差。WebdriverIO 提供简洁的链式异步 API、自动等待与重试机制,内置对 Mocha、Jasmine、Cucumber 等测试框架的支持,并集成断言、mock、覆盖率与性能测试能力。它还能接管 Appium 生态做移动端自动化,支持并行执行与云端设备农场。凭借 TypeScript 类型、丰富的插件体系和活跃社区,它成为前端与 QA 团队构建稳定自动化测试流水线的主流选择之一。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 9884

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 6 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Node.js 环境(WebdriverIO 是面向 Node.js 的自动化测试框架)
  • 可访问 GitHub 的网络(用于创建 Codespaces 或克隆仓库)
  • Gitpod 账号或 GitHub 账号(README 提供的两种开箱即用环境)

安装与启动步骤

  1. 1了解两种上手方式

    WebdriverIO 面向 Node.js,README 提供 GitHub Codespaces 与 Gitpod 两种开箱即用环境。

  2. 2创建 Codespaces

    在仓库页面点击 Codespaces 按钮,自动打开网页版 VS Code,dev container 已配好所需软件。

  3. 3用 Gitpod 启动

    点击 Gitpod 按钮即可获得可用的开发环境,适合快速开始阅读和修改代码。

  4. 4本地克隆仓库

    如不用云端环境,可先把仓库克隆到本地,再参照官网开发者指南继续操作。

    git clone https://github.com/webdriverio/webdriverio.git
  5. 5选择 Runner 包

    本地跑测试用 @wdio/local-runner,在浏览器中跑单元或组件测试用 @wdio/browser-runner。

  6. 6查阅官方文档

    进入官网的 Developer Guide 与 API Reference,查看安装、配置和 API 用法。

关键配置

配置项必填说明示例
devcontainer.json否Codespaces 开发容器配置,已预装项目所需软件.devcontainer/devcontainer.json

如何确认成功

Codespaces 或 Gitpod 页面成功打开,能看到仓库文件与集成终端,即表示环境就绪。

常见问题

Q:本地没有 Node.js 环境怎么办?

A:可直接使用 README 提供的 GitHub Codespaces 或 Gitpod,浏览器打开即用,无需在本地安装任何软件。

Q:dev container 是什么?

A:它是一种开放规范,被 GitHub Codespaces 以及其他支持容器开发环境的工具所支持,仓库已提供完整配置。

Q:local-runner 和 browser-runner 有什么区别?

A:@wdio/local-runner 用于在本地运行测试;@wdio/browser-runner 用于在浏览器中运行单元测试或组件测试。

Q:想参与贡献从哪里开始?

A:查看仓库中标记为 good first pick 的 issue,也可通过 Matrix 频道(discord.webdriver.io)提问。

注意事项

  • README 节选未给出本地 npm 安装与运行命令,请以官网 Developer Guide 为准。
  • Codespaces 与 Gitpod 均为云端环境,注意用量并及时停止以免产生额外费用。
  • 命令中的仓库地址为官方仓库,如使用 fork 请替换为自己的地址。

核心亮点

  • 统一 API 同时覆盖桌面浏览器与移动端 Appium 自动化,减少多套工具切换成本
  • 内置自动等待、智能选择器和重试机制,显著降低测试脚本的偶发失败率
  • 官方支持 Mocha、Jasmine、Cucumber 及 TypeScript,插件与 reporter 生态丰富

不足之处

  • 依赖底层 WebDriver/Appium 服务,环境搭建与版本匹配对新手有一定门槛
  • 大规模并行测试时对设备农场或自建 Selenium Grid 的资源要求较高

适用场景

  • Web 应用端到端回归测试,覆盖多浏览器与多分辨率
  • 移动 App 在真机或模拟器上的自动化验收测试
  • 接入 CI/CD 流水线,在合并前自动跑通关键业务流程

替代项目

Playwright、Cypress、Puppeteer

上一篇:abx-dl

下一篇:BrowserGym

同类项目推荐

bookmarksAI 开源

让 GPT 自动帮你把杂乱书签整理得井井有条

GPT automatically organizes your browser bookmarks

★ 129 2026-08-09
ccg-workflow 开源

一个命令,让多个 AI 模型自动协作搞定复杂任务

多模型协作工作流引擎 — /ccg:go 一个命令,AI 自动分析意图、选择策略、编排 Codex + Ge···

★ 5985 2026-08-09
open-web-bridge 开源

让 AI 直接操控你已登录的真实 Chrome

Drive your real Chrome from any AI agent — logged-in sessions, real fingerprint, li···

★ 114 2026-09-15
PaiAgent 开源

用 Java 拖出一条 AI 工作流,跑通就上线

轻量级的AI工作流编排系统,类似dify、n8n,全程使用Vibe Coding,AI工具为Qoder+CLI。涉及···

★ 728 2026-09-20
easi.run 开源

自托管 Chrome 会话,AI 代理操作网页,真人随时接管

Self-hosted Chrome sessions for you and your AI agents. MCP, live human takeover, sa···

★ 119 2026-11-17
AgentPilot 开源

拖拽搭 AI 工作流,多模型一键跑起来

A versatile workflow automation platform to create, organize, and execute AI workflo···

★ 574 2026-11-16
RPA-Python 开源

用 Python 写脚本,轻松搞定桌面重复操作,跨平台自动跑。

Python package for doing RPA

★ 5501 2026-08-10
kogiqa-mcp 开源

让 AI Agent 亲手开浏览器,边跑边调试 Web 应用

This web browser has been designed to help your agent debug and develop complex web ···

★ 86 2026-09-15
blender-mcp 开源

用聊天让 LLM 直接操控 Blender 建模

Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···

★ 35284 2026-09-16