Property Detail

• final BuildAdapter buildAdapter

• final ClassLoader classLoader

• final Properties properties

• final groovy.util.ConfigObject rawConfig

Constructor Detail

• Configuration(Map rawConfig)

• Configuration(groovy.util.ConfigObject rawConfig = null, Properties properties = null, BuildAdapter buildAdapter = null, ClassLoader classLoader = null)

Method Detail

• protected Reporter createDefaultReporter()

• protected WebDriver createDriver()

• NavigatorFactory createNavigatorFactory(Browser browser)

  Creates the navigator factory to be used. Returns BrowserBackedNavigatorFactory by default.

  Override by setting the 'navigatorFactory' to a closure that takes a single Browser argument and returns an instance of NavigatorFactory

  Returns:

  Parameters:

  browser - The browser to use as the basis of the navigatory factory.

• Wait getAtCheckWaiting()

• Wait getBaseNavigatorWaiting()

• String getBaseUrl()

  Returns the config value baseUrl, or BuildAdapter.getBaseUrl.

• Wait getDefaultWait()

• Double getDefaultWaitRetryInterval()

  The default retryInterval value to use for waiting (i.e. if unspecified).

  Either the value at config path waiting.retryInterval or 0.1.

• Double getDefaultWaitTimeout()

  The default timeout value to use for waiting (i.e. if unspecified).

  Either the value at config path waiting.timeout or 5.

• @SuppressWarnings("ClosureAsLastMethodParameter") Closure getDownloadConfig()

  Returns the default configuration closure to be applied before the user- supplied config closure when using the download support.

• WebDriver getDriver()

• def getDriverConf()

  Returns the configuration value for the driver.

  This may be the class name of a driver implementation, a short name, or a closure that when invoked returns an actual driver.

  See Also:

  getDriver()

• protected DriverFactory getDriverFactory(def driverValue)

• boolean getIncludeCauseInWaitTimeoutExceptionMessage()

  Returns Either the value at config path waiting.includeCauseInMessage or false if there is none.

  Determines if the message of WaitTimeoutException should contain a string representation of its cause.

• InnerNavigatorFactory getInnerNavigatorFactory()

  Returns the inner navigatory factory, that turns WebElements into Navigators. Returns DefaultInnerNavigatorFactory instances by default.

  To override, set 'innerNavigatorFactory' to:

  • An instance of InnerNavigatorFactory
  • A Closure, that has the signature (Browser, List<WebElement>)

  Returns:

  The inner navigator factory.

• Reporter getReporter()

  Returns the reporter implementation to use for taking snapshots of the browser's state.

  Returns the config value reporter, or reporter that records page source and screen shots if not explicitly set.

• ReportingListener getReportingListener()

• File getReportsDir()

  Returns the config value reportsDir, or BuildAdapter.getReportsDir.

• Collection<Class<? extends Page>> getUnexpectedPages()

• Wait getWait(Double timeout)

• Wait getWaitForParam(def waitingParam)

• Wait getWaitPreset(String name)

• boolean isAutoClearCookies()

  Whether or not to automatically clear the browser's cookies automatically.

  Different integrations inspect this property at different times.

  Returns:

  the config value for autoClearCookies, defaulting to true if not set.

• boolean isCacheDriver()

  Should the created driver be cached if there is no existing cached driver, of if there is a cached driver should it be used instead of creating a new one.

  The value is the config entry cacheDriver, which defaults to true.

• boolean isCacheDriverPerThread()

  The driver is to be cached, this setting controls whether or not the driver is cached per thread, or per

  The value is the config entry cacheDriverPerThread, which defaults to true.

• boolean isQuitCachedDriverOnShutdown()

  If a cached driver is being used, should it be automatically quit when the JVM exits.

  The value is the config entry quitCachedDriverOnShutdown, which defaults to true.

• boolean isReportOnTestFailureOnly()

• protected def readValue(String name, def defaultValue)

• protected def readValue(groovy.util.ConfigObject config, String name, def defaultValue)

• void setAtCheckWaiting(Object waitForParam)

• void setAutoClearCookies(boolean flag)

  Sets the auto clear cookies flag explicitly, overwriting any value from the config script.

• void setBaseNavigatorWaiting(Object waitForParam)

• void setBaseUrl(def baseUrl)

• void setCacheDriver(boolean flag)

  Updates the cacheDriver config entry.

  See Also:

  isCacheDriver()

• void setCacheDriverPerThread(boolean flag)

  Updates the cacheDriverPerThread config entry.

  See Also:

  isCacheDriverPerThread()

• void setDefaultWaitRetryInterval(Double defaultWaitRetryInterval)

  Updates the waiting.retryInterval config entry.

  See Also:

  getDefaultWaitRetryInterval()

• void setDefaultWaitTimeout(Double defaultWaitTimeout)

  Updates the waiting.timeout config entry.

  See Also:

  getDefaultWaitTimeout()

• void setDownloadConfig(Closure config)

• void setDriver(WebDriver driver)

• void setDriverConf(def value)

  Sets the driver configuration value.

  This may be the class name of a driver implementation, a driver short name or a closure that when invoked with no arguments returns a driver implementation.

  See Also:

  getDriver()

• void setIncludeCauseInWaitTimeoutExceptionMessage(boolean include)

  Updates the waiting.includeCauseInMessage config entry.

  See Also:

  getIncludeCauseInWaitTimeoutExceptionMessage()

• void setInnerNavigatorFactory(InnerNavigatorFactory innerNavigatorFactory)

  Sets the inner navigator factory. Only effectual before the browser calls createNavigatorFactory(Browser) initially.

  Parameters:

  innerNavigatorFactory

• void setQuitCacheDriverOnShutdown(boolean flag)

  Sets whether or not the cached driver should be quit when the JVM shuts down.

• def setReportOnTestFailureOnly(boolean value)

• void setReporter(Reporter reporter)

  Updates the reporter config entry.

  See Also:

  getReporter()

• void setReportingListener(ReportingListener reportingListener)

• void setReportsDir(File reportsDir)

• void setUnexpectedPages(Collection<Class<? extends Page>> pages)

• void setWaitPreset(String name, Double presetTimeout, Double presetRetryInterval)

  Updates a waiting.preset config entry for a given preset name.

• protected DriverFactory wrapDriverFactoryInCachingIfNeeded(DriverFactory factory)