Taking Screenshots with CasperJS

Last reviewed on April 30, 2015

Lately I have been trying out more end-to-end / integration testing with CasperJS. Having these tests in place seems valuable for critical paths of an application but it can be pretty frustrating when sometimes tests pass and other times they fail. For me, the test results have not been consistent. Because CasperJS doesn't pop open a browser, it is difficult to know what exactly is going wrong. Many times I had a hunch that my tests were failing because of race conditions with the loading of the JavaScript of the pages under test. Then I discovered that CasperJS allows you take screenshots at any point during your test. This allows me to see if pages are fully rendering before assertions!

To take a screenshot in your test, simply use the casper.capture() method.


So a full test with several screenshots might look something like this:

casper.test.begin('Testing Amazon Search and Results pages', 1, function (
) {
  casper.start('http://amazon.com', function () {
        'field-keywords': 'javascript',

  casper.then(function () {
    test.assertTitle('Amazon.com: javascript');

  casper.run(function () {

In the test above, I am taking 3 screenshots. I like to name the images the same filename but suffixed with an incrementing number to identify the order that they were taken in.

One thing to note, if your screenshots look as if the pages under test were viewed on a mobile device, this is because PhantomJS ships with a default viewport of 400x300 and CasperJS does not override it, as mentioned in the docs. To set the viewportSize, you can do the following at the top of your test script:

casper.options.viewportSize = { width: 950, height: 950 };

Now CasperJS will render the pages under test on a browser that is 950x950, more like if you were viewing the site in a desktop browser.

Happy testing!