# grunt-casperjs

> With this grunt.js task you can run tests with CasperJS.

Latest version **2.2.1** (published 2016-07-20) · 0 weekly downloads

## Install

```sh
npm install grunt-casperjs
pnpm add grunt-casperjs
yarn add grunt-casperjs
bun add grunt-casperjs
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.2.1 |
| Published | 2016-07-20 |
| First published | 2012-06-05 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 0.8.0 |
| Dependencies | 2 |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 104 |
| Author | Ronald Lokers |
| Maintainers | gorillamania, jatin, ndelangen, ronaldlokers |
| Keywords | gruntplugin, casperjs |

## Links

- npm: https://www.npmjs.com/package/grunt-casperjs
- Repository: https://github.com/ronaldlokers/grunt-casperjs
- Issues: https://github.com/ronaldlokers/grunt-casperjs/issues
- npm.io page: https://npm.io/package/grunt-casperjs

## Dependencies (2)

- [casperjs](https://npm.io/package/casperjs.md) 1.1.1
- [phantomjs-prebuilt](https://npm.io/package/phantomjs-prebuilt.md) ~2.1.4

## Recent versions

- 2.2.1 (latest) — 2016-07-20
- 2.2.0 — 2016-06-20
- 2.1.0 — 2014-12-22
- 2.0.2 — 2014-10-03
- 2.0.1 — 2014-09-08
- 2.0.0 — 2014-08-17
- 1.5.0 — 2014-06-05
- 1.4.0 — 2013-11-12
- 1.3.0 — 2013-10-27
- 1.2.1 — 2013-10-27
- 1.2.0 — 2013-10-25
- 1.1.2 — 2013-09-28
- 1.1.1 — 2013-09-28
- 1.1.0 — 2013-09-28
- 1.0.10 — 2013-09-28
- … 10 more at https://npm.io/package/grunt-casperjs/versions

## README

# grunt-casperjs

> With this grunt.js task you can run tests with CasperJS.

## Getting Started

First [Install CasperJS](http://casperjs.org/installation.html).

This plugin requires Grunt `~0.4.0`

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```shell
npm install grunt-casperjs --save-dev
```

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

```js
grunt.loadNpmTasks('grunt-casperjs');
```

## The "casperjs" task

### Overview

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

```js
grunt.initConfig({
  casperjs: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    }
  }
})
```

### Usage Examples

#### Default Options

```js
grunt.initConfig({
  casperjs: {
    options: {
      async: {
        parallel: false
      },
      silent: false
    },
    files: ['tests/casperjs/**/*.js']
  },
})
```

#### Async Parallel

By default, tests are run in series. If your tests are independent, you can run them in parallel.

```javascript
casperjs: {
  options: {
    async: {
      parallel: true
    }
  },
  files: ['tests/casperjs/**/*.js']
}
```

#### Silent

The task says the casper path and test file being executed (which CasperJS also
states) by default. Setting `silent` to true will suppress these grunt.log
messages (does not affect CasperJs output, only the grunt.log output).

```javascript
casperjs: {
  options: {
    silent: true
  },
  files: ['tests/casperjs/**/*.js']
}
```

#### CasperJS Options

CasperJS options (including user defined ones) can be passed in using 'casperjsOptions' in the options object

```javascript
casperjs: {
  options: {
    casperjsOptions: ['--foo=bar', '--no-colors']
  },
  files: ['tests/casperjs/**/*.js']
}
```

#### Install script and CasperJS version

The install.js script is responsible for searching for existing CasperJS installations in the path. If found, as of grunt-casperjs v1.2.0, that version of CasperJS will be used. If not found, a stable version of CasperJS will be installed (under review).

grunt-casperjs was tested with the currently stable version of CasperJS, 1.1.x

**If you would like to use a different version of casperjs**, install it yourself globally before installing grunt-casperjs. It will use that one.

## 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](http://gruntjs.com/).


## CHANGELOG

* 2.1.1 2nd fix for caspersjs dependency version number
* 2.0.1 Fix caspersjs dependency version number
* 2.0.1 Remove incorrect error message
* 2.0.0 Stop installing casperjs manually, let npm do it
* 1.5.0 Fix critical install issue - https://github.com/ronaldlokers/grunt-casperjs/issues/55
* 1.4.1 Lock to casper js version `1.0.3` instead of `master` (to be incremented soon)
* 1.4.0 Options can be passed into CasperJS. Any option.
* 1.3.0 Bump to using the latest version of CasperJs
* 1.2.1 CasperJS installations in path will be used
* 1.2.0 Cleaner fix for installing grunt
* 1.1.2 Fix for windows installation
* 1.1.1 Use latest version of PhantomJS ~1.9
* 1.0.10 Fix env-vars dumping
* 1.0.9 If user has local casperjs, use that first.
* 1.0.7 Options to run tests in parallel
* 1.0.5 Changelog started :)

---
_Source: https://npm.io/package/grunt-casperjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._