Welcome to the Crawljax Testing page

What is Crawljax?

Crawljax is a Java tool for automatically crawling and testing AJAX based applications.

Crawljax can crawl any AJAX based web application by clicking links and filling in form data. It creates a state-flow graph of the states of the web application. This state-flow graph which is a very powerful base for many types of automated tests.

This site explains how to configure Crawljax and also acts as a test site for Crawljax.

Applications for Crawljax

• Invariant-based testing
• Regression testing
• Non functional testing (Accessibility, I18n, security, ...)
• Detecting broken links/images/tooltips
• And via its plugin support even more....

Setup

Setting up Crawljax only takes a couple of minutes:

• Create a new Java project.
• Include the Crawljax.jar (and its needed libraries) to your project.
• Copy/paste the code fragment below.

CrawljaxConfiguration config = new CrawljaxConfiguration();
CrawlSpecification crawler = new CrawlSpecification("http://www.google.com");

// click these elements
crawler.click("a");
crawler.click("input").withAttribute("type", "submit");

// except these
crawler.dontClick("a").underXPath("//DIV[@id='guser']");
crawler.dontClick("a").withText("Language Tools");

InputSpecification input = new InputSpecification();
input.field("q").setValue("Crawljax");
crawler.setInputSpecification(input);

// limit the crawling scope
crawler.setMaximumStates(5);
crawler.setDepth(2);

config.setCrawlSpecification(crawler);
CrawljaxController crawljax = new CrawljaxController(config);
try {
  crawljax.start();
} catch (Exception e) {
  e.printStackTrace();
  System.exit(1);
}

Requirements

• Java 1.6
• Browser: Internet Explorer or Firefox (or any other browser supported by WebDriver)