Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tanem/grunt-ptor
Run Protractor e2e tests.
https://github.com/tanem/grunt-ptor
Last synced: 8 days ago
JSON representation
Run Protractor e2e tests.
- Host: GitHub
- URL: https://github.com/tanem/grunt-ptor
- Owner: tanem
- License: mit
- Created: 2014-11-02T01:58:54.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2019-05-30T20:42:17.000Z (over 5 years ago)
- Last Synced: 2024-08-09T08:56:04.978Z (3 months ago)
- Language: JavaScript
- Size: 14.6 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# grunt-ptor
[](https://travis-ci.org/tanem/grunt-ptor)
[](https://www.npmjs.com/package/grunt-ptor)
[](https://www.npmjs.com/package/grunt-ptor)
[](https://david-dm.org/tanem/grunt-ptor)
[](https://david-dm.org/tanem/grunt-ptor#info=devDependencies)
[](https://david-dm.org/tanem/grunt-ptor#info=peerDependencies)
Run [Protractor](https://github.com/angular/protractor) e2e tests.
## Motivation
Other plugins exist, but I just wanted something simple that passed the required options through to the Protractor command.
## Getting Started
This plugin requires Grunt `~0.4.5`.
If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
```sh
$ npm install grunt-ptor --save-dev
```
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
```js
grunt.loadNpmTasks('grunt-ptor');
```
Note that this plugin leaves the Selenium server management up to another tool. I use [grunt-protractor-webdriver](https://www.npmjs.org/package/grunt-protractor-webdriver), which is then set up as a pre-requisite task to this plugin.
## The "ptor" task
### Overview
In your project's Gruntfile, add a section named `ptor` to the data object passed into `grunt.initConfig()`.
```js
grunt.initConfig({
ptor: {
options: {
// Task-specific options go here.
},
your_target: {
options: {
// Target-specific options go here.
}
},
},
});
```
### Options
See the [Protractor reference conf](https://github.com/angular/protractor/blob/master/docs/referenceConf.js) for the options you can use in both the `Gruntfile` and via the command line.
The order of precendence for options is: command line > target level > task level > Protractor conf file.
### Example
```js
grunt.initConfig({
ptor: {
options: {
configFile: 'protractor.conf.js'
},
smoke: {
options: {
suites: 'smoke'
}
}
}
});
```
```sh
$ grunt ptor --chromeOnly --params.login.user=Jane --params.login.password=1234
```
## Tests
To run:
```sh
$ grunt test
```
### Test notes
A child process is spawned within each test so we can execute the task from end to end. This makes method stubbing a little tricky since we are executing in a different process, so a couple of helper tasks are also used:
* `pre` sets up any required stubs
* `post` sends the required information back to the parent process.
This way we can test our expectations in the parent process.