org.openqa.selenium.firefox
Class FirefoxDriver

java.lang.Object
  extended by org.openqa.selenium.remote.RemoteWebDriver
      extended by org.openqa.selenium.firefox.FirefoxDriver
All Implemented Interfaces:
HasCapabilities, HasInputDevices, FindsByClassName, FindsByCssSelector, FindsById, FindsByLinkText, FindsByName, FindsByTagName, FindsByXPath, JavascriptExecutor, SearchContext, TakesScreenshot, WebDriver

public class FirefoxDriver
extends RemoteWebDriver
implements TakesScreenshot

An implementation of the {#link WebDriver} interface that drives Firefox. This works through a firefox extension, which gets installed automatically if necessary. Important system variables are:

When the driver starts, it will make a copy of the profile it is using, rather than using that profile directly. This allows multiple instances of firefox to be started.


Nested Class Summary
 
Nested classes/interfaces inherited from class org.openqa.selenium.remote.RemoteWebDriver
RemoteWebDriver.RemoteMouse, RemoteWebDriver.RemoteTargetLocator, RemoteWebDriver.RemoteWebDriverOptions
 
Nested classes/interfaces inherited from interface org.openqa.selenium.WebDriver
WebDriver.ImeHandler, WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts
 
Field Summary
static boolean ACCEPT_UNTRUSTED_CERTIFICATES
           
static boolean ASSUME_UNTRUSTED_ISSUER
           
protected  FirefoxBinary binary
           
static String BINARY
           
static boolean DEFAULT_ENABLE_NATIVE_EVENTS
           
static String PROFILE
           
 
Constructor Summary
FirefoxDriver()
           
FirefoxDriver(Capabilities capabilities)
           
FirefoxDriver(FirefoxBinary binary, FirefoxProfile profile)
           
FirefoxDriver(FirefoxProfile profile)
           
 
Method Summary
protected  ExtensionConnection connectTo(FirefoxBinary binary, FirefoxProfile profile, String host)
           
<X> X
getScreenshotAs(OutputType<X> target)
          Capture the screenshot and store it in the specified location.
protected  FirefoxWebElement newRemoteWebElement()
          Creates a new RemoteWebElement that is a child of this instance.
protected  Lock obtainLock()
           
 void saveScreenshot(File pngFile)
          Deprecated. Use getScreenshotAs(file), which returns a temporary file.
protected  void startClient()
          Method called before starting a new session.
protected  void stopClient()
          Method called after executing a RemoteWebDriver.quit() command.
 
Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver
close, execute, execute, executeAsyncScript, executeScript, findElement, findElement, findElementByClassName, findElementByCssSelector, findElementById, findElementByLinkText, findElementByName, findElementByPartialLinkText, findElementByTagName, findElementByXPath, findElements, findElements, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByLinkText, findElementsByName, findElementsByPartialLinkText, findElementsByTagName, findElementsByXPath, get, getCapabilities, getCommandExecutor, getCurrentUrl, getElementConverter, getErrorHandler, getExecuteMethod, getKeyboard, getMouse, getPageSource, getSessionId, getTitle, getWindowHandle, getWindowHandles, log, manage, navigate, quit, setCommandExecutor, setElementConverter, startSession, switchTo
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

BINARY

public static final String BINARY
See Also:
Constant Field Values

PROFILE

public static final String PROFILE
See Also:
Constant Field Values

DEFAULT_ENABLE_NATIVE_EVENTS

public static final boolean DEFAULT_ENABLE_NATIVE_EVENTS

ACCEPT_UNTRUSTED_CERTIFICATES

public static final boolean ACCEPT_UNTRUSTED_CERTIFICATES
See Also:
Constant Field Values

ASSUME_UNTRUSTED_ISSUER

public static final boolean ASSUME_UNTRUSTED_ISSUER
See Also:
Constant Field Values

binary

protected FirefoxBinary binary
Constructor Detail

FirefoxDriver

public FirefoxDriver()

FirefoxDriver

public FirefoxDriver(FirefoxProfile profile)

FirefoxDriver

public FirefoxDriver(Capabilities capabilities)

FirefoxDriver

public FirefoxDriver(FirefoxBinary binary,
                     FirefoxProfile profile)
Method Detail

startClient

protected void startClient()
Description copied from class: RemoteWebDriver
Method called before starting a new session. The default implementation is a no-op, but subtypes should override this method to define custom behavior.

Overrides:
startClient in class RemoteWebDriver

connectTo

protected ExtensionConnection connectTo(FirefoxBinary binary,
                                        FirefoxProfile profile,
                                        String host)

obtainLock

protected Lock obtainLock()

stopClient

protected void stopClient()
Description copied from class: RemoteWebDriver
Method called after executing a RemoteWebDriver.quit() command. Subtypes

Overrides:
stopClient in class RemoteWebDriver

newRemoteWebElement

protected FirefoxWebElement newRemoteWebElement()
Description copied from class: RemoteWebDriver
Creates a new RemoteWebElement that is a child of this instance. Subtypes should override this method to customize the type of RemoteWebElement returned.

Overrides:
newRemoteWebElement in class RemoteWebDriver
Returns:
A new RemoteWebElement that is a child of this instance.

getScreenshotAs

public <X> X getScreenshotAs(OutputType<X> target)
Description copied from interface: TakesScreenshot
Capture the screenshot and store it in the specified location.

Specified by:
getScreenshotAs in interface TakesScreenshot
Type Parameters:
X - Return type for getScreenshotAs.
Parameters:
target - target type, @see OutputType
Returns:
Object in which is stored information about the screenshot.

saveScreenshot

@Deprecated
public void saveScreenshot(File pngFile)
Deprecated. Use getScreenshotAs(file), which returns a temporary file.

Saves a screenshot of the current page into the given file.



Copyright © 2011. All Rights Reserved.