webdriverio

Every stable release, newest first. Notes are quoted as the maintainers published them.

1. 10.0.2

   8 October 2026
   Wdio-protocols, webdriver, webdriverio

   :eyeglasses: Spec Compliancy

   • wdio-protocols, webdriver, webdriverio

     • fix(webdriver): regenerate BiDi types for the script.EvaluationResult rename (@plum117)

   :rocket: New Feature

   • wdio-session, wdio-snapshot

     • feat(snapshot): tag repeated controls with their row context (@Winify)

   • wdio-ai-service, wdio-session, wdio-snapshot

     • feat(snapshot): prepare @wdio/snapshot and session packages for MCP integration (@Winify)

   • create-wdio, wdio-session, wdio-snapshot

     • feat(snapshot): @wdio/snapshot POC implementation (@Winify)

   :bug: Bug Fix

   • create-wdio, wdio-session, wdio-snapshot

     • fix(@wdio/session): keep agents on the UI path and fail fast (@Winify)

   • webdriverio

     • fix(webdriverio): find custom strategy, matcher and argument elements again (@dprevost-LMI)

     • fix(webdriverio): preserve strict option and index in hasElementId (@sh011)

   • wdio-jasmine-framework

     • fix(@wdio/jasmine-framework): add expect.multiRemote() to the Jasmine expect (@dprevost-LMI)

     • fix(@wdio/jasmine-framework): support expect.extend() for custom matchers (@devangpratap)

   • wdio-globals, wdio-jasmine-framework

     • fix(@wdio/jasmine-framework): keep expect-webdriverio's expect types and type expectAsync matchers (@dprevost-LMI)

   Committers: 5

   • David Prevost (@dprevost-LMI)

   • David Prévost (@plum117)

   • Shrey Shekhar (@sh011)

   • Vince Graics (@Winify)

   • @devangpratap

2. 10.0.1

   7 October 2026
   Create-wdio

   :rocket: New Feature

   • create-wdio

     • feat(create-wdio): offer the devtools service in the wizard (@vishnuv688)

   • wdio-sauce-service, wdio-spec-reporter, wdio-types, webdriverio

     • feat: support the Sauce Labs asia-south-2 data center (@bahrimootaz)

   :bug: Bug Fix

   • webdriverio

     • Fix/emulate device unsupported bidi 15938 (@mccmrunal)

   • Other

     • fix(website): fix and align the mobile navbar menu (@christian-bromann)

   Committers: 5

   • Christian Bromann (@christian-bromann)

   • David Prevost (@dprevost-LMI)

   • MRUNAL CHAUDHARI (@mccmrunal)

   • Vishnu Vardhan (@vishnuv688)

   • @bahrimootaz

