Package com.xceptance.xlt.api.webdriver

Class XltFirefoxDriver

java.lang.Object
org.openqa.selenium.remote.RemoteWebDriver
org.openqa.selenium.firefox.FirefoxDriver
com.xceptance.xlt.api.webdriver.XltFirefoxDriver
All Implemented Interfaces:
HasBiDi, HasFederatedCredentialManagement, HasContext, HasExtensions, HasFullPageScreenshot, HasCapabilities, HasDownloads, org.openqa.selenium.html5.WebStorage, Interactive, JavascriptExecutor, PrintsPage, SearchContext, TakesScreenshot, HasVirtualAuthenticator, WebDriver
public final class XltFirefoxDriver extends FirefoxDriver
An extended FirefoxDriver which allows to record data about requests and browser events or to run Firefox with a virtual display.

Collected Data

To collect data about requests and browser events, a special extension will be installed into the browser. This extension provides access to the following information:

  • for requests:
    • start and total processing time
    • URL, status code, response content type
    • sent and received bytes
    • network timings (DNS time, connect time, send time, server busy time, receive time, time to first byte, time to last byte)
  • for browser events:
    • the time after which the event occurred when loading a new page
The following browser events will be reported:
  • DomLoading
  • DomInteractive
  • DomComplete
  • DomContentLoadedEventStart
  • DomContentLoadedEventEnd
  • LoadEventStart
  • LoadEventEnd
All this data will be available in the XLT load test report. Request data is shown in the Requests section and browser events can be found in the Page Load Timings section.

Headless Mode

On Unix machines, it is possible to run the browser in "headless" mode, i.e. with a virtual display. To put the browser in headless mode, simply set the following property in the configuration of your test project: 

 xlt.webDriver.firefox_clientperformance.screenless = true
Note that for the headless mode to work, the xvfb binary must be installed on the target machine and must be located in one of the directories listed in the PATH environment variable. If this is not the case, the browser will be run with the default display.

  • Constructor Details

    • XltFirefoxDriver

      public XltFirefoxDriver()
      Creates a new XltFirefoxDriver instance with default settings.

    • XltFirefoxDriver

      public XltFirefoxDriver(FirefoxOptions options)
      Creates a new XltFirefoxDriver instance with the given parameters and otherwise default settings.
      Parameters:
      options - the driver options (may be null)

    • XltFirefoxDriver

      public XltFirefoxDriver(FirefoxOptions options, boolean screenless)
      Creates a new XltFirefoxDriver instance with the given parameters.
      Parameters:
      options - the driver options (may be null)
      screenless - whether to run the browser in screenless mode (overrides the "xlt.webDriver.firefox_clientperformance.screenless" setting in the configuration)

  • Method Details