Package org.openqa.selenium.firefox

Class FirefoxDriver

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.firefox.FirefoxDriver

All Implemented Interfaces:

HasDevTools, HasExtensions, HasCapabilities, WebStorage, HasInputDevices, Interactive, JavascriptExecutor, PrintsPage, SearchContext, TakesScreenshot, HasVirtualAuthenticator, WebDriver

public class FirefoxDriver
extends RemoteWebDriver
implements WebStorage, HasExtensions, HasDevTools

An implementation of the {#link WebDriver} interface that drives Firefox.

The best way to construct a FirefoxDriver with various options is to make use of the FirefoxOptions, like so:

 FirefoxOptions options = new FirefoxOptions()
     .addPreference("browser.startup.page", 1)
     .addPreference("browser.startup.homepage", "https://www.google.co.uk")
     .setAcceptInsecureCerts(true)
     .setHeadless(true);
 WebDriver driver = new FirefoxDriver(options);
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	FirefoxDriver.Capability
static class	FirefoxDriver.SystemProperty

Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver

RemoteWebDriver.RemoteTargetLocator, RemoteWebDriver.RemoteWebDriverOptions, RemoteWebDriver.When

Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver

WebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts, WebDriver.Window

Field Summary

Fields

Modifier and Type	Field	Description
protected FirefoxBinary	binary
static java.lang.String	BINARY	Deprecated. Use FirefoxDriver.Capability.BINARY
static java.lang.String	MARIONETTE	Deprecated. Use FirefoxDriver.Capability.MARIONETTE
static java.lang.String	PROFILE	Deprecated. Use FirefoxDriver.Capability.PROFILE

Constructor Summary

Constructors

Constructor	Description
FirefoxDriver()
FirefoxDriver(Capabilities desiredCapabilities)	Deprecated. Use FirefoxDriver(FirefoxOptions).
FirefoxDriver(FirefoxDriverService service)
FirefoxDriver(FirefoxDriverService service, Capabilities desiredCapabilities)	Deprecated. Use FirefoxDriver(FirefoxDriverService, FirefoxOptions).
FirefoxDriver(FirefoxDriverService service, FirefoxOptions options)
FirefoxDriver(FirefoxOptions options)

Method Summary

Modifier and Type	Method	Description
DevTools	getDevTools()
<X> X	getFullPageScreenshotAs(OutputType<X> outputType)	Capture the full page screenshot and store it in the specified location.
LocalStorage	getLocalStorage()
SessionStorage	getSessionStorage()
java.lang.String	installExtension(java.nio.file.Path path)	Installs an extension.
void	setFileDetector(FileDetector detector)	Set the file detector to be used when sending keyboard input.
void	uninstallExtension(java.lang.String extensionId)	Uninstall the extension by the given identifier.

Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver

addVirtualAuthenticator, builder, close, execute, execute, execute, executeAsyncScript, executeScript, findElement, findElement, findElements, findElements, findElements, get, getCapabilities, getCommandExecutor, getCurrentUrl, getElementConverter, getErrorHandler, getExecuteMethod, getFileDetector, getKeyboard, getMouse, getPageSource, getScreenshotAs, getSessionId, getTitle, getWindowHandle, getWindowHandles, log, manage, navigate, perform, print, quit, removeVirtualAuthenticator, resetInputState, setCommandExecutor, setElementConverter, setErrorHandler, setFoundBy, setLogLevel, setSessionId, startSession, switchTo, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openqa.selenium.JavascriptExecutor

executeScript, getPinnedScripts, pin, unpin

Field Detail

BINARY

@Deprecated
public static final java.lang.String BINARY

Deprecated.

Use FirefoxDriver.Capability.BINARY

See Also:

Constant Field Values

PROFILE

@Deprecated
public static final java.lang.String PROFILE

Deprecated.

Use FirefoxDriver.Capability.PROFILE

See Also:

Constant Field Values

MARIONETTE

@Deprecated
public static final java.lang.String MARIONETTE

Deprecated.

Use FirefoxDriver.Capability.MARIONETTE

See Also:

Constant Field Values

binary

protected FirefoxBinary binary

Constructor Detail

FirefoxDriver

public FirefoxDriver()

FirefoxDriver

@Deprecated
public FirefoxDriver(Capabilities desiredCapabilities)

Deprecated.

Use FirefoxDriver(FirefoxOptions).

FirefoxDriver

@Deprecated
public FirefoxDriver(FirefoxDriverService service,
                     Capabilities desiredCapabilities)

Deprecated.

Use FirefoxDriver(FirefoxDriverService, FirefoxOptions).

FirefoxDriver

public FirefoxDriver(FirefoxOptions options)

FirefoxDriver

public FirefoxDriver(FirefoxDriverService service)

FirefoxDriver

public FirefoxDriver(FirefoxDriverService service,
                     FirefoxOptions options)

Method Detail

setFileDetector

public void setFileDetector(FileDetector detector)

Description copied from class: RemoteWebDriver

Set the file detector to be used when sending keyboard input. By default, this is set to a file detector that does nothing.

Overrides:

setFileDetector in class RemoteWebDriver

Parameters:

detector - The detector to use. Must not be null.

See Also:

FileDetector, LocalFileDetector, UselessFileDetector

getLocalStorage

public LocalStorage getLocalStorage()

Specified by:

getLocalStorage in interface WebStorage

getSessionStorage

public SessionStorage getSessionStorage()

Specified by:

getSessionStorage in interface WebStorage

installExtension

public java.lang.String installExtension(java.nio.file.Path path)

Description copied from interface: HasExtensions

Installs an extension.

Specified by:

installExtension in interface HasExtensions

Parameters:

path - absolute path to the extension file that should be installed.

Returns:

the unique identifier of the installed extension.

uninstallExtension

public void uninstallExtension(java.lang.String extensionId)

Description copied from interface: HasExtensions

Uninstall the extension by the given identifier.

Specified by:

uninstallExtension in interface HasExtensions

Parameters:

extensionId - The unique extension identifier returned by {HasExtensions.installExtension(Path)}

getFullPageScreenshotAs

public <X> X getFullPageScreenshotAs(OutputType<X> outputType)
                              throws WebDriverException

Capture the full page screenshot and store it in the specified location.

Type Parameters:

X - Return type for getFullPageScreenshotAs.

Parameters:

outputType - target type, @see OutputType

Returns:

Object in which is stored information about the screenshot.

Throws:

WebDriverException - on failure.

getDevTools

public DevTools getDevTools()

Specified by:

getDevTools in interface HasDevTools