项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 9884
使用教程
⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。
环境要求
- Node.js 环境(WebdriverIO 是面向 Node.js 的自动化测试框架)
- 可访问 GitHub 的网络(用于创建 Codespaces 或克隆仓库)
- Gitpod 账号或 GitHub 账号(README 提供的两种开箱即用环境)
安装与启动步骤
-
1了解两种上手方式
WebdriverIO 面向 Node.js,README 提供 GitHub Codespaces 与 Gitpod 两种开箱即用环境。
-
2创建 Codespaces
在仓库页面点击 Codespaces 按钮,自动打开网页版 VS Code,dev container 已配好所需软件。
-
3用 Gitpod 启动
点击 Gitpod 按钮即可获得可用的开发环境,适合快速开始阅读和修改代码。
-
4本地克隆仓库
如不用云端环境,可先把仓库克隆到本地,再参照官网开发者指南继续操作。
git clone https://github.com/webdriverio/webdriverio.git -
5选择 Runner 包
本地跑测试用 @wdio/local-runner,在浏览器中跑单元或组件测试用 @wdio/browser-runner。
-
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
ccg-workflow
开源
一个命令,让多个 AI 模型自动协作搞定复杂任务
多模型协作工作流引擎 — /ccg:go 一个命令,AI 自动分析意图、选择策略、编排 Codex + Ge···
open-web-bridge
开源
让 AI 直接操控你已登录的真实 Chrome
Drive your real Chrome from any AI agent — logged-in sessions, real fingerprint, li···
PaiAgent
开源
用 Java 拖出一条 AI 工作流,跑通就上线
轻量级的AI工作流编排系统,类似dify、n8n,全程使用Vibe Coding,AI工具为Qoder+CLI。涉及···
easi.run
开源
自托管 Chrome 会话,AI 代理操作网页,真人随时接管
Self-hosted Chrome sessions for you and your AI agents. MCP, live human takeover, sa···
AgentPilot
开源
拖拽搭 AI 工作流,多模型一键跑起来
A versatile workflow automation platform to create, organize, and execute AI workflo···
RPA-Python
开源
用 Python 写脚本,轻松搞定桌面重复操作,跨平台自动跑。
Python package for doing RPA
kogiqa-mcp
开源
让 AI Agent 亲手开浏览器,边跑边调试 Web 应用
This web browser has been designed to help your agent debug and develop complex web ···
blender-mcp
开源
用聊天让 LLM 直接操控 Blender 建模
Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···
