Installation¶
CasperJS can be installed on Mac OSX, Windows and most Linuxes.
Prerequisites¶
- PhantomJS 1.9.1 or greater. Installation instructions can be found here
- Python 2.6 or greater for
casperjs
in thebin/
directory
New in version 1.1.
- Experimental: as of 1.1-beta1, SlimerJS 0.8 or greater to run your tests against Gecko (Firefox) instead of Webkit (just add –engine=slimerjs to your command line options). To see PhantomJS API compatibility of SlimerJS, please refer to this page. Note that it is known that coffescript support breaks as of SlimerJS 0.9.6; we are investigating that issue.
Installing from Homebrew (OSX)¶
Installation of both PhantomJS and CasperJS can be achieved using Homebrew, a popular package manager for Mac OS X.
Above all, don’t forget to update Formulaes:
$ brew update
For the 1.1 development version (recommended):
$ brew install casperjs --devel
For the 1.0.x stable version:
$ brew install casperjs
If you have already installed casperjs and want to have the last release (stable|devel), use upgrade
:
$ brew upgrade casperjs
Upgrade only update to the latest release branch (1.0.x|1.1-dev).
Installing from npm¶
New in version 1.1-beta3.
You can install CasperJS using npm:
$ npm install -g casperjs
Note
The -g
flag makes the casperjs
executable available system-wide.
Warning
While CasperJS is installable via npm, it’s not a NodeJS package. You cannot load casper by using require(‘casperjs’) in node.
Installing from git¶
Installation can be achieved using git. The code is mainly hosted on Github.
From the master branch¶
$ git clone git://github.com/n1k0/casperjs.git
$ cd casperjs
$ ln -sf `pwd`/bin/casperjs /usr/local/bin/casperjs
Once PhantomJS and CasperJS installed on your machine, you should obtain something like this:
$ phantomjs --version
1.9.2
$ casperjs
CasperJS version 1.1.0-DEV at /Users/niko/Sites/casperjs, using phantomjs version 1.9.2
# ...
Or if SlimerJS is your thing:
$ slimerjs --version
Innophi SlimerJS 0.8pre, Copyright 2012-2013 Laurent Jouanneau & Innophi
$ casperjs
CasperJS version 1.1.0-DEV at /Users/niko/Sites/casperjs, using slimerjs version 0.8.0
You are now ready to write your first script!
Installing from an archive¶
You can download tagged archives of CasperJS code:
Latest development version (master branch):
- https://github.com/n1k0/casperjs/zipball/master (zip)
- https://github.com/n1k0/casperjs/tarball/master (tar.gz)
Latest stable version:
- https://github.com/n1k0/casperjs/zipball/1.0.3 (zip)
- https://github.com/n1k0/casperjs/tarball/1.0.3 (tar.gz)
Operations are then the same as with a git checkout.
CasperJS on Windows¶
Phantomjs installation additions¶
- Append
";C:\phantomjs"
to yourPATH
environment variable. - Modify this path appropriately if you installed PhantomJS to a different location.
Casperjs installation additions¶
New in version 1.1-beta3.
- Append
";C:\casperjs\bin"
to yourPATH
environment variable. - Modify this path appropriately if you installed CasperJS to a different location.
- If your computer uses both discrete and integrated graphics you need to disable autoselect and explicitly choose graphics processor - otherwise
exit()
will not exit casper.
You can now run any regular casper scripts that way:
C:> casperjs myscript.js
Colorized output¶
Known Bugs & Limitations¶
- Due to its asynchronous nature, CasperJS doesn’t work well with PhantomJS’ REPL.