npm / selenium-webdriver
selenium-webdriver
What changed in selenium-webdriver 3, from its official release notes, upgrade guides and advisories. Also covers @types/selenium-webdriver. Sources checked 2026-10-23.
10 breaking2 new APIs and options3 behavior and defaults2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initselenium-webdriver 317 changes
Breaking changes 10
Removed because it was redundant with the new semantics of build().
Firefox now requires geckodriver v0.11.0 or newer.
The minimum supported Node version is now 6.9.0 LTS.
This method was removed as part of reducing the Thenable API for compatibility with native promises.
This method was removed as part of reducing the Thenable API for compatibility with native promises.
This method was removed as part of reducing the Thenable API for compatibility with native promises.
This API was removed.
Support for the SafariDriver browser extension was removed and replaced by Apple's safaridriver, included with Safari 10.
The Firefox module now uses geckodriver's moz:firefoxOptions dictionary for Firefox-specific configuration values.
All WebDriver subclasses now overload the static createSession function instead of doing work in the constructor; constructors inherit the base class function signature.
New APIs and options 2
Set this environment variable to 0 to disable the promise manager.
The testing module now supports tests defined using generator functions.
Behavior and default changes 3
Now returns a thenable WebDriver instance, allowing commands to be scheduled immediately or issued through standard promise callbacks.
When communicating with a W3C-compliant remote end, uses the atoms library for this command.
When communicating with a W3C-compliant remote end, uses the atoms library for this command.
Fixes and other changes 2
Fixed potential reference errors when users create a cycle with mocha by running with mocha's --hook flag.
Uses the correct HTTP method for compatibility with the W3C spec.