feat: add configurable script timeout (dequelabs#28)

This patch adds a `Builder#setTimeout` method for setting a configurable script timeout. Prior to this, we'd always timeout after 30 seconds.

Closes dequelabs#17.

Author: stephenmathieson

src/main/java/com/deque/axe/AXE.java

@@ -248,6 +248,7 @@ public static class Builder {
 		private final List<String> excludes = new ArrayList<String>();
 		private String options = "{}";
 		private Boolean skipFrames = false;
+		private int timeout = 30;
 
 		/**
 		 * Initializes the Builder class to chain configuration before analyzing pages.
@@ -259,6 +260,15 @@ public Builder(final WebDriver driver, final URL script) {
 			this.script = script;
 		}
 
+		/**
+		 * Set the script timeout.
+		 * @param timeout
+		 */
+		public Builder setTimeout(int timeout) {
+			this.timeout = timeout;
+			return this;
+		}
+
 		/**
 		 * Skips iframe checks
 		 */
@@ -357,7 +367,7 @@ public JSONObject analyze(final WebElement context) {
 		private JSONObject execute(final String command, final Object... args) {
 			AXE.inject(this.driver, this.script, this.skipFrames);
 
-			this.driver.manage().timeouts().setScriptTimeout(30, TimeUnit.SECONDS);
+			this.driver.manage().timeouts().setScriptTimeout(this.timeout, TimeUnit.SECONDS);
 
 			Object response = ((JavascriptExecutor) this.driver).executeAsyncScript(command, args);
 			JSONObject result = new JSONObject((Map) response);

src/test/java/com/deque/axe/ExampleTest.java

@@ -111,6 +111,26 @@ public void testAccessibilityWithOptions() {
 		}
 	}
 
+	@Test
+	public void testCustomTimeout() {
+		driver.get("http://localhost:5005");
+
+		boolean didTimeout = false;
+		try {
+			new AXE.Builder(driver, ExampleTest.class.getResource("/timeout.js"))
+				.setTimeout(1)
+				.analyze();
+		} catch (Exception e) {
+			String msg = e.getMessage();
+			if (msg.indexOf("1 seconds") == -1) {
+				assertTrue("Did not error with timeout message", msg.indexOf("1 seconds") != -1);
+			}
+			didTimeout = true;
+		}
+
+		assertTrue("Did set custom timeout", didTimeout);
+	}
+
 	/**
 	 * Test a specific selector or selectors
 	 */

src/test/resources/timeout.js

@@ -0,0 +1,8 @@
+// A fake axe-core that takes 5 minutes to finish
+window.axe = {
+  run: function (context, options, callback) {
+    setTimeout(function () {
+      callback()
+    }, 1000 * 60 * 5)
+  }
+}