Class FirefoxOptions

java.lang.Object

org.openqa.selenium.MutableCapabilities

org.openqa.selenium.remote.AbstractDriverOptions<FirefoxOptions>

org.openqa.selenium.firefox.FirefoxOptions

All Implemented Interfaces:

Serializable, Capabilities

public class FirefoxOptions
extends AbstractDriverOptions<FirefoxOptions>

Manage firefox specific settings in a way that geckodriver can understand.

An example of usage:

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

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FIREFOX_OPTIONS

Constructor Summary

Constructors

Constructor	Description
FirefoxOptions()
FirefoxOptions(Capabilities source)
FirefoxOptions(FirefoxProfile profile)

Method Summary

Modifier and Type	Method	Description
FirefoxOptions	addArguments(String... arguments)
FirefoxOptions	addArguments(List<String> arguments)
FirefoxOptions	addPreference(String key, Object value)
FirefoxOptions	configureFromEnv()	Configures the following: Binary webdriver.firefox.bin - the path to the firefox binary Firefox profile webdriver.firefox.profile - a named firefox profile
FirefoxOptions	enableBiDi()
protected @Nullable Object	getExtraCapability(String capabilityName)
protected Set<String>	getExtraCapabilityNames()
FirefoxProfile	getProfile()
FirefoxOptions	merge(Capabilities capabilities)	Merge two Capabilities together and return the union of the two as a new Capabilities instance.
FirefoxOptions	setAndroidActivity(String activity)
FirefoxOptions	setAndroidDeviceSerialNumber(String serial)
FirefoxOptions	setAndroidIntentArguments(String[] args)
FirefoxOptions	setAndroidIntentArguments(List<String> args)
FirefoxOptions	setAndroidPackage(String androidPackage)
FirefoxOptions	setBinary(String path)
FirefoxOptions	setBinary(Path path)
FirefoxOptions	setLogLevel(FirefoxDriverLogLevel logLevel)
final FirefoxOptions	setProfile(FirefoxProfile profile)

Methods inherited from class AbstractDriverOptions

asMap, getCapability, getCapabilityNames, setAcceptInsecureCerts, setBrowserVersion, setEnableDownloads, setImplicitWaitTimeout, setPageLoadStrategy, setPageLoadTimeout, setPlatformName, setProxy, setScriptTimeout, setStrictFileInteractability, setUnhandledPromptBehaviour

Methods inherited from class MutableCapabilities

equals, hashCode, setCapability, setCapability, setCapability, setCapability, toJson, toString

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Capabilities

get, getBrowserName, getBrowserVersion, getPlatformName, is, required

Field Details

FIREFOX_OPTIONS

public static final String FIREFOX_OPTIONS

See Also:

• Constant Field Values

Constructor Details

FirefoxOptions

public FirefoxOptions()

FirefoxOptions

public FirefoxOptions(FirefoxProfile profile)

FirefoxOptions

public FirefoxOptions(Capabilities source)

Method Details

configureFromEnv

public FirefoxOptions configureFromEnv()

Configures the following:

Binary

webdriver.firefox.bin - the path to the firefox binary

Firefox profile

webdriver.firefox.profile - a named firefox profile

setBinary

public FirefoxOptions setBinary(Path path)

setBinary

public FirefoxOptions setBinary(String path)

getProfile

public FirefoxProfile getProfile()

setProfile

public final FirefoxOptions setProfile(FirefoxProfile profile)

addArguments

public FirefoxOptions addArguments(String... arguments)

addArguments

public FirefoxOptions addArguments(List<String> arguments)

addPreference

public FirefoxOptions addPreference(String key,
 Object value)

setLogLevel

public FirefoxOptions setLogLevel(FirefoxDriverLogLevel logLevel)

setAndroidPackage

public FirefoxOptions setAndroidPackage(String androidPackage)

setAndroidActivity

public FirefoxOptions setAndroidActivity(String activity)

setAndroidDeviceSerialNumber

public FirefoxOptions setAndroidDeviceSerialNumber(String serial)

setAndroidIntentArguments

public FirefoxOptions setAndroidIntentArguments(String[] args)

setAndroidIntentArguments

public FirefoxOptions setAndroidIntentArguments(List<String> args)

enableBiDi

public FirefoxOptions enableBiDi()

getExtraCapabilityNames

protected Set<String> getExtraCapabilityNames()

Specified by:

getExtraCapabilityNames in class AbstractDriverOptions<FirefoxOptions>

getExtraCapability

protected @Nullable Object getExtraCapability(String capabilityName)

Specified by:

getExtraCapability in class AbstractDriverOptions<FirefoxOptions>

merge

public FirefoxOptions merge(Capabilities capabilities)

Description copied from class: MutableCapabilities

Merge two Capabilities together and return the union of the two as a new Capabilities instance. Capabilities from other will override those in this.

Specified by:

merge in interface Capabilities

Overrides:

merge in class MutableCapabilities