Release 3.0.0

3.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)
• With require('safaridriver'), start() returns the ChildProcess and stop() returns nothing, as in ESM; both returned a Promise. await start() still works; start().then(...) does not (#21)
• The driver output is piped, as in the other drivers: read stdout and stderr, or pass spawnOpts: { stdio: 'ignore' }. Before, the output was buffered and the driver was killed after 1 MB of it (#33)

Features

• require('safaridriver') returns the ESM exports, with CommonJS types (#21) (32d065e)
• require Node.js 22.19.0 or newer; build with TypeScript 7 and test with Vitest 5 (#17) (5f1f0ff)

Bug Fixes

• keep tsconfig.test.json out of the npm package (#35) (695826d)
• pipe the driver output, allow start() again after the driver exits, new spawnOpts option (#33) (daa94f1)
• ship src so the source maps resolve (#37) (d1702d5)

Documentation

• map driver majors to WebdriverIO majors and note the v8 upgrade (#25) (c907602)

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)

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.29.1 || ^10.0.0), so the driver logs into WebdriverIO's log file. With Yarn and without WebdriverIO, add @wdio/logger yourself (#21)
• require('edgedriver') returns every export, with CommonJS types (#21)
• HTTPS_PROXY, HTTP_PROXY and NO_PROXY now apply to downloads; a dispatcher set with undici's setGlobalDispatcher wins over them (#29) (#36)
• start() resolves to a ChildProcess (it was typed ChildProcessWithoutNullStreams) (#33)
• The CLI exits with code 1 when a signal kills the driver; it exited with 0 (#33)
• findEdgePath() on Windows returns undefined when Edge is not installed; it threw (#30)

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)
• drop edge-paths, whose Windows fallback threw instead of returning undefined (#30) (1d92fb1)
• find Edge and its version without a shell (#32) (5fe9ded)
• 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)

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)

Release 2.0.0

2.0.0 (2026-09-22)

Bug Fixes

• repository metadata and stale doc links across driver packages (#15) (8c88982)

Miscellaneous Chores

• Migrate to oxlint as done in webdriverio project (#6) (8dd718f)
• Migrate to tsc 6 (#4) (83bdba5)
• Project review (#9) (8331115)

Release 7.0.0

7.0.0 (2026-09-22)

Bug Fixes

• repository metadata and stale doc links across driver packages (#15) (8c88982)

Miscellaneous Chores

• deps: Bump modern-tar from 0.7.7 to 0.8.5 in the minor-deps-updates-main group across 1 directory (#2) (bb0cbb8)
• exclude geckodriver's CHANGELOG.md from the npm package (#12) (940e0dd)
• Migrate to oxlint as done in webdriverio project (#6) (8dd718f)
• Migrate to tsc 6 (#4) (83bdba5)
• Project review (#9) (8331115)

Release 7.0.0

7.0.0 (2026-09-22)

Bug Fixes

• repository metadata and stale doc links across driver packages (#15) (8c88982)

Miscellaneous Chores

• Migrate to oxlint as done in webdriverio project (#6) (8dd718f)
• Migrate to tsc 6 (#4) (83bdba5)
• Project review (#9) (8331115)