Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/webdriverio/selenium-standalone
A Node.js based package and CLI library for launching Selenium with WebDrivers support (Chrome, Firefox, IE, Edge)
https://github.com/webdriverio/selenium-standalone
hacktoberfest
Last synced: about 2 months ago
JSON representation
A Node.js based package and CLI library for launching Selenium with WebDrivers support (Chrome, Firefox, IE, Edge)
- Host: GitHub
- URL: https://github.com/webdriverio/selenium-standalone
- Owner: webdriverio
- License: other
- Created: 2013-09-25T12:10:36.000Z (almost 11 years ago)
- Default Branch: main
- Last Pushed: 2024-04-08T12:23:05.000Z (5 months ago)
- Last Synced: 2024-04-14T00:38:02.788Z (5 months ago)
- Topics: hacktoberfest
- Language: JavaScript
- Homepage: https://webdriver.io
- Size: 3.89 MB
- Stars: 904
- Watchers: 35
- Forks: 221
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
Node.js Selenium Standalone [](https://github.com/webdriverio/selenium-standalone/actions/workflows/test.yml) 
===========================
> A node based CLI library for launching [Selenium](http://www.seleniumhq.org/download/) with [WebDriver](https://w3c.github.io/webdriver/) support.
Supported Drivers:
* [ChromeDriver](https://github.com/SeleniumHQ/selenium/wiki/ChromeDriver)
* [geckodriver](https://github.com/mozilla/geckodriver/releases) (Firefox)
* [IEDriver](https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver)
* [Edge WebDriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/#downloads)
* [Chromium Edge WebDriver](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/#downloads)
## 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` supported changes regarding new storage for `latest` versions of chromedriver.
Starting from `v9.2.0` added new feature 'onlyDriver'
## Install & Run
### As Global NPM Package
```shell
npm install selenium-standalone -g
selenium-standalone install && selenium-standalone start
```
### As a Local NPM Package
```shell
npm install selenium-standalone --save-dev
npx selenium-standalone install && npx selenium-standalone start
```
### As a Docker Service
```shell
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.:
```js
capabilities: {
browserName: 'chrome',
'goog:chromeOptions': {
args: ['--no-sandbox', '--headless']
}
}
```
or Firefox:
```js
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](https://github.com/SeleniumHQ/docker-selenium) project.
## Command line interface ([CLI](./docs/CLI.md))
See [CLI](./docs/CLI.md) docs
## Application Programming Interface ([API](./docs/API.md))
See [API](./docs/API.md) docs
## Tips
- [Start Selenium whenever your (ubuntu) machine starts!](./docs/run-when-system-starts.md)
- [Ensure you have the minimum required Java version](./docs/java-versions.md)
- [Logging](./docs/logging.md)
- [`Error: unable to get local issuer certificate`](./docs/issuer-cerificate.md)
- [Running headlessly with xvfb](./docs/xvfb.md)
### Examples of combining with other tools
- [WebdriverIO + Jasmine](https://github.com/mgrybyk/wdio-jasmine-boilerplate) in CircleCI
- [WebdriverIO + Cucumber](https://gitlab.com/bar_foo/wdio-cucumber-typescript) in GitLab
## :woman_technologist: :man_technologist: Contributing
You like this project and want to help making it better? Awesome! Have a look into our [Contributor Documentation](CONTRIBUTING.md) 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"](https://github.com/webdriverio/selenium-standalone/issues?q=is%3Aopen+is%3Aissue+label%3A"good+first+pick"). You can also reach out in on [Discord](https://discord.webdriver.io) if you have question on where to start contributing.