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)