qunit-mojo

A maven plugin for quickly and easily creating, refactoring and running qunit tests

Goals:

• qunit:test -> runs all your '*.qunit.js' or '*.qunit.coffee' files as qunit tests using phantomjs (or, optionally, qunit-test-driver)
• qunit:serve -> starts an http server and serves your code so you can run it in the browser

Options:

• -Dqunit.numThreads=N -> executes qunit tests in parallel using N threads, a 'C' suffix (e.g. 1C) will multiply by the number of cores on the system.
• -Dqunit.filter=foo -> executes only those tests which have 'foo' in their name/path
• -Dqunit.verbose=true/false -> logs verbose output for debugging (default=false)
• -Dqunit.preserveTempFiles=true/false -> preserves generated temp files for with debugging (default=false)
• -Dqunit.retryCount=N -> how many times to retry a test when phantomjs crashes (default=1)

Example:

/* src/main/foo/my-first-test.qunit.js */
define([], function(){
    test("my first failing test", function(){
        ok(false);
    });
});

stu@knox:~/projects/my-web-project mvn qunit:test
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building my-web-project - com.cj.example:my-web-project:jar:0.0.1-SNAPSHOT
[INFO]    task-segment: [qunit:test]
[INFO] ------------------------------------------------------------------------
[INFO] [qunit:test {execution: default-cli}]
The extra paths are []
2013-06-21 14:03:04.270:INFO::Logging to STDERR via org.mortbay.log.StdErrLog
2013-06-21 14:03:04.272:INFO::jetty-6.1.24
2013-06-21 14:03:04.284:INFO::Started [email protected]:8098
[INFO] Executing qunit tests on 1 thread(s) using phantomjs
[INFO] Running: my-first-test.qunit.js
Tests run: 1, Passed: 0, Failures: 1, Time elapsed: 22 ms <<< FAILURE!
2013-06-21 14:03:04.527:INFO::Stopped [email protected]:8098
[INFO] ------------------------------------------------------------------------
[ERROR] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Problems found in 'my-first-test.qunit.js

[INFO] ------------------------------------------------------------------------
[INFO] For more information, run Maven with the -e switch
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Fri Jun 21 14:03:04 PDT 2013
[INFO] Final Memory: 12M/302M
[INFO] ------------------------------------------------------------------------

Setup:

<project>
      --- SNIP ---
    <build>
        <plugins>
            <plugin>
                <groupId>com.cj.qunit.mojo</groupId>
                <artifactId>qunit-maven-plugin</artifactId>
                <version>2.0.6</version>
                <executions>
                    <execution>
                        <phase>test</phase>
                        <goals>
                            <goal>test</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

Notes:

• coffeescript support is provided by the require-cs plugin.
  • If not using the default require config then you will need to make sure the plugin is available under the default 'cs' path.