gulp-jasmine-phantom
A gulp plugin that runs Jasmine tests with either PhantomJS or minijasminenode2.
Please note this is a copy of https://github.com/dflynn15/gulp-jasmine-phantom
Dependencies
This module uses execSync
which is not available in any version of Node under 0.12.x
.
If you have any specific concerns about upgrading versions of Node or reasons not use
execSync
feel free to open an issue!
Before you install gulp-jasmine-phantom
please ensure that you have PhantomJS
installed on your machine. The plugin assumes that the phantomjs
binary is
available in the PATH and executable from the command line.
If not, ensure you at least have phantomjs
as an npm dependency. The module
checks in ./node_modules/phantomjs
for an executable if you do not have it
installed globally.
**If you do not have phantomjs
installed please install following
these directions.
Install
$ npm install --save-dev gulp-jasmine-phantom
Usage
By default, gulp-jasmine-phantom
runs your tests with minijasminenode
and
not phantomjs
.
This is an effort to keep your tasks running as quickly as possible!
Basic usage:
var gulp = ;var jasmine = ; gulp;
To use phantomjs
for tests (ie: integration tests) use the following setup:
var gulp = ;var jasmine = ; gulp;
Also, remember you can always run any multitude of tests using different Gulp tasks. For example, running unit tests and integration tests asynchronously.
var gulp = ;var jasmine = ; gulp; gulp;
Options
jasmineVersion
Type: string
Default: '2.0'
Specifies the version of Jasmine you want to run. Possible options are in the vendor/
folder. Just specify what 2.x
minor release you want.
integration
Type: boolean
Default: false
Run your tests with phantomjs
keepRunner
Type: boolean | string
Default: false
Keep the specRunner.html
file after build. If given a string, it will keep
the runner at the string path.
includeStackTrace
Type: boolean
Default: false
Prints out a longer stack trace for errors.
abortOnFail
Type: boolean
Default: false
Currently built with integration mode only
Exits Gulp with an status of 1 that will halt any further Gulp tasks.
specHtml
Type: string
Default: null
Only use in combination with integration: true
Allows you to specify the HTML runner that Jasmine uses only during integration tests.
vendor
Type: string | array
Default: null
Only use in combination with integration: true
A list of vendor scripts to import into the HTML runner, either as file
globs (e.g. "**/*.js"
) or fully-qualified URLs (e.g.
"http://my.cdn.com/jquery.js"
).
This option accepts either a single string or an array of strings (e.g.
["test/*.js", "http://my.cdn.com/underscore.js"]
).
phantomArguments
Type: Array Default: null
Only use in combination with integration: true
An array of optional arguments to pass to the phantomjs command.
['--ignore-ssl-errors=true', '--ssl-protocol=any']
Technologies Used
- Node
- Gulp