grunt-mocha-casperjs

Grunt wrapper for mocha-casperjs

Getting Started

If you haven't 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're familiar with that process, you may install this plugin with this command:

1npm install grunt-mocha-casperjs --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

1grunt.loadNpmTasks('grunt-mocha-casperjs');

The "mocha_casperjs" task

Overview

In your project's Gruntfile, add a section named mocha_casperjs to the data object passed into grunt.initConfig().

1grunt.initConfig({
2  mocha_casperjs: {
3    options: {
4      // Task-specific options go here.
5    },
6    your_target: {
7      // Target-specific file lists and/or options go here.
8    },
9  },
10})

Options

options.reporter

Type: String Default value: 'spec'

Any Mocha reporter that can run in the phantomjs or slimerjs environment.

options.timeout

Type: Number Default value: 30000

Test-case timeout in milliseconds.

options.slow

Type: Number Default value: 75

“Slow” test threshold in milliseconds.

options.ui

Type: String Default value: 'bdd'

Test user-interface (bdd|tdd|exports).

options.color

Type: Boolean Default value: false

Disable colored output, enabled by default.

options.casperTimeout

Type: Number Default value: 5000

Casper's timeout, should be less than Mocha's.

options.width

Type: Number Default value: 400

Casper's viewport width.

options.height

Type: Number Default value: 300

Casper's viewport height.

options.userAgent

Type: String Default value: Phantom's UA string

Casper's User-Agent string.

options.file

Type: String

Path to output file. Save reporter output, for json, xunit, etc. type of reporters.

options.ssl

Type: Boolean

SSL flag: --ssl-protocol=tlsv1

Other options

Other CLI options may be passed to mocha-casperjs by quoting the flag name where needed. E.g., if you want to use your existing mocha/chai/casper-chai, use options like this (coffeescript example):

    all:
      options:
        'mocha-path':       'node_modules/mocha'
        'chai-path':        'node_modules/chai'
        'casper-chai-path': 'node_modules/casper-chai'

Usage Examples

Basic usage

1grunt.initConfig({
2  mocha_casperjs: {
3    options: {
4      timeout: 5000,
5      color: false
6    },
7    files: {
8      src: ['test/**/*']
9    }
10  }
11});

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.

Release History

• 2015-04-30   v0.1.4.4 Add SSL flag to the the options object
• 2015-04-11   v0.1.4.3
• 2015-03-24   v0.1.4.2
• 2014-12-10   v0.1.4.1
• 2014-04-19   v0.1.4
• 2014-03-28   v0.1.3   Add Casper width, height viewport size & UA string options
• 2014-03-28   v0.1.2   Add Casper timeout and save report output options
• 2014-03-28   v0.1.1   Add test failing
• 2014-03-28   v0.1.0   Initial release

License

Copyright (c) 2014 Roman Liutikov. Licensed under the MIT license.