3. 10.0.0

   5 October 2026
   Webdriverio

   :eyeglasses: Spec Compliancy

   • webdriverio

     • fix(webdriverio): follow the WebDriver spec for elements of other browsing contexts (@christian-bromann)

   :boom: Breaking Change

   • breaking

     webdriverio

     • feat(webdriverio): React 18 & 19 support for react$ / react$$ with a built-in resq replacement (@dprevost-LMI)

     • breaking(webdriverio): return a MultiRemoteMock from multiremote mock() (@christian-bromann)

     • breaking(webdriverio): drop ignored startActivity legacy options (@christian-bromann)

     • breaking(webdriverio): remove deprecated throttle and touchAction commands (@devangpratap)

     • breaking(webdriverio): stabilise multiremote select() and drop its env flag (@PloneMraz)

     • breaking(webdriverio): return a MultiRemoteElementArray from multiremote $$ (@PloneMraz)

   • breaking

     wdio-session, wdio-types, wdio-utils, webdriver, webdriverio

     • feat(webdriverio): hold a browsing context for a tab, a window, and a frame (@christian-bromann)

   • breaking

     wdio-session, webdriverio

     • feat: drive browser.emulate() from the BiDi emulation module (@christian-bromann)

   • breaking

     wdio-browser-runner, wdio-session, webdriverio

     • feat: replace browser.uploadFile with element.setFiles (@christian-bromann)

   • breaking

     wdio-protocols, webdriverio

     • breaking: reinstate modified Appium screen recording endpoints (@eglitise)

     • breaking(webdriverio): remove executeAsync and hide switchToFrame (@christian-bromann)

   • breaking

     eslint-plugin-wdio

     • breaking(eslint-plugin-wdio): require ESLint 10 and fix TypeScript mode (@dprevost-LMI)

   • breaking

     wdio-jasmine-framework

     • breaking(@wdio/jasmine-framework): keep Jasmine sync matchers synchronous (@dprevost-LMI)

   • breaking

     eslint-plugin-wdio, wdio-browser-runner, wdio-globals, wdio-jasmine-framework, wdio-local-runner, wdio-runner, wdio-session

     • breaking: upgrade expect-webdriverio to 8.0.0-alpha.0 (@dprevost-LMI)

   • breaking

     wdio-appium-service, wdio-cli, wdio-concise-reporter, wdio-protocols, wdio-reporter, wdio-sauce-service, wdio-spec-reporter, wdio-utils, webdriver, webdriverio

     • breaking: drop remaining JSON Wire Protocol leftovers (@christian-bromann)

   • breaking

     eslint-plugin-wdio, wdio-cli, wdio-globals, wdio-jasmine-framework, wdio-runner, wdio-types, webdriverio

     • V10/remove deprecated config globals reporter apis 15656 (@JustasMonkev)

   • breaking

     wdio-browser-runner, wdio-cli, wdio-display-server, wdio-jasmine-framework, wdio-local-runner, wdio-reporter, wdio-shared-store-service, wdio-utils, webdriver, webdriverio

     • breaking(browser-runner): upgrade Vitest 3 to 5 (@dprevost-LMI)

   • breaking

     eslint-plugin-wdio, wdio-allure-reporter, wdio-appium-service, wdio-cli, wdio-config, wdio-display-server, wdio-firefox-profile-service, wdio-globals, wdio-junit-reporter, wdio-lighthouse-service, wdio-local-runner, wdio-reporter, wdio-runner, wdio-sauce-service, wdio-shared-store-service, wdio-spec-reporter, wdio-testingbot-service, wdio-types, wdio-utils, wdio-webdriver-mock-service, webdriverio

     • breaking: v10 Align dropped multiremote naming for multi-remote / multiRemote (@dprevost-LMI)

   • breaking

     wdio-utils, webdriverio

     • breaking(webdriverio): drop the JSONWP element id (@christian-bromann)

   • breaking

     wdio-runner, wdio-utils, webdriver, webdriverio

     • breaking: treat every session as W3C (@christian-bromann)

   • breaking

     wdio-runner, webdriverio

     • breaking(webdriverio): look up multiremote instances with getInstance (@christian-bromann)

     • breaking(@wdio/runner): remove the LegacyCustomStubCommand and setupExpect shims (@PloneMraz)

   • breaking

     wdio-allure-reporter, wdio-reporter, wdio-runner, wdio-utils, webdriverio

     • breaking: drop four v10 compatibility leftovers (@christian-bromann)

   • breaking

     wdio-cli

     • breaking(wdio-cli): drop unprefixed capability specs and exclude (@christian-bromann)

   • breaking

     wdio-cli, wdio-jasmine-framework, wdio-utils

     • breaking(jasmine): pass spec results explicitly and drop legacy options (@christian-bromann)

   • breaking

     wdio-cli, wdio-utils, webdriverio

     • breaking: drop JSONWP Appium caps and the mobile getValue fallback (@christian-bromann)

   • breaking

     wdio-lighthouse-service, wdio-runner, wdio-utils, webdriverio

     • breaking(webdriverio): remove legacy command signatures (@christian-bromann)

   • breaking

     create-wdio, wdio-appium-service, wdio-browser-runner, wdio-protocols, wdio-types, wdio-webdriver-mock-service, webdriver, webdriverio

     • breaking: require Appium 3 and drop Appium 1/2 HTTP fallbacks (@christian-bromann)

   • breaking

     create-wdio, eslint-plugin-wdio, wdio-allure-reporter, wdio-appium-service, wdio-browser-runner, wdio-cli, wdio-concise-reporter, wdio-config, wdio-cucumber-framework, wdio-display-server, wdio-dot-reporter, wdio-firefox-profile-service, wdio-globals, wdio-jasmine-framework, wdio-json-reporter, wdio-junit-reporter, wdio-lighthouse-service, wdio-local-runner, wdio-logger, wdio-mocha-framework, wdio-protocols, wdio-repl, wdio-reporter, wdio-runner, wdio-sauce-service, wdio-shared-store-service, wdio-smoke-test-cjs-service, wdio-smoke-test-reporter, wdio-smoke-test-service, wdio-spec-reporter, wdio-static-server-service, wdio-sumologic-reporter, wdio-testingbot-service, wdio-utils, wdio-webdriver-mock-service, webdriver, webdriverio

     • breaking: upgrade remaining majors unlocked by Node 22.19 (@christian-bromann)

   • breaking

     wdio-display-server, wdio-local-runner, wdio-types, wdio-xvfb

     • feat: native headless Wayland (weston) support (@goosewobbler)

   • breaking

     eslint-plugin-wdio, wdio-browser-runner, wdio-cli, wdio-globals, wdio-jasmine-framework, wdio-local-runner, wdio-mocha-framework, wdio-runner

     • breaking(@wdio/mocha-framework): upgrade Mocha from 10 to 12 (@christian-bromann)

   • breaking

     wdio-browser-runner, wdio-config, wdio-runner, wdio-types, webdriverio

     • breaking(webdriverio): make $ strict and throw on multiple matches (@mccmrunal)

   • breaking

     create-wdio, eslint-plugin-wdio, wdio-allure-reporter, wdio-appium-service, wdio-browser-runner, wdio-cli, wdio-concise-reporter, wdio-config, wdio-cucumber-framework, wdio-dot-reporter, wdio-firefox-profile-service, wdio-globals, wdio-jasmine-framework, wdio-json-reporter, wdio-junit-reporter, wdio-local-runner, wdio-logger, wdio-mocha-framework, wdio-protocols, wdio-repl, wdio-reporter, wdio-runner, wdio-sauce-service, wdio-shared-store-service, wdio-smoke-test-cjs-service, wdio-smoke-test-reporter, wdio-smoke-test-service, wdio-spec-reporter, wdio-static-server-service, wdio-sumologic-reporter, wdio-testingbot-service, wdio-types, wdio-utils, wdio-webdriver-mock-service, wdio-xvfb, webdriver, webdriverio

     • breaking: require Node.js >=22.19.0 (@christian-bromann)

