4.37.0

Add CDP for Chrome 141 and remove 138

4.36.0

Add CDP for Chrome 140 and remove 137

4.35.0

Add CDP for Chrome 139 and remove 136
Fix typos in javascript & rb (#16019)
add default as a value for SameSite (#16129)
[bidi]: fix flaky bidi network test - can request cookies (#16141)

4.34.0

Bumping to nightly versions
Add warning when ftp proxy is used (#15905)
specify min required node version to >=20.0.0
[cdp] Add CDP for Chrome 138 and remove 135

4.33.0

[cdp] Add CDP for Chrome 137 and remove 134
Fixing JS FF test that needs to add arguments.
Making Bidi Network, DevTools and Options test pass in RBE
Chrome capabilities test passes now in RBE
update old freenode channel link to libera (#15698)

4.32.0

[cdp] Add CDP for Chrome 136 and remove 133
Set remote active protocol in Firefox to BiDi only

4.31.0

[bidi]: fix storage module instance checks and add user context cookie test (#15467)
[JS] Add websocket port option in Firefox ServiceBuilder when '--connect-existing' is not passed (#15557)
[cdp] add support for 135 and remove 132

4.30.0

[bidi] fix chrome and firefox test for CI RBE (#15405)
[cdp] add support for 134 and remove 131
[cdp] remove support for v85 since no longer required by Firefox
[bidi] implement permissions module commands in JS (#15304)

4.29.0

Add CDP for Chrome 133 and remove 130
[js] Remove Firefox CDP (#15200)
[js][bidi] Implement bidi setCacheBehavior command (#15136)
[js][bidi] Implement bidi getClientWindows command in browser module (#15248)

4.28.1

[JS] specify min required node versiton to 18.20.5

4.28.0

Add CDP for Chrome 132 and remove 129
[js] Add Federated Credential Management support (#15008)
[JS] Specify Node.js engine version as 22.x LTS in package.json (#15058)
[JS] Add detailed error message for invalid cookie name validation in getCookie method
[JS] Add err message for invalid cookie name in deleteCookie method
[JS] Enables diagnostic logging for Safari
[java][JS][py] Add straight relative-by locators (#14482)

4.27.0

Add CDP for Chrome 131 and remove 128
Add Firefox CDP deprecation warnings
Update supported versions for Chrome DevTools
[bidi] Allow passing in uri for authentication handlers (#14386)
[bidi] Enable locate node tests for Chrome and Edge
[bidi] Ensure start nodes are serialized

4.26.0

Add CDP for Chrome 130 and remove 127
Fix sendKeys command fail on FileDetector.handleFile error (#14663)
Update dependencies to latest versions to resolve security alerts
Close BiDi websocket connection (#14507)

4.25.0

Add CDP for Chrome 129 and remove 126

4.24.1

Close CDP websocket connection on driver.quit (#14501)

4.24.0

[js] expose selenium version for node.js (#14325)
[bidi] Add authentication handlers
[bidi] Add high-level script command (#14293)
Handle optional dependency for @bazel/runfiles
remove console msg and safe exit if runfiles never found
fix rbe build(use global node process)
Fix error handling for missing runfiles
[ci] Use a tag to figure out what we might want to release (#14378)
Add CDP for Chrome 128 and remove 125

4.23.0

Expose pnpm as a tool we can use
[bidi] Fix the event unsubscribe method. Update modules to have close methods. (#14192)
Run Node browser tests on the RBE (#14194)
[bidi] Add methods to add/remove handlers in Script module (#14230)
[bidi] Add source type to log entry (#14244)
[bidi] Add dom mutation handlers (#14238)
[bidi] Add high-level script pinning APIs (#14250)
[bidi] Deprecate argument value wrapper class (#14251)
Add CDP for Chrome 127 and remove 124

4.22.0

[bidi] Add types for user prompt related events (#14097)
Add preference to enable CDP in Firefox by default (#14091)
[bidi] Add callback handlers for logging APIs (#14120)
[bidi] Add high-level logging API (#14135)
Add CDP for Chrome 126 and remove 123

4.21.0

Add CDP for Chrome 125 and remove 122
Ensure 'selectVisibleByText' method is same as other languages (#13899)
Ensure parity in the locators used by methods (#13902)

4.20.0

Add CDP for Chrome 124 and remove 121
[bidi] Update capture screenshot APIs to include all parameters and remove scroll parameter ( #13744)
[bidi] Implement functionality to retrieve all top-level browsing contexts
Set browserName by default when browserOptions are used
Implement fullPageScreenshot functionality for Firefox (#13301)
Nightly JS builds are now pushed to GitHub packages
Making Selenium Manager a thin wrapper (#13853)
- This change has been made to make it easier to maintain and improve, the interface has changed and if users were invoking it, they might experience issues. Selenium Manager is still in beta and these type of changes are expected.
[bidi] Update browsing context create method (#13766)

4.19.0

Add CDP for Chrome 123 and remove 120
[bidi] Add browser module (#13677)
[bidi] Add storage module (#13684)
[bidi] Add fail request command
[bidi] Add error handling to check BytesValue instance
[bidi] Add continueRequest and continueResponse command (#13704)
[bidi] Add provide response command (#13708)
[bidi] Add setFiles command of the Input Module (#13711)
[atoms] use css locators in dom.js (#13430)

4.18.1

Add CDP for Chrome 122 and remove 119

4.18.0

Fix running the casting related methods in chromium (#13479)
[bidi] Add browsing context destroyed event
[bidi] Add realm destroyed event
[bidi] Add locate node command (#13489)
[bidi] Deprecate NetworkInspector in favor of Network
Make npm run lint pass for javascript/selenium-webdriver (#13560)
[bidi] Add "addintercept" and "removeintercept" commands (#13564)
[bidi] Add auth related commands (#13572)
[bidi] Add 'continueWithAuth' command
[bidi] Add 'fetchError' command

4.17.0

Add javascript to Selenium Manager input for tracking (see #13288)
remove deprecated headless methods and associated references
Add script message event (#13153)
Update channel name from Aurora to Dev
Remove firefox_channels.js example as Channels is deprecated
Add Input module command (#13360)
remove all references to firefox-bin
download files from remote server (#13102)
Add auth required event
Add traverse history command
Add test to get iframe's browsing context
Add Input module JS command
Add test for node properties in
Add CDP for Chrome 121 and remove 118

4.16.0

🐛 Bug fix

Fix logging levels in http.js and webdriver.js (#13098)
Remove unused targets from the JS tree (#13129)
💅 Polish
Add CDP v120 and remove v117

4.15.0

🐛 Bug fix

Replace calls to console.log with managed loggers (#12909)

💅 Polish

Add CDP v119 and remove v116

🚀 New Feature

Add BiDi captureScreenshot command (#12510)
Add BiDi browsing context activate command, handle user prompt command and reload command
Add BiDi browsing context commands and events (#13078)

4.14.0

💅 Polish

Adding CDP v118 and removing v115

4.13.0

💅 Polish

Adding CDP v117 and removing v114
Added file location to exception message for Selenium Manager

🚀 New Feature

Allow users to set Selenium Manager path by environment variable (#12752)

4.12.0

🐛 Bug fix

Adding browsers when they are present on the host (#12456)
Create absolute path for browser binary (#12479)
Fix how browsers and drivers are discovered (#12456)

💅 Polish

Add support for Chrome 116 and remove support for Chrome 113
Remove browserVersion from options in Selenium Manager (#12641)

4.11.1

🐛 Bug fix

Update testing/index.js code snippet to fix function call (#12456)

v4.11.0

💅 Polish

[BiDi] fix addPreloadScript failing tests (#12182)
Print debug message once for each browser when selenium manager used
Add forgotten RelativeBy in check options (#12289)
SM supports all browsers in Selenium since a while ago
Using SM to check drivers on the PATH
Display info about SM activity
Removing logic to find drivers, delegating to Selenium Manager
Removing service parameter from getPath
add support for Chrome 115 and remove support for Chrome 112
Update webdriver-bootstrap.js (#12276)

🚀 New Feature

[BiDi] add Network module events (#12197)
Adding ignore process match for IE Mode across bindings (#12279)
Add browser output from Selenium Manager to options (#12411)

🐛 Bug Fix

fix SeleniumServer.start() crashes on MacOS with nodejs selenium-webdriver ( #12158)
Update by.js: Add forgotten RelativeBy in check options (#12289)

v4.10.0

💅 Polish

Adding CDP v114 and removing v111

🚀 New Feature

[Edge] Support webview2 (#11978)
[BiDi] Add Script module commands to add/remove preloaded scripts (#11847)
[BiDi] Add printPage command (#12124)
Add support for proxies with Selenium Manager

v4.9.2

💅 Polish

Handle rejection of the driver if not found

v4.9.1

💅 Polish

Add CDP files for v113 and remove v110

v4.9.0

💅 Polish

Adding CDP v112 and removing v109

🐛 Bug Fix

Fix: return statement in submit() (#11883)
[grid] Refining the UI configuration to allow sub paths work properly.
Replace execSync with spawnSync in seleniumManager.js (#11649) (#11873)

🚀 New Feature

[BiDi] Add Script module commands and types (#11847)
Selenium Manager get Browser Version from Options classes
Selenium Manager use binary from Browser Options

v4.8.2

💅 Polish

Add CDP support for v111 and remove v108
Using json output with Selenium Manager

🐛 Bug Fix

fix: Using status from response (#11742)

v4.8.1

🚀 New Feature

Add script pinning (#11584)

💅 Polish

Add CDP support for v110 and remove v107
Updating Selenium Manager binaries for 4.8.1 release

🐛 Bug Fix

fix: iedriver download with selenium-manager #11579

v4.8.0

🚀 New Feature

Add initial BiDi Support (#11395)
Add window wrappers getSize and setSize
Add BiDi browser context commands (#11473)
Add BiDi methods to listen to js logs and any type of logs
Add BiDi filtering capability to LogInspector (#11495)
Add comment with name of large JS executions (#11038)

💅 Polish

Add CDP support for v109 and remove v106
Deprecate setHeadless() in Chrome and Firefox (#11467)

v4.7.1

💅 Polish

feat/deprecation message for standalone3x (#11422)

🐛 Bug Fix

feat/fix spawn format for SeleniumServer, issue 11405 (#11412)

Committers: 1

Potapov Dmitriy (@potapovDim)

v4.7.0

🚀 New Feature

Add support for Selenium Manager to work with IE Driver

💅 Polish

Adding CDP files for v108 and removing v105
Improve error handling for Selenium Manager

v4.6.1

🐛 Bug Fix

Support Node 17 and above (#11262)

💅 Polish

Fix typos (#11258)

v4.6.0

🚀 New Feature

[grid] Add ability to use Enter key to confirm (#11178)
[grid][ui] Add search field for running sessions (#11197)
Add support for selenium manager (#11189)

🐛 Bug Fix

isPromise() thenable fix (#11048)
Fix: making methods static (#11182)

💅 Polish

fix a tiny typo in chromium.js (#11073)
Adding CDP files for v107 and removing v104

v4.5.0

🚀 New Feature

Adds 'Select' support package
- selectByIndex
- selectByValue
- selectByVisibleText
- getAllSelectedOptions
- getFirstSelectedOption
- deselectAll
- deselectByVisibleText
- deselectByIndex
- deselectByValue
Add support for Actions API sendKeys to designated element
Adds mouse button enum for forward and backward navigation

🐛 Bug Fix

Set min node support to 14.x.x (issue 1 in #10970)
fix: geckodriver session with node 18.x.x (issue 2 in #10970)
fix: JS firefox driver crashes on setting a profile (fixed with commit)
fix: "SetExperimental" option is not available in webdriverjs ( Javascript/Typescript) (#10959)
fix: Do not allow Select class to select disabled options (#10812)

💅 Polish

Stop sending desiredCapabilities to local end and remote end
tests: Quit driver instance after each test
tests: Adds select by multiple(index,value, text) tests
chore/code style changes, add util (#10975)
chore/code style changes to common format (#10964)
destructuring exports
Moving from static to const to make js-dossier happy
Removing circular dependency Between webdriver.js and http.js
fix some typos in code and documentation
add cdp v105 remove v102
add cdp v106 remove v103

v4.4.0

Add support CDP 104 and remove CDP 101

v4.3.1

create new default service for every driver instance in chromium (#10796)
Updated jsdoc for move action (#10816)

v4.3.0

Fix: using fulfillRequest when intercepting (#10764)
Add support CDP 103 and remove CDP 100
Remove unused param in input.js & minor code cleanup
Fixes lint issues and updates npm packages
feat: Added virtual authenticator (#10663)

v4.2.0

Delete old android-driver
Remove Opera support from JS bindings #10379
Handle a breaking changes in os.networkInterfaces (#10611)
Add support to switch frame by id
Add support to switch frame by name (#10670)
[cdp] add support Chrome 102 and remove for Chrome 98
Update implementation for submitting forms

v4.1.2

chore/connect to CDP based on ENV selenium address var (#10255)
Add wheel support to actions
add support for Chrome 98 and remove support for Chrome 95
add deleteNetworkConditions for chromium (#10323)
Add new pointer attributes to actions
add support Chrome 99 and remove for Chrome 96
sendKeys error message fixed
add support Chrome 100 and remove for Chrome 97
removing onQuit handler for chromedriver (#10499)
Split String on grapheme pairs in sendKeys command (#10519)
do not convert tag name to css selector
docs: use Browser constants for browser name (#10567)

v4.1.1

Add support for installing unpacked addons at runtime in Firefox webdriver ( #10216)
Enables firefox debugger for devtools test
Sets correct browserName when set via SELENIUM_BROWSER fixes #10218
add support for Chrome v97
Adds new desktop cast command for Chromium #10190 (#10191)
ignore errors arising from trying to use file detector fixes #6343
Added RelativeBy class on the main api (#10148)
Code cleanup and minor improvements
Implements 'getDomAttribute' to get attribute value as defined by w3c spec and removes legacy command usages
Remove legacy JWP support and w3c switch (#10095)
update map/filter clean up to common format (#10094)

v4.1.0

add support for handling Shadow DOM elements
Capture browser console logs when using BiDi onLogEvent api
add CDP support for v96 and remove v93
remove useless package, change io public api import to more common approach ( #10037)
Fix flaky CDP dom mutation (#10029)
Fix edge test failures (#10012)
code cleanup second iteration (#9979)
Ensure correct serialization of extensions in chromium.Options (#6676)
Remove explicit id passing for CDP commands
Attach to page target while creating a CDP connection (#10005)
Add support for form submit in W3C mode (fixes #9916) (#9936)
Fixes relative locator 'locateWith' export
update doc string for CDP Commands (#9929)

v4.0.0

Fixes cdp for Chrome and Firefox (#9909)
Add cdp 95 to python and JS
Removing unused target for cdpConnection

v4.0.0-rc-2

Fix builder test
Allow builder to set a single arbitrary capability (#9857)
Restore withCapabilities() to ensure backward compatibility
Add new websocketUrl capability
update ruby, python and JS to add support for v94 and remove support for v92
Add a check for Grid CDP endpoint
Implement network request interceptions
Update connections to devtools so it works in Firefox and Chrome

v4.0.0-rc-1

Deprecates withCapabilities method and removes tests (#9701)
expose withLocator method at the top level
Enables Mobile feature for Firefox (Still need to expand this to chromium based browsers)
Add the ability to do Relative Locators with all By types. Fixes #9559
Add default Opera capabilities. Fixes #9654
Add support for ChromeDriver --enable-chrome-logs ( #9575) [Author: Mark Stacey]

The --enable-chrome-logs ChromeDriver option can now be enabled using the Chromium (or Chrome) ServiceBuilder, similarly to the other options provided by ChromeDriver.
Add the debuggerAddress option to chromium.js ( #9561) [Author: Brandon Walderman]
Adds http client options [#9638](Author: Dharin Shah)
Updating edge.js to extend chromium.driver (fixes #9626)

v4.0.0-beta.4

Add windowTypes option support for ChromiumDriver (#7897)
Allow relativeby with findElement (#9396)

v4.0.0-beta.3

Removed support for legacy actions. This will also remove "Bride Mode" support, which was introduced to translate of action class to legacy API.
Remove devtools support for v86,v87 and adding support for v89, v90, v91
make isPromise() return boolean value for null and undefined cases (#6785)
code cleanup (#9158)
replacing asserts equal with strictEqual and deepEqual with deepStrictEqual

v4.0.0-beta.2

Removed support for Edge legacy.
Make the build silent for WebDriver Bidi generated code
resolve file path correctly (#9223)
Update example in edge.js (#9231)
Use a flat namespace for selenium options for finding WebDriver Bidi endpoint
Removing duplicate license text updated by update_copyright.js
Updating copyright text
Minor code cleanup
Removing duplicate variable declaration of IE from capabilities

v4.0.0-beta.1

JS Binding support for WebDriver Bidi in Firefox
- This requires Firefox 87 and Geckodriver 0.29 to be able to work
Update the supported CDP versions
Update tmp package version (#9155)
Adding support for /computedlabel (getAccessibleName) (#9073)
Adding support for computedrole (#8990)
Use subfolder for NPM package homepage (#8938)
Fix typo: tracingCategories -> traceCategories (#8976)
Package up mutation-listener for node. Fixes #8955
Adding support for print endpoint (#8880)

v4.0.0-alpha.8

Rolling back native support for Opera Browser
Added new ieOptions capabilities:
- fileUploadDialogTimeout
- setEdgePath
- setEdgeChromium
- setScrollBehavior
- For consistent naming, deprecating addArguments(...args) in favor of addBrowserCommandSwitches(...args)
Added relative locators
Added Chrome DevTools Protocol (CDP) support
Added support for BASIC authentication.
Added listener for DOM mutations.
Added support for listening out for console log events.
Added support listening js exceptions using CDP

API Changes

Added the 'opera' module

v4.0.0-alpha.4

Changes

Removed BUILD.bazel files from the build artifact

v4.0.0-alpha.3

Notice

The minimum supported version of Node is now 10.15.0 LTS

Changes

add pollTimeout argument to the wait() method. Default value is 200ms
add switchTo().parentFrame() for non-W3C compatible drivers
add support for opening a new window

API Changes

Export lib/input.Origin from the top level selenium-webdriver module.
HTTP requests from this library will now include a User-Agent of the form selenium/${VERSION} (js ${PLATFORM}).

v4.0.0-alpha.1

Notice

The minimum supported version of Node is now 8.9.0 LTS

Changes to Supported Browsers

Native support has been removed for Opera and PhantomJS as the WebDriver implementations for these browsers are no longer under active development.

For Opera, users should be able to simply rely on testing Chrome as the Opera browser is based on Chromium (and the operadriver was a thin wrapper around chromedriver). For PhantomJS, users should use Chrome or Firefox in headless mode (see example/headless.js)

Changes for W3C WebDriver Spec Compliance

Revamped the actions API to conform with the WebDriver Spec: https://www.w3.org/TR/webdriver/#actions. For details, refer to the JS doc on the lib/input.Actions class.

As of January, 2018, only Firefox natively supports this new API. You can put the Actions class into "bridge mode" and it will attempt to translate mouse and keyboard actions to the legacy API ( see class docs). Alternatively, you may continue to use the legacy API directly via the lib/actions module. NOTE: The legacy API is considered strongly deprecated and will be removed in a minor release once Google's Chrome and Microsoft's Edge browsers support the new API.
All window manipulation commands are now supported.
Added driver.switchTo().parentFrame()
When a named cookie is requested, attempt to fetch it directly using the W3C endpoint, GET /session/{session id}/cookie/{name}. If this command is not recognized by the remote end, fallback to fetching all cookies and then searching for the desired name.
Replaced WebElement.getSize() and WebElement.getLocation() with a single method, WebElement.getRect().

API Changes

The core WebDriver API no longer uses promise manager
- Removed index.Builder#setControlFlow()
- The following thenable types no longer have a cancel() method:
- The dynamically generated thenable WebDrivers created by index.Builder
- lib/webdriver.AlertPromise
- lib/webdriver.WebElementPromise
Removed remote/index.DriverService.prototype.stop() (use #kill() instead)
Removed the lib/actions module
Removed the lib/events module
Removed the phantomjs module
Removed the 'opera' module
Removed the promise manager from lib/promise, which includes the removal of the following exported names (replacements, if any, in parentheses):
- CancellableThenable
- CancellationError
- ControlFlow
- Deferred
- LONG_STACK_TRACES
- MultipleUnhandledRejectionError
- Promise (use native Promises)
- Resolver
- Scheduler
- Thenable
- USE_PROMISE_MANAGER
- all (use Promise.all)
- asap (use Promise.resolve)
- captureStackTrace (use Error.captureStackTrace)
- consume (use async functions)
- controlFlow
- createPromise (use new Promise)
- defer
- fulfilled (use Promise.resolve)
- isGenerator
- rejected (use Promise.reject)
- setDefaultFlow
- when (use Promise.resolve)
Changes to the Builder class:
- Added setChromeService, setEdgeService, & setFirefoxService
- Removed setEnableNativeEvents
- Removed setScrollBehavior
Changes to chrome.Driver
- Added sendDevToolsCommand
- Added setDownloadPath
Changes to chrome.Options
- Now extends the Capabilities class
- Removed from/toCapabilities
Changes to edge.Options
- Now extends the Capabilities class
- Removed from/toCapabilities
Changes to ie.Options
- Now extends the Capabilities class
- Removed from/toCapabilities
Removed the firefox.Binary class. Custom binaries can still be selected using firefox.Options#setBinary(). Likewise, custom binary arguments can be specified with firefox.Options#addArguments().
Changes to firefox.Driver
- Added installAddon(path)
- Added uninstallAddon(id)
Changes to firefox.Options
- Now extends the Capabilities class
- Removed from/toCapabilities
- Removed setLoggingPreferences (was a no-op)
- setProfile now only accepts a path to an existing profile
- Added addExtensions
- Added setPreference
Removed the firefox.Profile class. All of its functionality is now provided directly by firefox.Options
Removed the firefox/binary module
Removed the firefox/profile module
Changes to safari.Options
- Now extends the Capabilities class
- Removed from/toCapabilities
- Removed setCleanSession (was a no-op)
Changes to lib/capabilities.Browser:
- Removed several enum values.
  - ANDROID (use Chrome for Android; see docs on the chrome module)
  - IPAD (no support available)
  - IPHONE (no support available)
  - OPERA (use Chrome)
  - PHANTOM_JS (use Chrome or Firefox in headless mode)
  - HTMLUNIT (use Chrome or Firefox in headless mode)
Changes to lib/capabilities.Capabilities:
- Removed static factory methods android(), ipad(), iphone(), opera(), phantomjs(), htmlunit(), and htmlunitwithjs(). Users can still manually configure capabilities for these, but their use is not recommended and they will no longer be surfaced in the API.
Changes to lib/error:
- Added
  - ElementClickInterceptedError
  - InsecureCertificateError
  - InvalidCoordinatesError
  - NoSuchCookieError
- Removed
  - ElementNotVisibleError
  - InvalidElementCoordinatesError
Changes to lib/webdriver.WebDriver:
- Dropped support for "requiredCapabilities" from WebDriver.createSession
- actions() now returns the new lib/input.Actions class
- Removed touchActions
- Renamed schedule to execute
- Removed the WebDriver.attachToSession() factory method. Users can just the WebDriver constructor directly instead.
- Removed the call() method. This was used to inject custom function calls into the control flow. Now that the promise manager is no longer used, this method is no longer necessary. Users are now responsible for coordinating actions (ideally with async functions) and can just call functions directly instead of through driver.call().
Changes to lib/webdriver.WebElement:
- Replaced getSize & getLocation with getRect
Changes to lib/webdriver.Alert:
- Removed authenticateAs
Changes to lib/webdriver.Options (driver.manage()):
- Removed timeouts (use get/setTimeouts)
Changes to lib/webdriver.Window (driver.manage().window()):
- Added
  - getRect
  - setRect
  - fullscreen
  - minimize
- Removed (use the getRect/setRect methods)
  - getPosition
  - setPosition
  - getSize
  - setSize
Removed the testing/assert module
Changes to testing/index
- Since the promise manager has been removed, it is no longer necessary to wrap the Mocha test hooks; instead, users can simply use async functions. The following have all been removed:
  - describe
  - before
  - beforeEach
  - after
  - afterEach
  - it
- Added the suite function. For details, refer to the jsdoc or example/google_search_test.js

v3.6.0

Bug Fixes

The Capabilities factory methods should only specify the name of the browser.
Protect against the remote end sometimes not returning a list to findElements commands.
Properly reset state in remote.DriverService#kill()
The firefox module will no longer apply the preferences required by the legacy FirefoxDriver. These preferences were only required when using the legacy driver, support for which was dropped in v3.5.0.

API Changes

Added new methods to selenium-webdriver/firefox.Options:
- addArguments()
- headless()
- windowSize()
Deprecated selenium-webdriver/firefox/binary.Binary
Removed selenium-webdriver/firefox.Options#useGeckoDriver()
Removed the unused selenium-webdriver/firefox/profile.decode()
Removed methods from selenium-webdriver/firefox/profile.Profile that had no effect since support for the legacy FirefoxDriver was dropped in 3.5.0:
- setNativeEventsEnabled
- nativeEventsEnabled
- getPort
- setPort
Removed selenium-webdriver/firefox.ServiceBuilder#setFirefoxBinary(); custom binaries should be configured through the firefox.Options class.
Removed selenium-webdriver/firefox.Capability. These hold overs from the legacy FirefoxDriver are no longer supported.

Changes for W3C WebDriver Spec Compliance

Deprecated error.ElementNotVisibleError in favor of the more generic error.ElementNotInteractableError.
Support the httpOnly option when adding a cookie.

v3.5.0

Notice

Native support for Firefox 45 (ESR) has been removed. Users will have to connect to a remote Selenium server that supports Firefox 45.

Changes

Removed native support for Firefox 46 and older.
- The SELENIUM_MARIONETTE environment variable no longer has an effect.
- selenium-webdriver/firefox.Capability.MARIONETTE is deprecated.
- selenium-webdriver/firefox.Options#useGeckoDriver() is deprecated and now a no-op.
firefox.Options will no longer discard the "moz:firefoxOptions" set in user provided capabilities (via Builder.withCapabilities({})). When both are used, the settings in firefox.Options will be applied last.
Added chrome.Options#headless() and chrome.Options#windowSize(), which may be used to start Chrome in headless mode (requires Chrome 59+) and to set the initial window size, respectively.

Changes for W3C WebDriver Spec Compliance

Added error.WebDriverError#remoteStacktrace to capture the stacktrace reported by a remote WebDriver endpoint (if any).
Fixed WebElement#sendKeys to send text as a string instead of an array of strings.

v3.4.0

Notice

This release requires geckodriver 0.15.0 or newer.

API Changes

Added Options#getTimeouts() for retrieving the currently configured session timeouts (i.e. implicit wait). This method will only work with W3C compatible WebDriver implementations.
Deprecated the Timeouts class in favor of Options#setTimeouts(), which supports setting multiple timeouts at once.
Added support for emulating different network conditions (e.g., offline, 2G, WiFi) on Chrome.

Changes for W3C WebDriver Spec Compliance

Fixed W3C response parsing, which expects response data to always be a JSON object with a value key.
Added W3C endpoints for interacting with various types of user prompts.
Added W3C endpoints for remotely executing scripts.
Added W3C endpoints to get current window handle and all windows handles.

v3.3.0

Added warning log messages when the user creates new managed promises, or schedules unchained tasks. Users may opt in to printing these log messages with

const { logging } = require('selenium-webdriver')
logging.installConsoleHandler()
logging.getLogger('promise.ControlFlow').setLevel(logging.Level.WARNING)

If the JAVA_HOME environment variable is set, use it to locate java.exe.

v3.2.0

Release skipped to stay in sync with the main Selenium project.

v3.1.0

The lib package is once again platform agnostic (excluding lib/devmode).
Deprecated promise.when(value, callback, errback). Use promise.fulfilled(value).then(callback, errback)
Changed promise.fulfilled(value), promise.rejected(reason) and promise.defer() to all use native promises when the promise manager is disabled.
Properly handle W3C error responses to new session commands.
Updated selenium-webdriver/testing to export describe.only along with describe.skip.
Fixed selenium-webdriver/lib/until.ableToSwitchToFrame. It was previously dropping arguments and would never work.
Added the ability to use Firefox Nightly
If Firefox cannot be found in the default location, look for it on the PATH
Allow SafariDriver to use Safari Technology Preview.
Use the proper wire command for WebElement.getLocation() and WebElement.getSize() for W3C compliant drivers.

v3.0.1

More API adjustments to align with native Promises
- Deprecated promise.fulfilled(value), use promise.Promise#resolve(value)
- Deprecated promise.rejected(reason), use promise.Promise#reject(reason)
When a wait() condition times out, the returned promise will now be rejected with an error.TimeoutError instead of a generic Error object.
WebDriver#wait() will now throw a TypeError if an invalid wait condition is provided.
Properly catch unhandled promise rejections with an action sequence (only impacts when the promise manager is disabled).

v3.0.0

(NOTICE) The minimum supported version of Node is now 6.9.0 LTS
Removed support for the SafariDriver browser extension. This has been replaced by Apple's safaridriver, which is included with Safari 10 (available on OS X El Capitan and macOS Sierra).

To use Safari 9 or older, users will have to use an older version of Selenium.
geckodriver v0.11.0 or newer is now required for Firefox.
Fixed potential reference errors in selenium-webdriver/testing when users create a cycle with mocha by running with mocha's --hook flag.
Fixed WebDriver.switchTo().activeElement() to use the correct HTTP method for compatibility with the W3C spec.
Update the selenium-webdriver/firefox module to use geckodriver's "moz:firefoxOptions" dictionary for Firefox-specific configuration values.
Extending the selenium-webdriver/testing module to support tests defined using generator functions.
The promise manager can be disabled by setting an environment variable: SELENIUM_PROMISE_MANAGER=0. This is part of a larger plan to remove the promise manager, as documented at #2969
When communicating with a W3C-compliant remote end, use the atoms library for the WebElement.getAttribute() and WebElement.isDisplayed() commands. This behavior is consistent with the java, .net, python, and ruby clients.

API Changes

Removed safari.Options#useLegacyDriver()
Reduced the API on promise.Thenable for compatibility with native promises:
- Removed #isPending()
- Removed #cancel()
- Removed #finally()
Changed all subclasses of webdriver.WebDriver to overload the static function WebDriver.createSession() instead of doing work in the constructor. All constructors now inherit the base class' function signature. Users are still encouraged to use the Builder class instead of creating drivers directly.
Builder#build() now returns a "thenable" WebDriver instance, allowing users to immediately schedule commands (as before), or issue them through standard promise callbacks. This is the same pattern already employed for WebElements.
Removed Builder#buildAsync() as it was redundant with the new semantics of build().

v3.0.0-beta-3

Fixed a bug where the promise manager would silently drop callbacks after recovering from an unhandled promise rejection.
Added the firefox.ServiceBuilder class, which may be used to customize the geckodriver used for firefox.Driver instances.
Added support for Safari 10 safaridriver. safaridriver may be disabled via tha API, safari.Options#useLegacyDriver, to use the safari extension driver.
Updated the lib/proxy module to support configuring a SOCKS proxy.
For the promise.ControlFlow, fire the "uncaughtException" event in a new turn of the JS event loop. As a result of this change, any errors thrown by an event listener will propagate to the global error handler. Previously, this event was fired with in the context of a (native) promise callback, causing errors to be silently suppressed in the promise chain.

API Changes

Added remote.DriverService.Builder as a base class for configuring DriverService instances that run in a child-process. The chrome.ServiceBuilder, edge.ServiceBuilder, and opera.ServiceBuilder classes now all extend this base class with browser-specific options.
For each of the ServiceBuilder classes, renamed usingPort and withEnvironment to setPort and setEnvironment, respectively.
Renamed chrome.ServiceBuilder#setUrlBasePath to #setPath
Changed the signature of the firefox.Driver from (config, flow, executor) to (config, executor, flow).
Exposed the Condition and WebElementCondition classes from the top-level selenium-webdriver module (these were previously only available from lib/webdriver).

Changes for W3C WebDriver Spec Compliance

Updated command mappings for getting and setting the window position.

v3.0.0-beta-2

API Changes

Moved the builder.Builder class into the main module (selenium-webdriver).
Removed the builder module.
Fix webdriver.WebDriver#setFileDetector when driving Chrome or Firefox on a remote machine.

v3.0.0-beta-1

Allow users to set the agent used for HTTP connections through builder.Builder#usingHttpAgent()
Added new wait conditions: until.urlIs(), until.urlContains(), until.urlMatches()
Added work around for GeckoDriver bug raising a type conversion error
Internal cleanup replacing uses of managed promises with native promises
Removed the mandatory use of Firefox Dev Edition, when using Marionette driver
Fixed timeouts' URL
Properly send HTTP requests when using a WebDriver server proxy
Properly configure proxies when using the geckodriver
http.Executor now accepts a promised client. The builder.Builder class will now use this instead of a command.DeferredExecutor when creating WebDriver instances.
For Chrome and Firefox, the builder.Builder class will always return an instanceof chrome.Driver and firefox.Driver, respectively, even when configured to use a remote server (from builder.Builder#usingServer(url), SELENIUM_REMOTE_URL, etc).

API Changes

promise.Deferred is no longer a thenable object.
Options#addCookie() now takes a record object instead of 7 individual parameters. A TypeError will be thrown if addCookie() is called with invalid arguments.
When adding cookies, the desired expiry must be provided as a Date or in seconds since epoch. When retrieving cookies, the expiration is always returned in seconds.
Renamed firefox.Options#useMarionette to firefox.Options#useGeckoDriver
Removed deprecated modules:
- selenium-webdriver/error (use selenium-webdriver/lib/error,
  or the error property exported by selenium-webdriver)
- selenium-webdriver/executors — this was not previously deprecated, but is no longer used.
Removed deprecated types:
- command.DeferredExecutor — this was not previously deprecated, but is no longer used. It can be trivially implemented by clients should it be needed.
- error.InvalidSessionIdError (use error.NoSuchSessionError)
- executors.DeferredExecutor
- until.Condition (use webdriver.Condition)
- until.WebElementCondition (use webdriver.WebElementCondition)
- webdriver.UnhandledAlertError (use error.UnexpectedAlertOpenError)
Removed deprecated functions:
- Deferred#cancel()
- Deferred#catch()
- Deferred#finally()
- Deferred#isPending()
- Deferred#then()
- Promise#thenCatch()
- Promise#thenFinally()
- WebDriver#isElementPresent()
- WebElement#getInnerHtml()
- WebElement#getOuterHtml()
- WebElement#getRawId()
- WebElement#isElementPresent()
Removed deprecated properties:
- WebDriverError#code

v2.53.2

Changed io.exists() to return a rejected promise if the input path is not a string
Deprecated Promise#thenFinally() - use Promise#finally(). The thenFinally shim added to the promise module in v2.53.0 will be removed in v3.0 Sorry for the churn!
FIXED: capabilities serialization now properly handles undefined vs. false-like values.
FIXED: properly handle responses from the remote end in WebDriver.attachToSession

v2.53.1

FIXED: for consistency with the other language bindings, remote.FileDetector will ignore paths that refer to a directory.

v2.53.0

Change Summary

Added preliminary support for Marionette, Mozilla's WebDriver implementation for Firefox. Marionette may be enabled via the API, firefox.Options#useMarionette, or by setting the SELENIUM_MARIONETTE environment variable.
Moved all logic for parsing and interpreting responses from the remote end into the individual command.Executor implementations.
For consistency with the other Selenium language bindings, WebDriver#isElementPresent() and WebElement#isElementPresent() have been deprecated. These methods will be removed in v3.0. Use the findElements command to test for the presence of an element:
```
driver.findElements(By.css('.foo')).then(found => !!found.length);
```
Added support for W3C-spec compliant servers.
For consistent naming, deprecating error.InvalidSessionIdError in favor of error.NoSuchSessionError.
Moved the error module to lib/error so all core modules are co-located. The top-level error module will be removed in v3.0.
Moved until.Condition and until.WebElementCondition to the webdriver module to break a circular dependency.
Added support for setting the username and password in basic auth pop-up dialogs (currently IE only).
Deprecated WebElement#getInnerHtml() and WebEleemnt#getOuterHtml()
Deprecated Promise#thenCatch() - use Promise#catch() instead
Deprecated Promise#thenFinally() - use promise.thenFinally() instead
FIXED: io.findInPath() will no longer match against directories that have the same basename as the target file.
FIXED: phantomjs.Driver now takes a third argument that defines the path to a log file to use for the phantomjs executable's output. This may be quickly set at runtime with the SELENIUM_PHANTOMJS_LOG environment variable.

Changes for W3C WebDriver Spec Compliance

Changed element.sendKeys(...) to send the key sequence as an array where each element defines a single key. The legacy wire protocol permits arrays where each element is a string of arbitrary length. This change is solely at the protocol level and should have no user-visible effect.

v2.52.0

Notice

Starting with v2.52.0, each release of selenium-webdriver will support the latest minor LTS and stable Node releases. All releases between the LTS and stable release will have best effort support. Further details are available in the selenium-webdriver package README.

Change Summary

Add support for Microsoft's Edge web browser
Added webdriver.Builder#buildAsync(), which returns a promise that will be fulfilled with the newly created WebDriver instance once the associated browser has been full initialized. This is purely a convenient alternative to the existing build() method as the WebDriver class will always defer commands until it has a fully created browser.
Added firefox.Profile#setHost() which may be used to set the host that the FirefoxDriver's server listens for commands on. The server uses "localhost" by default.
Added promise.Promise#catch() for API compatibility with native Promises. promise.Promise#thenCatch() is not yet deprecated, but it simply delegates to catch.
Changed some io operations to use native promises.
Changed command.Executor#execute() and HttpClient#send() to return promises instead of using callback passing.
Replaced the Serializable class with an internal, Symbol-defined method.
Changed the Capabilities class to extend the native Map type.
Changed the Capabilities.has(key) to only test if a capability has been set (Map semantics). To check whether the value is true, use get(key).
Deprecated executors.DeferredExecutor in favor of lib/command.DeferredExecutor.
API documentation is no longer distributed with the npm package, but remains available at http://seleniumhq.github.io/selenium/docs/api/javascript/
Rewrote the error module to export an Error subtype for each type of error defined in the W3C WebDriver spec.
Changed the http.Request and http.Response classes to store headers in maps instead of object literals.
Updated ws dependency to version 1.0.1.
Removed fluent predicates "is" and "not" from the experimental testing/assert module.
Wait conditions that locate an element, or that wait on an element's state, will return a WebElementPromise.
Lots of internal clean-up to break selenium-webdriver's long standing dependency on Google's Closure library.

Changes for W3C WebDriver Spec Compliance

Updated the By locators that are not in the W3C spec to delegated to using CSS selectors: By.className, By.id, By.name, and By.tagName.

v2.49-51

Releases skipped to stay in sync with the rest of the Selenium project

v2.48.2

Added WebElement#takeScreenshot().
More adjustments to promise callback tracking.

v2.48.1

FIXED: Adjusted how the control flow tracks promise callbacks to avoid a potential deadlock.

v2.48.0

Node v0.12.x users must run with --harmony. This is the last release that will support v0.12.x
FIXED: (Promise/A+ compliance) When a promise is rejected with a thenable, the promise adopts the thenable as its rejection reason instead of waiting for it to settle. The previous (incorrect) behavior was hidden by bugs in the promises-aplus-tests compliance test suite that were fixed in version 2.1.1.
FIXED: the webdriver.promise.ControlFlow now has a consistent execution order for tasks/callbacks scheduled in different turns of the JS event loop. Refer to the webdriver.promise documentation for more details.
FIXED: do not drop user auth from the WebDriver server URL.

FIXED: a single firefox.Binary instance may be used to configure and launch multiple FirefoxDriver sessions.

var binary = new firefox.Binary();
var options = new firefox.Options().setBinary(binary);
var builder = new Builder().setFirefoxOptions(options);

var driver1 = builder.build();
var driver2 = builder.build();

FIXED: zip files created for transfer to a remote WebDriver server are no longer compressed. If the zip contained a file that was already compressed, the server would return an "invalid code lengths set" error.
FIXED: Surfaced the loopback option to remote/SeleniumServer. When set, the server will be accessed using the current host's loopback address.

v2.47.0

Notice

This is the last release for selenium-webdriver that will support ES5. Subsequent releases will depend on ES6 features that are enabled by default in Node v4.0.0. Node v0.12.x will continue to be supported, but will require setting the --harmony flag.

Change Summary

Add support for Node v4.0.0
- Updated ws dependency from 0.7.1 to 0.8.0
Bumped the minimum supported version of Node from 0.10.x to 0.12.x. This is in accordance with the Node support policy established in v2.45.0.

v2.46.1

Fixed internal module loading on Windows.
Fixed error message format on timeouts for until.elementLocated() and until.elementsLocated().

v2.46.0

Exposed a new logging API via the webdriver.logging module. For usage, see example/logging.js.
Added support for using a proxy server for WebDriver commands. See Builder#usingWebDriverProxy() for more info.
Removed deprecated functions:
- Capabilities#toJSON()
- UnhandledAlertError#getAlert()
- chrome.createDriver()
- phantomjs.createDriver()
- promise.ControlFlow#annotateError()
- promise.ControlFlow#await()
- promise.ControlFlow#clearHistory()
- promise.ControlFlow#getHistory()
Removed deprecated enum values: ErrorCode.NO_MODAL_DIALOG_OPEN and ErrorCode.MODAL_DIALOG_OPENED. Use ErrorCode.NO_SUCH_ALERT and ErrorCode.UNEXPECTED_ALERT_OPEN, respectively.
FIXED: The promise.ControlFlow will maintain state for promise chains generated in a loop.
FIXED: Correct serialize target elements used in an action sequence.
FIXED: promise.ControlFlow#wait() now has consistent semantics for an omitted or 0-timeout: it will wait indefinitely.
FIXED: remote.DriverService#start() will now fail if the child process dies while waiting for the server to start accepting requests. Previously, start would continue to poll the server address until the timeout expired.
FIXED: Skip launching Firefox with the -silent flag to preheat the profile. Starting with Firefox 38, this would cause the browser to crash. This step, which was first introduced for Selenium's java client back with Firefox 2, no longer appears to be required.
FIXED: 8564: firefox.Driver#quit() will wait for the Firefox process to terminate before deleting the temporary webdriver profile. This eliminates a race condition where Firefox would write profile data during shutdown, causing the rm -rf operation on the profile directory to fail.

v2.45.1

FIXED: 8548: Task callbacks are once again dropped if the task was cancelled due to a previously uncaught error within the frame.
FIXED: 8496: Extended the chrome.Options API to cover all configuration options (e.g. mobile emulation and performance logging) documented on the ChromeDriver project site.

v2.45.0

Important Policy Change

Starting with the 2.45.0 release, selenium-webdriver will support the last two stable minor releases for Node. For 2.45.0, this means Selenium will support Node 0.10.x and 0.12.x. Support for the intermediate, un-stable release (0.11.x) is "best-effort". This policy will be re-evaluated once Node has a major version release (i.e. 1.0.0).

Change Summary

Added native browser support for Internet Explorer, Opera 26+, and Safari
With the release of Node 0.12.0 (finally!), the minimum supported version of Node is now 0.10.x.

The promise module is now Promises/A+ compliant. The biggest compliance change is that promise callbacks are now invoked in a future turn of the JS event loop. For example:

  var promise = require('selenium-webdriver').promise;
  console.log('start');
  promise.fulfilled().then(function() {
    console.log('middle');
  });
  console.log('end');

  // Output in selenium-webdriver@2.44.0
  // start
  // middle
  // end
  //
  // Output in selenium-webdriver@2.45.0
  // start
  // end
  // middle

The promise.ControlFlow class has been updated to track the asynchronous breaks required by Promises/A+, so there are no changes to task execution order.

Updated how errors are annotated on failures. When a task fails, the stacktrace from when that task was scheduled is appended to the rejection reason with a From: prefix ( if it is an Error object). For example:

  var driver = new webdriver.Builder().forBrowser('chrome').build();
  driver.get('http://www.google.com/ncr');
  driver.call(function() {
    driver.wait(function() {
      return driver.isElementPresent(webdriver.By.id('not-there'));
    }, 2000, 'element not found');
  });

This code will fail an error like:

  Error: element not found
  Wait timed out after 2002ms
      at <stack trace>
  From: Task: element not found
      at <stack trace>
  From: Task: WebDriver.call(function)
      at <stack trace>

Changed the format of strings returned by promise.ControlFlow#getSchedule. This function now accepts a boolean to control whether the returned string should include the stacktraces for when each task was scheduled.
Deprecating promise.ControlFlow#getHistory, promise.ControlFlow#clearHistory, and promise.ControlFlow#annotateError. These functions were all intended for internal use and are no longer necessary, so they have been made no-ops.
WebDriver.wait() may now be used to wait for a promise to resolve, with an optional timeout. Refer to the API documentation for more information.
Added support for copying files to a remote Selenium via sendKeys to test file uploads. Refer to the API documentation for more information. Sample usage included in test/upload_test.js
Expanded the interactions API to include touch actions. See WebDriver.touchActions().
FIXED: 8380: firefox.Driver will delete its temporary profile on quit.
FIXED: 8306: Stack overflow in promise callbacks eliminated.
FIXED: 8221: Added support for defining custom command mappings. Includes support for PhantomJS's executePhantomJS (requires PhantomJS 1.9.7 or GhostDriver 1.1.0).
FIXED: 8128: When the FirefoxDriver marshals an object to the page for executeScript, it defines additional properties (required by the driver's implementation). These properties will no longer be enumerable and should be omitted (i.e. they won't show up in JSON.stringify output).
FIXED: 8094: The control flow will no longer deadlock when a task returns a promise that depends on the completion of sub-tasks.

v2.44.0

Added the until module, which defines common explicit wait conditions. Sample usage:

  var firefox = require('selenium-webdriver/firefox'),
      until = require('selenium-webdriver/until');

  var driver = new firefox.Driver();
  driver.get('http://www.google.com/ncr');
  driver.wait(until.titleIs('Google Search'), 1000);

FIXED: 8000: Builder.forBrowser() now accepts an empty string since some WebDriver implementations ignore the value. A value must still be specified, however, since it is a required field in WebDriver's wire protocol.
FIXED: 7994: The stacktrace module will not modify stack traces if the initial parse fails (e.g. the user defined Error.prepareStackTrace)
FIXED: 5855: Added a module (until) that defines several common conditions for use with explicit waits. See updated examples for usage.

v2.43.5

FIXED: 7905: Builder.usingServer(url) once again returns this for chaining.

v2.43.2-4

No changes; version bumps while attempting to work around an issue with publishing to npm (a version string may only be used once).

v2.43.1

Fixed an issue with flakiness when setting up the Firefox profile that could prevent the driver from initializing properly.

v2.43.0

Added native support for Firefox - the Java Selenium server is no longer required.
Added support for generator functions to ControlFlow#execute and ControlFlow#wait. For more information, see documentation on webdriver.promise.consume. Requires harmony support (run with node --harmony-generators in v0.11.x).
Various improvements to the Builder API. Notably, the build() function will no longer default to attempting to use a server at http://localhost:4444/wd/hub if it cannot start a browser directly - you must specify the WebDriver server with usingServer(url). You can also set the target browser and WebDriver server through a pair of environment variables. See the documentation on the Builder constructor for more information.

For consistency with the other language bindings, added browser specific classes that can be used to start a browser without the builder.

  var webdriver = require('selenium-webdriver')
      chrome = require('selenium-webdriver/chrome');

  // The following are equivalent.
  var driver1 = new webdriver.Builder().forBrowser('chrome').build();
  var driver2 = new chrome.Driver();

Promise A+ compliance: a promise may no longer resolve to itself.
For consistency with other language bindings, deprecated UnhandledAlertError#getAlert and added #getAlertText. getAlert will be removed in 2.45.0.
FIXED: 7641: Deprecated ErrorCode.NO_MODAL_DIALOG_OPEN and ErrorCode.MODAL_DIALOG_OPENED in favor of the new ErrorCode.NO_SUCH_ALERT and ErrorCode.UNEXPECTED_ALERT_OPEN, respectively.
FIXED: 7563: Mocha integration no longer disables timeouts. Default Mocha timeouts apply (2000 ms) and may be changed using this.timeout(ms).
FIXED: 7470: Make it easier to create WebDriver instances in custom flows for parallel execution.

v2.42.1

FIXED: 7465: Fixed net.getLoopbackAddress on Windows
FIXED: 7277: Support done callback in Mocha's BDD interface
FIXED: 7156: Promise#thenFinally should not suppress original error

v2.42.0

Removed deprecated functions Promise#addCallback(), Promise#addCallbacks(), Promise#addErrback(), and Promise#addBoth().
Fail with a more descriptive error if the server returns a malformed redirect
FIXED: 7300: Connect to ChromeDriver using the loopback address since ChromeDriver 2.10.267517 binds to localhost by default.
FIXED: 7339: Preserve wrapped test function's string representation for Mocha' s BDD interface.

v2.41.0

FIXED: 7138: export logging API from webdriver module.
FIXED: 7105: beforeEach/it/afterEach properly bind this for Mocha tests.

v2.40.0

API documentation is now included in the docs directory.
Added utility functions for working with an array of promises: promise.all, promise.map, and promise.filter
Introduced Promise#thenCatch() and Promise#thenFinally().
Deprecated Promise#addCallback(), Promise#addCallbacks(), Promise#addErrback(), and Promise#addBoth().
Removed deprecated function webdriver.WebDriver#getCapability.
FIXED: 6826: Added support for custom locators.

v2.39.0

Version bump to stay in sync with the Selenium project.

v2.38.1

FIXED: 6686: Changed webdriver.promise.Deferred#cancel() to silently no-op if the deferred has already been resolved.

v2.38.0

When a promise is rejected, always annotate the stacktrace with the parent flow state so users can identify the source of an error.
Updated tests to reflect features not working correctly in the SafariDriver (cookie management and proxy support; see issues 5051, 5212, and 5503)
FIXED: 6284: For mouse moves, correctly omit the x/y offsets if not specified as a function argument (instead of passing (0,0)).
FIXED: 6471: Updated documentation on webdriver.WebElement#getAttribute
FIXED: 6612: On Unix, use the default IANA ephemeral port range if unable to retrieve the current system's port range.
FIXED: 6617: Avoid triggering the node debugger when initializing the stacktrace module.
FIXED: 6627: Safely rebuild chrome.Options from a partial JSON spec.

v2.37.0

FIXED: 6346: The remote.SeleniumServer class now accepts JVM arguments using the jvmArgs option.

v2.36.0

Release skipped to stay in sync with main Selenium project.

v2.35.2

FIXED: 6200: Pass arguments to the Selenium server instead of to the JVM.

v2.35.1

FIXED: 6090: Changed example scripts to use chromedriver.

v2.35.0

Version bump to stay in sync with the Selenium project.

v2.34.1

FIXED: 6079: The parent process should not wait for spawn driver service processes (chromedriver, phantomjs, etc.)

v2.34.0

Added the selenium-webdriver/testing/assert module. This module simplifies writing assertions against promised values (see example in module documentation).
Added the webdriver.Capabilities class.

Added native support for the ChromeDriver. When using the Builder, requesting chrome without specifying a remote server URL will default to the native ChromeDriver implementation. The ChromeDriver server must be downloaded separately.

  // Will start ChromeDriver locally.
  var driver = new webdriver.Builder().
      withCapabilities(webdriver.Capabilities.chrome()).
      build();

  // Will start ChromeDriver using the remote server.
  var driver = new webdriver.Builder().
      withCapabilities(webdriver.Capabilities.chrome()).
      usingServer('http://server:1234/wd/hub').
      build();

Added support for configuring proxies through the builder. For examples, see selenium-webdriver/test/proxy_test.
Added native support for PhantomJS.
Changed signature of SeleniumServer to SeleniumServer(jar, options).
Tests are now included in the npm published package. See README.md for execution instructions
Removed the deprecated webdriver.Deferred#resolve and webdriver.promise.resolved functions.
Removed the ability to connect to an existing session from the Builder. This feature is intended for use with the browser-based client.

v2.33.0

Added support for WebDriver's logging API
FIXED: 5511: Added webdriver.manage().timeouts().pageLoadTimeout(ms)

v2.32.1

FIXED: 5541: Added missing return statement for windows in portprober.findFreePort()

v2.32.0

Added the selenium-webdriver/testing package, which provides a basic framework for writing tests using Mocha. See selenium-webdriver/example/google_search_test.js for usage.
For Promises/A+ compatibility, backing out the change in 2.30.0 that ensured rejections were always Error objects. Rejection reasons are now left as is.
Removed deprecated functions originally scheduled for removal in 2.31.0
- promise.Application.getInstance()
- promise.ControlFlow#schedule()
- promise.ControlFlow#scheduleTimeout()
- promise.ControlFlow#scheduleWait()
Renamed some functions for consistency with Promises/A+ terminology. The original functions have been deprecated and will be removed in 2.34.0:
- promise.resolved() -> promise.fulfilled()
- promise.Deferred#resolve() -> promise.Deferred#fulfill()
FIXED: remote.SeleniumServer#stop now shuts down within the active control flow, allowing scripts to finish. Use #kill to shutdown immediately.
FIXED: 5321: cookie deletion commands

v2.31.0

Added an example script.
Added a class for controlling the standalone Selenium server (server available separately)
Added a portprober for finding free ports
FIXED: WebElements now belong to the same flow as their parent driver.

v2.30.0

Ensures promise rejections are always Error values.
Version bump to keep in sync with the Selenium project.

v2.29.1

Fixed a bug that could lead to an infinite loop.
Added a README.md

v2.29.0

Initial release for npm:
```
  npm install selenium-webdriver
```

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!