Run CasperJS Scripts/Functional Tests

This task makes use of PhantomJS to drive the casperJS scripts in a headless manner.

You will need to install phantomjs, with a fairly simple package install After phantomjs is installed, you will need to install casperjs

Now install the grunt task

npm install grunt-casper --save

CasperJS is a navigation scripting & testing utility for PhantomJS. It eases the process of defining a full navigation scenario and provides useful high-level functions, methods & syntaxic sugar for doing common tasks in a headless browser.

If you haven't used casperjs before, be sure to check out the Get Started guide, as it explains how to create your first test case.

Run this task with the grunt casperjs command.

This task is a multi task so any targets, files and options should be specified according to the [multi task][] documentation.

Type: String Function

The 'dest' option in Grunt's configuration is passed as the --save option to casper, allowing you to access your destination programmatically. If passed as a function, the return value will be used.

Type: Boolean Default: false

Run the casperjs script(s) in test mode. Thus allowing you to split up your tests (casperjs test tests/)

Type: String Default: undefined

Comma separated list of scripts to "include" before executing tests.

Type: String Default: undefined

Scripts to be executed before the test suite

Type: String Default: undefined

Scripts to be executed after the test suite

Type: Boolean Default: false

Output log messages directly to the console

Type: String Default: error Options: debug info warning error

Sets the casperjs logging level

Type: boolean Default: false

Terminate as soon as a first failure is encountered.

Basic usage

casper : {
 yourTask : {
    options : {
      test : true
    },
    files : {
      'xunit/casper-results.xml' : ['test/functionalTests.js']
    }
  }
}

Global options and custom destination

casper : {
  options : {
    test : true,
    includes : 'path/to/inc.js',
    post : 'path/to/post.js',
    pre : 'path/to/pre.js',
    'log-level' : 'warning',
    'fail-fast' : true
  },
  yourTask : {
    src: ['path/to/tests/*_test.js'],
    dest : function(input) {
      return input.replace(/\.js$/,'.xml');
    }
  }
}

CasperJS supports options and arguments on the command line.

casperjs test.js baz --foo=bar

Grunt tasks can accept additional arguments and grunt-casper will pass these through to CasperJS, for instance

grunt casper:yourTask:baz:--foo=bar

will pass baz as an argument and foo as an option with a value of bar. These are then available in your CasperJS script

casper.cli.args.indexOf('baz'); // 0
casper.cli.options.foo; //bar

Arguments and options will be ignored in test mode as CasperJS does not support them.

• 2013-10-08   v0.1.4   Merged pull request - cwd spawn option
• 2013-09-05   v0.1.3   Fixed logging from grunt.verbose -> grunt.log
• 2013-08-10   v0.1.2   Added xunit support
• 2013-02-01   v0.1.1   Update Task To Run With grunt0.4.0rc7
• 2013-01-01   v0.1.0   Initial Release

Task submitted by Chris Miller