Find Similar Packages for selenium-webdriver
Search packages..
1 Year
selenium-webdriverSimilar Packages:
NPM Package Downloads Trend
Stat Detail
Package
Downloads
Stars
Size
Issues
Publish
License
selenium-webdriver1,210,00831,05318.4 MB239a month agoApache-2.0
Similar Npm Packages to selenium-webdriver

selenium-webdriver is a popular library for automating web browsers. It provides a robust framework for writing tests and automating user interactions with web applications. Selenium WebDriver supports multiple programming languages and allows developers to control browsers programmatically, making it an essential tool for end-to-end testing. While Selenium WebDriver is widely used, there are several alternatives that offer different features and capabilities. Here are a few notable options:

  • nightwatch is an end-to-end testing framework that uses the Selenium WebDriver API. It is designed for easy setup and execution of tests, providing a simple syntax for writing tests in JavaScript. Nightwatch comes with built-in support for running tests in various browsers and can be easily integrated with CI/CD pipelines. If you are looking for a straightforward testing framework that leverages Selenium while providing additional features like automatic waiting and easy configuration, Nightwatch is a great choice.

  • puppeteer is a Node.js library that provides a high-level API for controlling headless Chrome or Chromium browsers. Unlike Selenium, which supports multiple browsers, Puppeteer is specifically designed for Chrome and offers powerful features such as taking screenshots, generating PDFs, and scraping web pages. If your primary focus is on testing or automating tasks in Chrome, Puppeteer is an excellent option due to its speed and ease of use.

  • webdriverio is a custom implementation of Selenium's WebDriver API that is designed to be simple and easy to use. It supports both WebDriver and DevTools protocols, allowing for flexible testing across different browsers. WebdriverIO offers a rich set of features, including built-in support for various testing frameworks, plugins, and a powerful assertion library. If you want a versatile testing framework that can work with both Selenium and modern browser automation protocols, WebdriverIO is a strong candidate.

To see how selenium-webdriver compares with nightwatch, puppeteer, and webdriverio, check out the comparison: Comparing nightwatch vs puppeteer vs selenium-webdriver vs webdriverio.

README for selenium-webdriver

selenium-webdriver

Selenium is a browser automation library. Most often used for testing web-applications, Selenium may be used for any task that requires automating interaction with the browser.

Installation

Selenium may be installed via npm with

npm install selenium-webdriver

You will need to download additional components to work with each of the major browsers. The drivers for Chrome, Firefox, and Microsoft's IE and Edge web browsers are all standalone executables that should be placed on your system PATH. Apple's safaridriver (v10 and above) can be found at the following path – /usr/bin/safaridriver. To enable automation on safari, you need to run command safaridriver --enable.

| Browser | Component | | :---------------- | :------------------------------- | | Chrome | chromedriver(.exe) | | Internet Explorer | IEDriverServer.exe | | Edge | MicrosoftWebDriver.msi | | Firefox | geckodriver(.exe) | | Opera | operadriver(.exe) | | Safari | safaridriver |

Usage

The sample below and others are included in the example directory. You may also find the tests for selenium-webdriver informative.

const { Builder, Browser, By, Key, until } = require('selenium-webdriver')

;(async function example() {
  let driver = await new Builder().forBrowser(Browser.FIREFOX).build()
  try {
    await driver.get('https://www.google.com/ncr')
    await driver.findElement(By.name('q')).sendKeys('webdriver', Key.RETURN)
    await driver.wait(until.titleIs('webdriver - Google Search'), 1000)
  } finally {
    await driver.quit()
  }
})()

Using the Builder API

The Builder class is your one-stop shop for configuring new WebDriver instances. Rather than clutter your code with branches for the various browsers, the builder lets you set all options in one flow. When you call Builder#build(), all options irrelevant to the selected browser are dropped:

const webdriver = require('selenium-webdriver')
const chrome = require('selenium-webdriver/chrome')
const firefox = require('selenium-webdriver/firefox')

let driver = new webdriver.Builder()
  .forBrowser(webdriver.Browser.FIREFOX)
  .setChromeOptions(/* ... */)
  .setFirefoxOptions(/* ... */)
  .build()

