Using CasperJS in a Yeoman Workflow to Test for 404s on a Jekyll Site.

12 February 2014

Reading time ~5 min | Categories: geekery  testing 

I use the Yeoman Jekyll Generator to livereload and build my personal site. I love the automation. I've been wanting to introduce testing to my workflow for some time and, for a front-end developer, CasperJS looked like a good fit. This post outlines the steps I took to integrate a test for broken links on my site into my Yeoman workflow.

I'd love to hear of any improvements or alternative approaches. All the source files for my personal site are on GitHub at if you want to take a look.

First I installed PhantomJS (I'm on Windows to I downloaded the exe, saved it to C:\bin\phantomjs, then added that to my $PATH). Then I installed CasperJS using NPM.

Next I created a test folder ("test_casper") at the root of my project to keep testing separate from site generation. I split my test files into a logical set as suggested at and created a simple test (like the one here) to check it was working. I ran this from the console.

The next challenge was to test the site locally as it was generated. To do this I installed grunt-casper so that I could run casper as a task from my grunt file.

This is the task configuration:

casper : {
    uiTest : {
        src: ['test_casper/test.js'],
        options : {
            test: true

and this is the task call I put in the watch configuration:

casper: {
    files: [
        '<%= %>/**/*.{html,yml,md,mkd,markdown}',
    tasks: ['casper:uiTest']

Now, when I run "grunt serve" and then make a change to a watched file, the casperJS test is called each time. Running a test on each save is useful when developing my test but once the test is good, I'll comment it out and the next job is to run the test once the site is built for deployment.

The test itself checks all internal links (i.e. those on and has been useful for internal links I put in posts or navigation and have since changed. The test itself was based on the really useful script I found here: You can see the adapted version at

Once I get deployment tests up and running, the next step for me is to try and use a Continuous Integration platform like