Skip to content

WebdriverIO v10 Node.js support#15136

Draft
christian-bromann wants to merge 1 commit intomainfrom
cursor/webdriverio-v10-node-js-support-4cbe
Draft

WebdriverIO v10 Node.js support#15136
christian-bromann wants to merge 1 commit intomainfrom
cursor/webdriverio-v10-node-js-support-4cbe

Conversation

@christian-bromann
Copy link
Copy Markdown
Member

Proposed changes

This PR updates WebdriverIO to exclusively support Node.js v22, v24, and v26 for the upcoming v10 major release.

Key changes include:

  • Updating engines.node to >=22 across all package.json files.
  • Upgrading @types/node to ^22.0.0 where applicable.
  • Adjusting Node.js matrices in GitHub Actions CI workflows (test-smoke.yml, test-unit.yml, test-component.yml) to ['22', '24', '26'].
  • Updating runtime Node.js version checks and error messages in create-wdio.
  • Simplifying wdio-cli/src/launcher.ts by removing legacy --loader checks and the unused nodeVersion utility, as Node.js 22+ natively supports --import.
  • Updating the .devcontainer/Dockerfile base image to node:0-22.

Types of changes

  • Polish (an improvement for an existing feature)
  • Bugfix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update (improvements to the project's docs)
  • Specification changes (updates to WebDriver command specifications)
  • Internal updates (everything related to internal scripts, governance documentation and CI files)

Checklist

  • I have read the CONTRIBUTING doc
  • I have added tests that prove my fix is effective or that my feature works
  • I have added the necessary documentation (if appropriate)
  • I have added proper type definitions for new commands (if appropriate)

Backport Request

  • This change is solely for v9 and doesn't need to be back-ported
  • Back-ported PR at #XXXXX

Further comments

Reviewers: @webdriverio/project-committers


Open in Web Open in Cursor 

BREAKING CHANGE: WebdriverIO v10 now requires Node.js v22 or later.
Support for Node.js v18 and v20 has been dropped.

Changes:
- Update engines.node to ">=22" across all packages
- Update CI matrices to test Node.js 22, 24, and 26
- Update create-wdio runtime version check from >=18.18.0 to >=22
- Update UNSUPPORTED_NODE_VERSION message to reference Node.js v22
- Simplify launcher.ts by always using --import flag (available in all
  supported Node.js versions)
- Remove unused nodeVersion() utility function
- Update @types/node to ^22.0.0
- Update devcontainer to use Node.js 22 base image
- Add engines.node field to wdio-protocols package

Co-authored-by: Christian Bromann <christian-bromann@users.noreply.github.com>
@cursor
Copy link
Copy Markdown

cursor Bot commented Mar 5, 2026

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

@linux-foundation-easycla
Copy link
Copy Markdown

CLA Not Signed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants