org.openqa.selenium.firefox

Class FirefoxBinary

java.lang.Object

org.openqa.selenium.firefox.FirefoxBinary

public class FirefoxBinary
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FirefoxBinary.Channel Enumerates Firefox channels, according to https://wiki.mozilla.org/RapidRelease

Constructor Summary

Constructors

Constructor and Description
FirefoxBinary()
FirefoxBinary(java.io.File pathToFirefoxBinary)
FirefoxBinary(FirefoxBinary.Channel channel)

Method Summary

Modifier and Type	Method and Description
void	addCommandLineOptions(java.lang.String... options)
protected java.lang.String	extractAndCheck(java.io.File profileDir, java.lang.String noFocusSoName, java.lang.String jarPath32Bit, java.lang.String jarPath64Bit)
java.lang.String	getConsoleOutput() Gets all console output of the binary.
java.util.Map<java.lang.String,java.lang.String>	getExtraEnv() Deprecated. No replacement. Environment should be configured in DriverService instance.
protected java.io.File	getFile()
protected java.lang.String	getPath()
long	getTimeout()
protected boolean	isOnLinux()
protected void	modifyLinkLibraryPath(java.io.File profileDir)
void	quit()
void	setEnvironmentProperty(java.lang.String propertyName, java.lang.String value) Deprecated.
void	setOutputWatcher(java.io.OutputStream stream)
void	setTimeout(long timeout)
protected void	startFirefoxProcess(org.openqa.selenium.os.CommandLine command)
void	startProfile(FirefoxProfile profile, java.io.File profileDir, java.lang.String... commandLineFlags)
java.lang.String	toString()
void	waitFor() Waits for the process to execute, returning the command output taken from the profile's execution.
void	waitFor(long timeout) Waits for the process to execute, returning the command output taken from the profile's execution.

Methods inherited from class java.lang.Object

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

Constructor Detail

FirefoxBinary

public FirefoxBinary()

FirefoxBinary

public FirefoxBinary(FirefoxBinary.Channel channel)

FirefoxBinary

public FirefoxBinary(java.io.File pathToFirefoxBinary)

Method Detail

setEnvironmentProperty

@Deprecated
public void setEnvironmentProperty(java.lang.String propertyName,
                                               java.lang.String value)

Deprecated.

deprecated Use DriverService.Builder#withEnvironment(Map) instead:

new FirefoxDriver( new GeckoDriverService.Builder() .usingDriverExecutable(new File("path/to/geckodriver.exe")) .usingFirefoxBinary(new FirefoxBinary(new File("path/to/firefox.exe"))) .withEnvironment(ImmutableMap.of("DISPLAY", "0:0")) .build());

Parameters:

propertyName -

value -

addCommandLineOptions

public void addCommandLineOptions(java.lang.String... options)

isOnLinux

protected boolean isOnLinux()

startProfile

public void startProfile(FirefoxProfile profile,
                         java.io.File profileDir,
                         java.lang.String... commandLineFlags)
                  throws java.io.IOException

Throws:

java.io.IOException

startFirefoxProcess

protected void startFirefoxProcess(org.openqa.selenium.os.CommandLine command)
                            throws java.io.IOException

Throws:

java.io.IOException

getFile

protected java.io.File getFile()

getPath

protected java.lang.String getPath()

getExtraEnv

@Deprecated
public java.util.Map<java.lang.String,java.lang.String> getExtraEnv()

Deprecated. No replacement. Environment should be configured in DriverService instance.

modifyLinkLibraryPath

protected void modifyLinkLibraryPath(java.io.File profileDir)

extractAndCheck

protected java.lang.String extractAndCheck(java.io.File profileDir,
                                           java.lang.String noFocusSoName,
                                           java.lang.String jarPath32Bit,
                                           java.lang.String jarPath64Bit)

waitFor

public void waitFor()
             throws java.lang.InterruptedException,
                    java.io.IOException

Waits for the process to execute, returning the command output taken from the profile's execution.

Throws:

java.lang.InterruptedException - if we are interrupted while waiting for the process to launch

java.io.IOException - if there is a problem with reading the input stream of the launching process

waitFor

public void waitFor(long timeout)
             throws java.lang.InterruptedException,
                    java.io.IOException

Waits for the process to execute, returning the command output taken from the profile's execution.

Parameters:

timeout - the maximum time to wait in milliseconds

Throws:

java.lang.InterruptedException - if we are interrupted while waiting for the process to launch

java.io.IOException - if there is a problem with reading the input stream of the launching process

getConsoleOutput

public java.lang.String getConsoleOutput()
                                  throws java.io.IOException

Gets all console output of the binary. Output retrieval is non-destructive and non-blocking.

Returns:

the console output of the executed binary.

Throws:

java.io.IOException - IO exception reading from the output stream of the firefox process

getTimeout

public long getTimeout()

setTimeout

public void setTimeout(long timeout)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

setOutputWatcher

public void setOutputWatcher(java.io.OutputStream stream)

quit

public void quit()