Release 8.0.0

8.0.0 (2026-10-09)

For WebdriverIO 10; WebdriverIO 9 keeps using the previous majors. Read the upgrade note before you upgrade.

⚠ BREAKING CHANGES

• Node.js 22.19.0 or newer (#17)
• @wdio/logger is a peer dependency (^9.18.0 || ^10.0.0), so the driver logs into WebdriverIO's log file. With Yarn and without WebdriverIO, add @wdio/logger yourself (#21)
• require('geckodriver') returns every export, with CommonJS types (#21)
• GECKODRIVER_FILEPATH is no longer read; use GECKODRIVER_PATH (#21)
• HTTPS_PROXY, HTTP_PROXY and NO_PROXY now apply to downloads; a dispatcher set with undici's setGlobalDispatcher wins over them (#29) (#36)
• The CLI exits with code 1 when a signal kills the driver; it exited with 0 (#33)

Features

• @wdio/logger as a peer dependency, so the driver logs into WebdriverIO's log file; require() returns every export (#21) (32d065e)
• require Node.js 22.19.0 or newer; build with TypeScript 7 and test with Vitest 5 (#17) (5f1f0ff)

Bug Fixes

• CDN URLs with credentials; complete the v8 upgrade docs (#35) (695826d)
• driver processes, CLI exit codes, version lookups; spawnOpts everywhere (#33) (daa94f1)
• honor HTTPS_PROXY, HTTP_PROXY and NO_PROXY when downloading drivers (#29) (02f2161)
• run the auto-install postinstall on Windows too (#39) (511f318)
• ship src so the source maps resolve (#37) (d1702d5)
• use a dispatcher set with setGlobalDispatcher for driver downloads (#36) (d5692e6)

Documentation

• connect the examples to the driver they start (#38) (4cdf4ae)
• map driver majors to WebdriverIO majors and note the v8 upgrade (#25) (c907602)
• safaridriver has no CLI; copy the cached binary for selenium on Windows (#40) (5672ce0)

Miscellaneous Chores

• deps: Bump the minor-deps-updates-main group across 1 directory with 2 updates (#20) (86c0f6a)
• deps: Bump the minor-deps-updates-main group with 2 updates (#18) (6981431)