Why would you want to configure options irrelevant to the target browser? The Builder's API defines your default configuration. You can change the target browser at runtime through the SELENIUM_BROWSER environment variable. For example, the example/google_search.js script is configured to run against Firefox. You can run the example against other browsers just by changing the runtime environment

# cd node_modules/selenium-webdriver
node example/google_search
SELENIUM_BROWSER=chrome node example/google_search
SELENIUM_BROWSER=safari node example/google_search

The Standalone Selenium Server

The standalone Selenium Server acts as a proxy between your script and the browser-specific drivers. The server may be used when running locally, but it's not recommend as it introduces an extra hop for each request and will slow things down. The server is required, however, to use a browser on a remote host (most browser drivers, like the IEDriverServer, do not accept remote connections).

To use the Selenium Server, you will need to install the JDK and download the latest server from Selenium. Once downloaded, run the server with

java -jar selenium-server-4.4.0.jar standalone

You may configure your tests to run against a remote server through the Builder API:

let driver = new webdriver.Builder()
  .forBrowser(webdriver.Browser.FIREFOX)
  .usingServer('http://localhost:4444/wd/hub')
  .build()

Or change the Builder's configuration at runtime with the SELENIUM_REMOTE_URL environment variable:

SELENIUM_REMOTE_URL="http://localhost:4444/wd/hub" node script.js

You can experiment with these options using the example/google_search.js script provided with selenium-webdriver.

Documentation

API documentation is available online from the Selenium project. Additional resources include

Contributing

Contributions are accepted either through GitHub pull requests or patches via the Selenium issue tracker.

Node Support Policy

Each version of selenium-webdriver will support the latest semver-minor version of the LTS and stable Node releases. All semver-major & semver-minor versions between the LTS and stable release will have "best effort" support. Following a Selenium release, any semver-minor Node releases will also have "best effort" support. Releases older than the latest LTS, semver-major releases, and all unstable release branches (e.g. "v.Next") are considered strictly unsupported.

For example, suppose the current LTS and stable releases are v14.20.0 and v18.8.0, respectively. Then a Selenium release would have the following support levels:

| Version | Support | | :-------: | :-----------: | | <= 14.19 | unsupported | | 14.20.0 | supported | | 18.0-7 | best effort | | 18.8.0 | supported | | >= 18.8.0 | best effort | | v.Next | unsupported |

Support Level Definitions

  • supported: A selenium-webdriver release will be API compatible with the platform API, without the use of runtime flags.

  • best effort: Bugs will be investigated as time permits. API compatibility is only guaranteed where required by a supported release. This effectively means the adoption of new JS features, such as ES2015 modules, will depend on what is supported in Node's LTS.

  • unsupported: Bug submissions will be closed as will-not-fix and API compatibility is not guaranteed.

Projected Support Schedule

If Node releases a new LTS each October and a new major version every 6 months, the support window for selenium-webdriver will be roughly:

| Release | Status | END-OF-LIFE | | :-----: | :-------------: | :---------: | | v14.x | Maintenance LTS | 2023-04-30 | | v16.x | Active LTS | 2023-09-11 | | v18.x | Current | 2025-04-30 | | v19.x | Pending | 2023-06-01 | | v20 | Pending | 2026-04-30 |

Issues

Please report any issues using the Selenium issue tracker. When using the issue tracker

  • Do include a detailed description of the problem.
  • Do include a link to a gist with any interesting stack traces/logs (you may also attach these directly to the bug report).
  • Do include a reduced test case. Reporting "unable to find element on the page" is not a valid report - there's nothing for us to look into. Expect your bug report to be closed if you do not provide enough information for us to investigate.
  • Do not use the issue tracker to submit basic help requests. All help inquiries should be directed to the user forum or #selenium IRC channel.
  • Do not post empty "I see this too" or "Any updates?" comments. These provide no additional information and clutter the log.
  • Do not report regressions on closed bugs as they are not actively monitored for updates (especially bugs that are >6 months old). Please open a new issue and reference the original bug in your report.

License

Licensed to the Software Freedom Conservancy (SFC) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The SFC licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Terms & PrivacyProduct HuntJSON to TypeScriptCopilotChat for Web Dev