Run your functional tests through casperjs.

npm install grunt-functional
12 downloads in the last month


Run self-hosted functional tests through casperjs.

This task will spin up your app on the host and port specified in your configuration and run your functional tests.


  1. Install CasperJS
  2. Install and configure grunt-casperjs with: npm install grunt-casperjs

       casperjs: {
         files: ['test/functional/**/*.js']
  3. Install and configure grunt-functional with: npm install grunt-functional

  4. Add your functional tests to your project's "test/functional" directory.
  5. Add the following to your configuration:

       server: {
         base: 'app'
       functional_tests: {
         hostname: 'localhost',
         port: 35729,
  6. Run grunt functional and your functional tests will run on the host and port specified in your configuration.

Terminal example of grunt functional

Release History

  • 0.2.0 - Fixed grunt/yeoman compatibility. Yeoman is using an alpha version of grunt which expected Gruntfile.js. Added a server provider that doesn't depend on Yeoman.
  • 0.1.1 - Initial Release.


Copyright (c) 2012 Caige Nichols "caiges"
Licensed under the MIT license.

npm loves you