Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prantlf/grunt-chromedriver
Controls Chrome or Chromium using the WebDriver interface via chromedriver without Selenium.
https://github.com/prantlf/grunt-chromedriver
browser chrome chromedriver chromium grunt-task gruntplugin testing webdriver
Last synced: 18 days ago
JSON representation
Controls Chrome or Chromium using the WebDriver interface via chromedriver without Selenium.
- Host: GitHub
- URL: https://github.com/prantlf/grunt-chromedriver
- Owner: prantlf
- License: mit
- Created: 2020-07-26T22:28:51.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-05-05T17:58:24.000Z (over 1 year ago)
- Last Synced: 2024-11-17T10:06:44.542Z (about 1 month ago)
- Topics: browser, chrome, chromedriver, chromium, grunt-task, gruntplugin, testing, webdriver
- Language: JavaScript
- Homepage:
- Size: 461 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# grunt-chromedriver
[
](https://www.npmjs.com/package/grunt-chromedriver)
[](https://codecov.io/gh/prantlf/grunt-chromedriver)
[](https://codebeat.co/projects/github-com-prantlf-grunt-chromedriver-master)
Controls Chrome or Chromium using the WebDriver interface via chromedriver without Selenium.
If you use a modern test driver like [webdriverio], you will not need [Selenium] to run the tests, because the browser driver itself implements the [WebDriver] interface. This module provides a [Grunt] multi-task for installing, starting and stopping the [chromedriver] executable. You take care of installing Chrome or Chromium.
This task, [grunt-geckodriver] and [grunt-safaridriver] can be used as a replacement for [grunt-selenium-standalone] for tasks like [grunt-html-dom-snapshot], to simplify the whole scenario by removing [Selenium] and [Java] from the requirements.
## Installation
You need [node >= 10][node], [npm] and [grunt >= 1.0.0][Grunt] installed and
your project build managed by a [Gruntfile]. If you have not used Grunt before,
be sure to check out the [Getting Started] guide, as it explains how to create
a Gruntfile as well as install and use Grunt plugins. Once you are familiar
with that process, you may install this plugin with this command:
npm install grunt-chromedriver --save-dev
## Configuration
Add the `chromedriver` entry with one or more tasks to the options of the
`grunt.initConfig` method in `Gruntfile.js`:
```js
grunt.initConfig({
chromedriver: {
default: {}
}
});
```
Load the plugin:
```javascript
grunt.loadNpmTasks('grunt-chromedriver');
```
Add use the task to start and stop the browser driver before and after the tests:
```js
grunt.registerTask('default', ['chromedriver:default:start', ..., 'chromedriver:default:stop']);
```
### Options
Default task options support the most usual usage scenario:
```js
chromedriver: {
default: {
port: 9515,
findAvailablePort: false,
args: [],
force: false
}
}
```
#### port
Type: `Number`
Default value: `9515`
The port for the `chromedriver` to listen to. If `findAvailablePort` is set to
`true`, this port will be used to start the search for a free port with.
### findAvailablePort
Type: `Boolean`
Default value: `false`
If set to `true`, the value of `port` will be used to start the search for a
free port with.
### args
Type: `Array`
Default value: `[]`
Command-line arguments for the `chromedriver` executable. Available ones:
--port=PORT port to listen on
--adb-port=PORT adb server port
--log-path=FILE write server log to file instead of stderr, increases
log level to INFO
--log-level=LEVEL set log level: ALL, DEBUG, INFO, WARNING, SEVERE, OFF
--verbose log verbosely (equivalent to --log-level=ALL)
--silent log nothing (equivalent to --log-level=OFF)
--append-log append log file instead of rewriting
--replayable (experimental) log verbosely and don't truncate long
strings so that the log can be replayed.
--url-base base URL path prefix for commands, e.g. wd/url
--readable-timestamp add readable timestamps to log
--whitelisted-ips comma-separated whitelist of remote IP addresses
which are allowed to connect to ChromeDriver
### force
Type: `Boolean`
Default value: `false`
If set to `true`, it suppresses failures. Instead of making the Grunt fail,
the errors will be written only to the console.
### Events
If `findAvailablePort` is set to `true`, the actual chosen port can be read by:
```js
grunt.config.get(`chromedriver..port`)
```
As soon es the browser driver process starts listening, an event will be
triggered with the actually chosen port:
```js
grunt.event.on(`chromedriver..listening`, port => {...})
```
## Contributing
In lieu of a formal styleguide, take care to maintain the existing coding
style. Add unit tests for any new or changed functionality. Lint and test
your code using Grunt.
## License
Copyright (c) 2020-2023 Ferdinand Prantl
Licensed under the MIT license.
[node]: https://nodejs.org
[npm]: https://npmjs.org
[Grunt]: https://gruntjs.com
[Gruntfile]: https://gruntjs.com/sample-gruntfile
[Getting Gtarted]: https://github.com/gruntjs/grunt/wiki/Getting-started
[Selenium]: http://www.seleniumhq.org/download/
[chromedriver]: https://github.com/giggio/node-chromedriver#readme
[webdriverio]: http://webdriver.io/
[Java]: https://java.com/en/download/
[WebDriver]: https://www.w3.org/TR/webdriver/
[grunt-html-dom-snapshot]: https://github.com/prantlf/grunt-html-dom-snapshot#readme
[grunt-selenium-standalone]: https://github.com/zs-zs/grunt-selenium-standalone#readme
[grunt-geckodriver]: https://github.com/prantlf/grunt-geckodriver#readme
[grunt-safaridriver]: https://github.com/prantlf/grunt-safaridriver#readme