selenium-standalone

What is selenium-standalone?

The selenium-standalone npm package is a tool that allows you to easily install and run a standalone Selenium server. This is useful for running automated tests in various browsers without needing to manually set up the Selenium server and browser drivers.

What are selenium-standalone's main functionalities?

Install Selenium Server and Browser Drivers

This feature allows you to install the Selenium server and browser drivers (e.g., ChromeDriver, GeckoDriver) with a single command. The code sample demonstrates how to install the latest versions of the Selenium server and drivers for Chrome and Firefox.

const selenium = require('selenium-standalone');

selenium.install({
  version: 'latest',
  baseURL: 'https://selenium-release.storage.googleapis.com',
  drivers: {
    chrome: { version: 'latest' },
    firefox: { version: 'latest' }
  },
  logger: function(message) {
    console.log(message);
  }
}, function(err) {
  if (err) { return console.error(err); }
  console.log('Selenium and drivers installed successfully');
});

Start Selenium Server

This feature allows you to start the Selenium server programmatically. The code sample demonstrates how to start the Selenium server and log a message upon successful startup.

const selenium = require('selenium-standalone');

selenium.start(function(err, child) {
  if (err) { return console.error(err); }
  console.log('Selenium server started successfully');
  // child is a ChildProcess instance
});

Stop Selenium Server

This feature allows you to stop the Selenium server programmatically. The code sample demonstrates how to start the Selenium server and then stop it after 10 seconds.

const selenium = require('selenium-standalone');

selenium.start(function(err, child) {
  if (err) { return console.error(err); }
  console.log('Selenium server started successfully');
  // Stop the server after 10 seconds
  setTimeout(() => {
    child.kill();
    console.log('Selenium server stopped');
  }, 10000);
});

Other packages similar to selenium-standalone

webdriver-manager

webdriver-manager is a tool for managing WebDriver binaries. It can download, update, and start WebDriver binaries for different browsers. Unlike selenium-standalone, which focuses on running a standalone Selenium server, webdriver-manager is more focused on managing the WebDriver binaries themselves.

selenium-webdriver

selenium-webdriver is the official Selenium package for Node.js. It provides bindings for the WebDriver API and allows you to write automated tests for web applications. While selenium-standalone focuses on setting up and running the Selenium server, selenium-webdriver is used for writing and executing the tests themselves.

nightwatch

Nightwatch is an end-to-end testing framework that uses the WebDriver API. It provides a higher-level API for writing tests and includes built-in support for running tests with Selenium. Nightwatch can manage the Selenium server and browser drivers, similar to selenium-standalone, but it also includes additional features for writing and organizing tests.

README

• selenium-standalone
  • Install & Run
  • Command line interface (CLI)
  • Application Programming Interface (API)
  • Available browsers
  • Tips
    • Examples of combining with other tools
  • Contributing

selenium-standalone

A node based CLI library for launching Selenium with WebDrivers support.

Supported WebDrivers:

• ChromeDriver
• geckodriver (Firefox)
• IEDriver
• Edge WebDriver
• Chromium Edge WebDriver

Install & Run

As global npm package

npm install selenium-standalone -g
selenium-standalone install && selenium-standalone start

As a npm package

npm install selenium-standalone --save-dev
npx selenium-standalone install && npx selenium-standalone start

As a Docker service

docker run -it -p 4444:4444 vvoyer/selenium-standalone

Command line interface (CLI)

See CLI docs

Application Programming Interface (API)

See API docs

Available browsers

By default, Google Chrome, Firefox and Microsoft Edge are available when installed on the host system.

Starting from v6.22 chrome, edgechromium, and geckodriver support latest as version.

Tips

• Start Selenium whenever your (ubuntu) machine starts!
• Ensure you have the minimum required Java version
• Logging
• Error: unable to get local issuer certificate
• Running headlessly with xvfb

Examples of combining with other tools

• WebdriverIO + Jasmine in CircleCI
• WebdriverIO + Cucumber in GitLab

Contributing

See Contributing