| ## v4.10.0 |
| |
| #### :nail_care: Polish |
| |
| * Adding CDP v114 and removing v111 |
| |
| #### :rocket: 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 |
| |
| #### :nail_care: Polish |
| |
| * Handle rejection of the driver if not found |
| |
| ## v4.9.1 |
| |
| #### :nail_care: Polish |
| |
| * Add CDP files for v113 and remove v110 |
| |
| ## v4.9.0 |
| |
| #### :nail_care: Polish |
| |
| * Adding CDP v112 and removing v109 |
| |
| #### :bug: 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) |
| |
| #### :rocket: 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 |
| |
| #### :nail_care: Polish |
| |
| * Add CDP support for v111 and remove v108 |
| * Using json output with Selenium Manager |
| |
| #### :bug: Bug Fix |
| |
| * fix: Using status from response (#11742) |
| |
| ## v4.8.1 |
| |
| #### :rocket: New Feature |
| |
| * Add script pinning (#11584) |
| |
| #### :nail_care: Polish |
| |
| * Add CDP support for v110 and remove v107 |
| * Updating Selenium Manager binaries for 4.8.1 release |
| |
| #### :bug: Bug Fix |
| |
| fix: iedriver download with selenium-manager #11579 |
| |
| ## v4.8.0 |
| |
| #### :rocket: 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) |
| |
| #### :nail_care: Polish |
| |
| * Add CDP support for v109 and remove v106 |
| * Deprecate setHeadless() in Chrome and Firefox (#11467) |
| |
| ## v4.7.1 |
| |
| #### :nail_care: Polish |
| |
| * feat/deprecation message for standalone3x (#11422) |
| |
| #### :bug: Bug Fix |
| |
| * feat/fix spawn format for SeleniumServer, issue 11405 (#11412) |
| |
| #### Committers: 1 |
| |
| * Potapov Dmitriy ([@potapovDim](https://github.com/potapovDim)) |
| |
| ## v4.7.0 |
| |
| #### :rocket: New Feature |
| |
| * Add support for Selenium Manager to work with IE Driver |
| |
| #### :nail_care: Polish |
| |
| * Adding CDP files for v108 and removing v105 |
| * Improve error handling for Selenium Manager |
| |
| ## v4.6.1 |
| |
| #### :bug: Bug Fix |
| |
| * Support Node 17 and above (#11262) |
| |
| #### :nail_care: Polish |
| |
| * Fix typos (#11258) |
| |
| ## v4.6.0 |
| |
| #### :rocket: 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: Bug Fix |
| |
| * isPromise() thenable fix (#11048) |
| * Fix: making methods static (#11182) |
| |
| #### :nail_care: Polish |
| |
| * fix a tiny typo in chromium.js (#11073) |
| * Adding CDP files for v107 and removing v104 |
| |
| ## v4.5.0 |
| |
| #### :rocket: 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: 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](https://github.com/SeleniumHQ/selenium/commit/fa6deeea6bda1e73317157845772e114bd569b7d)) |
| * fix: "SetExperimental" option is not available in webdriverjs (Javascript/Typescript) (#10959) |
| * fix: Do not allow Select class to select disabled options (#10812) |
| |
| #### :nail_care: 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<boolean> 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 `200`ms |
| * 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` enviornment 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](https://github.com/mozilla/geckodriver/releases/tag/v0.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](https://w3c.github.io/webdriver/webdriver-spec.html#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 |
| |
| ```js |
| 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 wtih 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 enviornment variable: |
| `SELENIUM_PROMISE_MANAGER=0`. This is part of a larger plan to remove the promise manager, as |
| documented at |
| <https://github.com/SeleniumHQ/selenium/issues/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](https://w3c.github.io/webdriver/webdriver-spec.html#get-window-position) |
| and [setting](https://w3c.github.io/webdriver/webdriver-spec.html#set-window-position) |
| 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](https://bugzilla.mozilla.org/show_bug.cgi?id=1274924) |
| 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](https://w3c.github.io/webdriver/webdriver-spec.html#handling-errors). |
| * 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](https://nodejs.org/en/docs/es6/) 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](https://nodejs.org/en/blog/release/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](https://chromedriver.chromium.org/capabilities). |
| |
| ## 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](http://blog.nodejs.org/2015/02/06/node-v0-12-0-stable/) |
| (finally!), the minimum supported version of Node is now `0.10.x`. |
| * The `promise` module is now [Promises/A+](https://promisesaplus.com/) |
| 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 [email protected] |
| // start |
| // middle |
| // end |
| // |
| // Output in [email protected] |
| // 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](https://code.google.com/p/chromedriver/downloads/list) |
| 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 |
