Installation

Prerequisite

If you would like to use Selenium, you need to have Java.
Oracle JDK v1.8+ (Download Here)
You can check your Java version in the terminal with java -version (single dash)

Be sure to install the JDK not the JRE.

Installation

Bash

npm install chimpy

and then you can run using ./node_modules/.bin/chimpy

Gulp Installation

TODO: This needs a patch since Chimpy has been forked from Chimp.

gulp-chimp is a wrapper to interact with Chimp.js in a gulp task.

Quick Install

In the terminal run the following command

npm install gulp-chimp --save-dev

Usage with chimp.conf.js file chimp.conf.js

var chimp = require('gulp-chimp');

/* Chimp.js - Automated/e2e Testing with a config file */
gulp.task('chimp', function () {
    return chimp('./chimp.conf.js');
});

Cucumber HTML Report

Usage with chimp.js options

/* Chimp.js - Automated/e2e Testing with options */
gulp.task('chimp-options', function () {
    return chimp({
        path: './source/e2e/features', // Cucumber features files
        browser: 'phantomjs',
        debug: true,
        singleRun: false,
        log: 'info',
        timeout: 60000,
        port: 2345,
        reportHTML: true
    });
});

path

Type: string
Default: ./source/e2e/features

browser

Type: string
Default chrome

singleRun

Type: boolean
Default true

debug

Type: boolean
Default false

log

Type: string
Default: info

timeout

Type: number
Default 60000

port

Type: number
Default 2356

reportHTML

Type: boolean
Default true

Troubleshooting

Permission Denied
If you get this error message:
Error: EACCES: permission denied, mkdir...

Try deleting the .selenium directory using:

Bash

sudo rm -rf /usr/local/lib/node_modules/chimp/node_modules/selenium-standalone/.selenium`

Failed at the fibers
If you get this error message:
npm ERR! Failed at the [email protected] install script 'node build.js || nodejs build.js'.

Upgrade to Node 4.x+

---

##Learn the Fundamentals of Testing, Specifications and Become a Chimp Ninja!
Checkout our new book where you can learn how to can use Chimp across the Full Stack from React to Node.JS, Mocha, Meteor and more.

Quality, Faster. By Sam Hatoum, creator of Chimp.