⚠️ ATTENTION: we are looking for people taking on maintenance for this package. Read more in webdriverio/selenium-standalone#813.

Node.js Selenium Standalone

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

Supported Drivers:

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

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.

Starting from v9.0.6 support changes regarding new storage for latest versions of chromedriver.

Install & Run

As Global NPM Package

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

As a Local 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 webdriverio/selenium-standalone

If you run Chrome or Firefox tests within a Docker container make sure you set capabilities so that the session is headless, e.g.:

capabilities: {
  browserName: 'chrome',
  'goog:chromeOptions': {
    args: ['--no-sandbox', '--headless']
  }
}

or Firefox:

capabilities: {
  browserName: 'firefox',
  'moz:firefoxOptions': {
    args: ['-headless']
  }
}

If you are looking for more sophisticated Docker container that allows you to run browser, check out the Docker Selenium project.

Command line interface (CLI)

See CLI docs

Application Programming Interface (API)

See API docs

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

You like this project and want to help making it better? Awesome! Have a look into our Contributor Documentation to get started with setting up the repo.

If you're looking for issues to help out with, check out the issues labelled "good first pick". You can also reach out in our Gitter Channel if you have question on where to start contributing.