Introduction

QUnitTestDriver supports some additional configuration options that you can supply right inside of your Java test - No need to edit external configuration files such as XML or build scripts. Configuration is managed through the optional Varargs of Configuration objects like this:

@Test public void testQunitPage(){
   QUnitTestDriver.run("path/to/qUnitTest.html", new Configuration(configurationOptions)...);
}

Pausing The Test Just After The Server Starts

Javascript treats HTML loaded from a "file://" URL different from HTML loaded from an "HTTP://" URL. For this reason, QUnitTestDriver starts a lightweight Jetty server for each test. It's common, especially when first starting, to have trouble where exactly the test is relative to where Jetty started. This configuration option will cause the test to join to the Jetty server which prevents the test from completing on its own.

@Test public void testQunitPage(){
   QUnitTestDriver.run("path/to/qUnitTest.html", new JoinToServer());
}

Changing The Port The Server Runs On

QUnitTestDriver is configured to try a fixed set of ports by default. Each time the internal server starts, a set of ports is consulted in order until the server is able to start. This is good if you use a CI system such as Jenkins that could run several tests in parallel on the same machine. You can configure the port or ports that are tried by passing in a new set.

@Test public void testQunitPage(){
   QUnitTestDriver.run("path/to/qUnitTest.html", new PortSet(8080, 8081, 8082));
}

Changing The Server Root

Let's say you don't like where the server starts from...

@Test public void testQunitPage(){
   QUnitTestDriver.run("path/to/qUnitTest.html", new ServerRoot("/some/path/on/the/file/system"));
}

Even better, feel free to subclass ServerRoot and set the internal variable "root" using whatever methodology you'd like. I'd be interested in contributions of better ways to do this from the community!

Emulating Different Browsers

QunitTestDriver uses HTMLUnit under the covers which comes along with the ability to emulate different browsers. The default is Firefox 3.6, but you can choose a different browser like this:

@Test public void testQunitPage(){ 
QUnitTestDriver.run("path/to/qUnitTest.html", new EmulateBrowser(BrowserVersion.INTERNET_EXPLORER_8)); 
} 

Browsers available are listed in the HTMLUnit Documentation.

Configuring Lots Of Stuff

QUnitTestDriver takes a varargs of Configurations, so you can pass many in together:

@Test public void testQunitPage(){
   QUnitTestDriver.run(
      "path/to/qUnitTest.html", 
      new ServerRoot("/some/path/on/the/file/system"), 
      new PortSet(8080, 8081, 8082)
   );
}