SystemPropertiesConfiguration (Serenity Domain Model Classes 3.3.4 API)

java.lang.Object
- net.thucydides.core.configuration.SystemPropertiesConfiguration

All Implemented Interfaces:

Configuration
```
public class SystemPropertiesConfiguration
extends Object
implements Configuration
```
Centralized configuration of the test runner. You can configure the output directory, the browser to use, and the reports to generate. Most configuration elements can be set using system properties.

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_ELEMENT_TIMEOUT_SECONDS` Default timeout when waiting for AJAX elements in pages, in seconds.
`static Integer`	`DEFAULT_ESTIMATED_AVERAGE_STEP_COUNT`
`protected String`	`defaultBaseUrl`
`protected EnvironmentVariables`	`environmentVariables`
`protected File`	`outputDirectory` HTML and XML reports will be generated in this directory.
`static String`	`PROJECT_BUILD_DIRECTORY` If in system properties will be defined project.build.directory or project.reporting.OutputDirectory then it will be used for output for serenity test reports.
`static String`	`REFUSE_UNTRUSTED_CERTIFICATES` By default, when accepting untrusted SSL certificates, assume that these certificates will come from an untrusted issuer or will be self signed.

Constructor Summary

Constructors
Constructor and Description

SystemPropertiesConfiguration(EnvironmentVariables environmentVariables)

Constructors
Constructor and Description
`SystemPropertiesConfiguration(EnvironmentVariables environmentVariables)`

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`String`	`getBaseUrl()` This is the URL where test cases start.
`int`	`getCurrentTestCount()` This is the URL where test cases start.
`int`	`getElementTimeoutInSeconds()`
`EnvironmentVariables`	`getEnvironmentVariables()`
`double`	`getEstimatedAverageStepCount()`
`File`	`getHistoryDirectory()`
`File`	`getOutputDirectory()` The output directory is where the test runner writes the XML and HTML reports to.
`int`	`getRestartFrequency()`
`Optional<TakeScreenshots>`	`getScreenshotLevel()` How often should screenshots be taken.
`int`	`getStepDelay()`
`boolean`	`getUseUniqueBrowser()` Deprecated.
`File`	`loadHistoryDirectoryFromSystemProperties()`
`File`	`loadOutputDirectoryFromSystemProperties()` Where should the reports go?
`boolean`	`onlySaveFailingScreenshots()`
`void`	`reloadOutputDirectory()` If some property that can change output directory@Override was changed this method should be called
`void`	`setDefaultBaseUrl(String defaultBaseUrl)` Override the default base URL manually.
`void`	`setIfUndefined(String property, String value)`
`void`	`setOutputDirectory(File outputDirectory)`
`boolean`	`shouldUseAUniqueBrowser()` Deprecated.
`boolean`	`takeVerboseScreenshots()` Take a screenshot for each action.
`SystemPropertiesConfiguration`	`withEnvironmentVariables(EnvironmentVariables environmentVariables)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_ELEMENT_TIMEOUT_SECONDS
```
public static final int DEFAULT_ELEMENT_TIMEOUT_SECONDS
```
    Default timeout when waiting for AJAX elements in pages, in seconds.
    
    See Also:
    
    Constant Field Values
  - DEFAULT_ESTIMATED_AVERAGE_STEP_COUNT
```
public static final Integer DEFAULT_ESTIMATED_AVERAGE_STEP_COUNT
```
  - PROJECT_BUILD_DIRECTORY
```
public static final String PROJECT_BUILD_DIRECTORY
```
    If in system properties will be defined project.build.directory or project.reporting.OutputDirectory then it will be used for output for serenity test reports. By default maven NEVER push this properties to system environment, but they are available in maven. This property is used when maven/gradle build contains sub-projects
    
    See Also:
    
    Constant Field Values
  - REFUSE_UNTRUSTED_CERTIFICATES
```
public static final String REFUSE_UNTRUSTED_CERTIFICATES
```
    By default, when accepting untrusted SSL certificates, assume that these certificates will come from an untrusted issuer or will be self signed. Due to limitation within Firefox, it is easy to find out if the certificate has expired or does not match the host it was served for, but hard to find out if the issuer of the certificate is untrusted. By default, it is assumed that the certificates were not be issued from a trusted CA. If you are receive an "untrusted site" prompt on Firefox when using a certificate that was issued by valid issuer, but has expired or is being served served for a different host (e.g. production certificate served in a testing environment) set this to false.
  - outputDirectory
```
protected File outputDirectory
```
    HTML and XML reports will be generated in this directory.
  - defaultBaseUrl
```
protected String defaultBaseUrl
```
  - environmentVariables
```
protected EnvironmentVariables environmentVariables
```
- Constructor Detail
  - SystemPropertiesConfiguration
```
@Inject
public SystemPropertiesConfiguration(EnvironmentVariables environmentVariables)
```
- Method Detail
  - withEnvironmentVariables
```
public SystemPropertiesConfiguration withEnvironmentVariables(EnvironmentVariables environmentVariables)
```
    Specified by:
    
    withEnvironmentVariables in interface Configuration
  - getEnvironmentVariables
