webdriverio /webdriverio
Next-gen browser and mobile automation test framework for Node.js
★ 9,884⑂ 2,720👁 211⑃ 9,571● 6,129▤ 622
+0
Daily
9,884
stars
2,720
forks
211
watchers
9,571
prs
6,129
issues
622
releases
README
Next-gen browser and mobile automation test framework for Node.js.
Homepage |
Developer Guide |
API Reference |
Contribute |
Changelog |
Roadmap
WebdriverIO is a test automation framework, for e2e as well as unit and component testing in the browser, that allows you to run tests based on the WebDriver and WebDriver BiDi as well as Appium automation technology. It provides support for your favorite BDD/TDD test framework and will run your tests locally or in the cloud using Sauce Labs, BrowserStack, TestingBot or TestMu AI (Formerly LambdaTest).
:woman_technologist: :man_technologist: Contributing
Do you like WebdriverIO and want to help make it better? Awesome! Have a look into our Contributor Documentation to get started and find out what contributions can be and how to make them. AI coding agents should start with AGENTS.md.
Getting started with GitHub Codespaces
To get started, create a codespace for this repository by clicking this 👇
A codespace will open in a web-based version of Visual Studio Code. The dev container is fully configured with the software needed for this project.
Note: Dev containers are an open spec that is supported by GitHub Codespaces and other tools.
Getting started with Gitpod
You can also just click on:
to get a ready-to-use development environment for you to start working on this code base.
If you're looking for issues to help out with, check out the issues labeled "good first pick". You can also reach out to our Matrix Channel if you have questions on where to start contributing.
:office: WebdriverIO for Enterprise
Available as part of the Tidelift Subscription.
The maintainers of WebdriverIO and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open-source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.
:package: Packages
This repository contains some of the core packages of the WebdriverIO project. There are many wonderful curated resources the WebdriverIO community has put together.
Did you build a WebdriverIO service or reporter? That's awesome! Please add it to our configuration wizard and docs (e.g. like in this example commit) as well as to our awesome-webdriverio list. Thank you! 🙏 ❤️
Core
- webdriver - A Node.js bindings implementation for the W3C WebDriver and WebDriver Bidi protocols
- webdriverio - Next-gen browser and mobile automation test framework for Node.js
- @wdio/cli - A WebdriverIO testrunner command line interface
Helper
- @wdio/config - A helper utility to parse and validate WebdriverIO options
- @wdio/logger - A helper utility for logging WebdriverIO packages
- @wdio/protocols - Utility package providing information about automatiTop issues
#8022[🐛 Bug]: Drag drop is not working48 comments · 2022-02-17#12032command --watch not working as expected18 comments · 2024-01-17#7580[🐛 Bug]: isExisting calls findElements (multiple), a potentially expensive op18 comments · 2021-10-21#11868[💡 Feature]: Check for unsupported `"engines"` package.json fields17 comments · 2023-12-14#4666Allow to retrieve state and props from React Element17 comments · 2019-10-21#16168Tracking: known limitations of parallel mode (parallelMode) and the PRs that fix them13 comments · 2026-10-21#13663[💡 Feature]: V9 Browser Logs12 comments · 2024-09-26#13548[🐛 Bug]: v9 browser.mock take a lot of time if url length is above 2512 comments · 2024-09-10
Discussions
#15631Thoughts on fully automated agents opening PRs in open source?0 comments · 2026-09-19#15127Passing application cmd args on launch in Mac using wdio electron service1 comments · 2026-03-04#15063Loading Firefox and Chromium browser extensions and testing the browser extensions example1 comments · 2026-01-29#15053WebdriverIO worker and maxInstances inconsistent behaviour1 comments · 2026-01-26#15029Is expect-webdriverio 5.6.2 broken for anyone else?2 comments · 2026-01-19#14967How do you setup code coverage?1 comments · 2025-12-28#14962Streamline Release Documentation with AI-Generated Changelogs1 comments · 2025-12-26#14893addCommand() deprecated?1 comments · 2025-11-28
Latest release
v10.2.0 v10.2.0 2026-11-06v10.2.0 (2026-11-06) :boom: Breaking Change wdio-cucumber-framework, wdio-cucumberjs-json-reporter 16236 fix(@wdio/cucumber-framework): use the values of Cucumber profiles, default strict to true, and report BeforeAll / AfterAll as hooks of the feature (@plum117) create-wdio, eslint-plugin-wdio, wdio-ai-service, wdio-allure-reporter, wdio-appium-service, wdio-browser-runner, wdio-cli, wdio-concise-reporter, wdio-config, wdio-cucumber-framework, wdio-cucumberjs-json-reporter, wdio-display-server, wdio-dot-reporter, wdio-firefox-profile-service, wdio-globals, wdio-html-reporter, wdio-jasm