gulp-jasmine-phantom

gulp-jasmine-phantom

A gulp plugin that runs Jasmine tests with either PhantomJS or minijasminenode2.

Dependencies

Before you install gulp-jasmine-phantom please enusre 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 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 in an effort to keep your tasks running as quickly as possible!

Basic useage:

var gulp = require('gulp');
var jasmine = require('gulp-jasmine-phantom');

gulp.task('default', function () {
  return gulp.src('spec/test.js')
          .pipe(jasmine());
});

To use phantomjs for tests (ie: integration tests) use the following setup:

var gulp = require('gulp');
var jasmine = require('gulp-jasmine-phantom');

gulp.task('default', function() {
  return gulp.src('spec/test.js')
          .pipe(jasmine({
            integration: true
          }));
});

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 = require('gulp');
var jasmine = require('gulp-jasmine-phantom');

gulp.task('unitTests', function () {
  return gulp.src('spec/test.js')
          .pipe(jasmine());
});

gulp.task('integrationTests', function() {
  return gulp.src('spec/test.js')
          .pipe(jasmine({
            integration: true
          }));
});

Options

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.

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

This option allows you to pass in a glob (i.e.: **/*.js) that will include any vendor files that need to be present for your specs to run (like jQuery for example).

You can also pass in an array of glob strings (i.e.: ["test/*.js", "vendor/jquery.js"]).

Technologies Used

• Node
• Gulp

Team Members

• Daniel Flynn
• Rob Tarr