4. 9.32.0

   20 September 2026
   Wdio-cli, wdio-runner, wdio-types, wdio-utils

   :rocket: New Feature

   • wdio-cli, wdio-runner, wdio-types, wdio-utils

     • feat(profiling): add support for cpu and heap profiling (@mccmrunal)

   • webdriverio

     • feat(webdriverio): add acceptDialog and dismissDialog for mobile permission dialogs (@christian-bromann)

   • create-wdio

     • feat(create-wdio): add Dioxus service to the project creation wizard and docs (@goosewobbler)

   :bug: Bug Fix

   • webdriverio

     • fix(webdriverio): make addLocatorStrategy work on multi-remote browsers (@nikolas-sapa)

     • fix(webdriverio): keep a valid top-level context on switchToParentFrame (@PloneMraz)

     • fix(webdriverio): release the session-manager registration on removeListeners (@PloneMraz)

     • fix: resolve mock state error and race condition (#15072) (@mccmrunal)

     • fix(webdriverio): correctly use navigation ID for networkIdle wait (@mccmrunal)

     • fix(webdriverio): avoid retaining closed browser instances (@ML642)

     • fix(webdriverio): let switchToParentFrame recover a destroyed context (@PloneMraz)

     • fix(webdriverio): use BiDi accessibility locator for aria selectors (@christian-bromann)

     • fix(webdriverio): re-throw original stale element error when refetch fails (@nikolas-sapa)

     • fix(webdriverio): apply throttleNetwork conditions to service workers (@nikolas-sapa)

     • fix(webdriverio): handle dynamic function payloads in mock.respond (@christian-bromann)

     • fix(webdriverio): honor getHTML exclusion options (@lucasmariano003-wq)

     • fix(webdriverio): recover owning window after nested frame destruction (@lucasmariano003-wq)

     • fix(webdriverio): allow URLPattern as browser.mock url (@Yash121l)

     • fix(webdriverio): retain detached-first shadow hosts (@lucasmariano003-wq)

   • Other

     • fix(webdriverio): preserve original stale-element error when refetch fails (Closes #15550) (@nikolas-sapa)

     • fix(wdio-protocols): map getActiveElement return type to ElementRefer… (@mccmrunal)

   • wdio-junit-reporter

     • fix(junit-reporter): uniquely associate Jasmine filename-only suites (@christian-bromann)

   • wdio-sumologic-reporter

     • fix(sumo-reporter):sumologic reporter bounded retries (@ML642)

   • wdio-utils

     • fix(wdio-utils): settle some and every on all-hole arrays (@devangpratap)

     • fix(utils): clean up incomplete driver cache dir before retrying install (@nikolas-sapa)

     • fix(wdio-utils): preserve sparse array length in async map (@ML642)

     • fix(utils): encode custom plugin file URLs (@ML642)

   • wdio-browser-runner

     • fix(mock-factory): correct original module type (@ML642)

   • wdio-allure-reporter, wdio-utils

     • fix(wdio-allure-reporter): stabilize Allure historyId across browser versions (@christian-bromann)

   • create-wdio

     • fix(create-wdio): generate tsconfig without overwriting or breaking root extends (@christian-bromann)

   • webdriver

     • fix(webdriver): enable followRedirects for BiDi connections (@christian-bromann)

   • wdio-lighthouse-service, wdio-runner, webdriverio

     • Add undefined to getInstance as possible return type (@la122)

   • wdio-allure-reporter

     • fix(allure-reporter): classify AssertionError by error name property (@mcwanza)

     • fix(wdio-allure-reporter): write results incrementally instead of only at runner end (@devangpratap)

   • wdio-cli, wdio-local-runner, wdio-types

     • fix(@wdio/local-runner): report a non-zero exit code for signal terminated workers (@nikolas-sapa)

5. 9.31.9

   13 September 2026
   Wdio-utils

   :rocket: New Feature

   • wdio-utils

     • feat(@wdio/utils): support CHROMEDRIVER_CDNURL for custom driver mirrors (@mccmrunal)

   :bug: Bug Fix

   • wdio-utils

     • fix: Upgrade EdgeDriver accounting browser's version missing corresponding driver architecture (@dprevost-LMI)

   Committers: 2

   • David Prevost (@dprevost-LMI)

   • MRUNAL CHAUDHARI (@mccmrunal)

6. 9.31.8

   12 September 2026
   Webdriverio

   :bug: Bug Fix

   • webdriverio

     • fix(webdriverio): restore nested/Shadow DOM scrolling in scrollIntoView (@mccmrunal)

   Committers: 2

   • MRUNAL CHAUDHARI (@mccmrunal)

   • Martsin Lazouski (@ML642)

7. 9.31.7

   7 September 2026
   Wdio-utils, webdriverio

   :rocket: New Feature

   • wdio-utils, webdriverio

     • feat: Move select into BETA with env flag still (@dprevost-LMI)

   Committers: 1

   • David Prevost (@dprevost-LMI)

8. 9.31.6

   6 September 2026
   Create-wdio

   :rocket: New Feature

   • create-wdio

     • Third party service null-driver (@ccharnkij)

   :bug: Bug Fix

   • wdio-sumologic-reporter

     • fix(sumologic-reporter): retry after failed sync (@Fnine59)

   • wdio-utils

     • fix(wdio-utils): track dialog listener lifecycle (@Fnine59)

   • webdriverio

     • fix(webdriverio): clear shadow roots when navigation starts (@iamhaseebn)

     • fix(webdriverio):reject invalid timeout values (@ML642)

   • wdio-config

     • fix(wdio-config): apply keyword exclude to grouped specs (@harsha509)

   • webdriver

     • fix(webdriver): keep new driver PID after reloadSession (@harsha509)

   :nail_care: Polish

   • wdio-utils

     • fix(wdio-utils): track dialog listener lifecycle (@Fnine59)

   Committers: 8

   • Chanatan Charnkijtawarush (@ccharnkij)

   • David Prevost (@dprevost-LMI)

   • Fnine59 (@Fnine59)

   • Haseeb Nazir (@iamhaseebn)

   • Kauan Barbosa (@Kauanldsbarbosa)

   • Martsin Lazouski (@ML642)

   • Sri Harsha (@harsha509)

   • Vishnu Vardhan (@vishnuv688)

9. 9.31.5

   29 August 2026
   Wdio-utils, webdriverio

   :rocket: New Feature

   • wdio-utils, webdriverio

     • feat: UNSTABLE Review Multi-remote select implementations and remove filter (@dprevost-LMI)

   :bug: Bug Fix

   • wdio-utils, webdriverio

     • feat: UNSTABLE Review Multi-remote select implementations and remove filter (@dprevost-LMI)

   • webdriverio

     • fix(webdriverio): handle BiDi no such node errors as stale (@Fnine59)

     • fix(webdriverio): require all classic cookie filter attributes (@ML642)

   Committers: 3

   • David Prevost (@dprevost-LMI)

   • Fnine59 (@Fnine59)

   • Martsin Lazouski (@ML642)

10. 9.31.4

    27 August 2026
    Webdriverio

    :rocket: New Feature

    • webdriverio

      • feat: Beta ElementArray under feature flag for multiRemote.$$() e.g. MultiRemoteElement[] (@dprevost-LMI)

    • wdio-allure-reporter

      • feat(wdio-allure-reporter): add support for global errors and global attachments (@todti)

    :bug: Bug Fix

    • webdriverio

      • fix(webdriverio): track document element per context (@Badisi)

    • webdriver

      • fix(webdriver): serialize IPv6 BiDi WebSocket candidates correctly (@ML642)

    Committers: 5

    • Alex (@todti)

    • David Prevost (@dprevost-LMI)

    • Martsin Lazouski (@ML642)

    • @Badisi

    • @devangpratap

Major versions

• 10.xsince 5 October 2026 · latest 10.0.2 · 3 releases
• 9.xsince 15 August 2024 · latest 9.32.0 · 107 releases
• 8.xsince 1 December 2022 · latest 8.46.0 · 181 releases
• 7.xsince 9 February 2021 · latest 7.40.0 · 123 releases
• 6.xsince 26 March 2020 · latest 6.12.1 · 78 releases
• 5.xsince 21 December 2018 · latest 5.23.0 · 139 releases
• 4.xsince 3 February 2016 · latest 4.14.4 · 65 releases
• 3.xsince 29 June 2015 · latest 3.4.0 · 16 releases
• 2.xsince 11 August 2014 · latest 2.4.5 · 16 releases