```
public EnvironmentVariables getEnvironmentVariables()
```
    Specified by:
    
    getEnvironmentVariables in interface Configuration
  - loadOutputDirectoryFromSystemProperties
```
public File loadOutputDirectoryFromSystemProperties()
```
    Where should the reports go?
  - loadHistoryDirectoryFromSystemProperties
```
public File loadHistoryDirectoryFromSystemProperties()
```
  - reloadOutputDirectory
```
public void reloadOutputDirectory()
```
    If some property that can change output directory@Override was changed this method should be called
  - getStepDelay
```
public int getStepDelay()
```
    Specified by:
    
    getStepDelay in interface Configuration
  - getElementTimeoutInSeconds
```
public int getElementTimeoutInSeconds()
```
    Specified by:
    
    getElementTimeoutInSeconds in interface Configuration
  - getUseUniqueBrowser
```
@Deprecated
public boolean getUseUniqueBrowser()
```
    Deprecated.
    
    Description copied from interface: Configuration
    
    Use shouldUseAUniqueBrowser() instead
    
    Specified by:
    
    getUseUniqueBrowser in interface Configuration
  - shouldUseAUniqueBrowser
```
@Deprecated
public boolean shouldUseAUniqueBrowser()
```
    Deprecated.
    
    Specified by:
    
    shouldUseAUniqueBrowser in interface Configuration
  - setOutputDirectory
```
public void setOutputDirectory(File outputDirectory)
```
    Specified by:
    
    setOutputDirectory in interface Configuration
  - getOutputDirectory
```
public File getOutputDirectory()
```
    The output directory is where the test runner writes the XML and HTML reports to. By default, it will be in 'target/site/serenity', but you can override this value either programmatically or by providing a value in the thucydides.output.dir system property.
    
    Specified by:
    
    getOutputDirectory in interface Configuration
  - getHistoryDirectory
```
public File getHistoryDirectory()
```
    Specified by:
    
    getHistoryDirectory in interface Configuration
  - getEstimatedAverageStepCount
```
public double getEstimatedAverageStepCount()
```
    Specified by:
    
    getEstimatedAverageStepCount in interface Configuration
  - onlySaveFailingScreenshots
```
public boolean onlySaveFailingScreenshots()
```
    Specified by:
    
    onlySaveFailingScreenshots in interface Configuration
  - takeVerboseScreenshots
```
public boolean takeVerboseScreenshots()
```
    Description copied from interface: Configuration
    
    Take a screenshot for each action.
    
    Specified by:
    
    takeVerboseScreenshots in interface Configuration
  - getScreenshotLevel
```
public Optional<TakeScreenshots> getScreenshotLevel()
```
    Description copied from interface: Configuration
    
    How often should screenshots be taken.
    
    Specified by:
    
    getScreenshotLevel in interface Configuration
  - setIfUndefined
```
public void setIfUndefined(String property,
                           String value)
```
    Specified by:
    
    setIfUndefined in interface Configuration
  - setDefaultBaseUrl
```
public void setDefaultBaseUrl(String defaultBaseUrl)
```
    Override the default base URL manually. Normally only needed for testing.
    
    Specified by:
    
    setDefaultBaseUrl in interface Configuration
  - getRestartFrequency
```
public int getRestartFrequency()
```
    Specified by:
    
    getRestartFrequency in interface Configuration
  - getCurrentTestCount
```
public int getCurrentTestCount()
```
    Description copied from interface: Configuration
    
    This is the URL where test cases start. The default value can be overriden using the webdriver.baseurl property. It is also the base URL used to build relative paths.
    
    Specified by:
    
    getCurrentTestCount in interface Configuration
  - getBaseUrl
```
public String getBaseUrl()
```
    This is the URL where test cases start. The default value can be overriden using the webdriver.baseurl property. It is also the base URL used to build relative paths.
    
    Specified by:
    
    getBaseUrl in interface Configuration

Class SystemPropertiesConfiguration

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_ELEMENT_TIMEOUT_SECONDS

DEFAULT_ESTIMATED_AVERAGE_STEP_COUNT

PROJECT_BUILD_DIRECTORY

REFUSE_UNTRUSTED_CERTIFICATES

outputDirectory

defaultBaseUrl

environmentVariables

Constructor Detail

SystemPropertiesConfiguration

Method Detail

withEnvironmentVariables

getEnvironmentVariables

loadOutputDirectoryFromSystemProperties

loadHistoryDirectoryFromSystemProperties

reloadOutputDirectory

getStepDelay

getElementTimeoutInSeconds

getUseUniqueBrowser

shouldUseAUniqueBrowser

setOutputDirectory

getOutputDirectory

getHistoryDirectory

getEstimatedAverageStepCount

onlySaveFailingScreenshots

takeVerboseScreenshots

getScreenshotLevel

setIfUndefined

setDefaultBaseUrl

getRestartFrequency

getCurrentTestCount

getBaseUrl