org.openqa.selenium.safari

Class SafariDriver

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.safari.SafariDriver

All Implemented Interfaces:

org.openqa.selenium.HasCapabilities, org.openqa.selenium.interactions.HasInputDevices, org.openqa.selenium.internal.FindsByClassName, org.openqa.selenium.internal.FindsByCssSelector, org.openqa.selenium.internal.FindsById, org.openqa.selenium.internal.FindsByLinkText, org.openqa.selenium.internal.FindsByName, org.openqa.selenium.internal.FindsByTagName, org.openqa.selenium.internal.FindsByXPath, org.openqa.selenium.JavascriptExecutor, org.openqa.selenium.SearchContext, org.openqa.selenium.TakesScreenshot, org.openqa.selenium.WebDriver

public class SafariDriver
extends RemoteWebDriver

A WebDriver implementation that controls Safari using a browser extension (consequently, only Safari 5.1+ is supported). This driver can be configured using the SafariOptions class.

Nested Class Summary

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

org.openqa.selenium.WebDriver.ImeHandler, org.openqa.selenium.WebDriver.Navigation, org.openqa.selenium.WebDriver.Options, org.openqa.selenium.WebDriver.TargetLocator, org.openqa.selenium.WebDriver.Timeouts, org.openqa.selenium.WebDriver.Window

Field Summary

Fields

Modifier and Type	Field and Description
private SafariDriverService	service
static java.lang.String	USE_LEGACY_DRIVER_CAPABILITY Capability to force usage of the deprecated SafariDriver extension while running on macOS Sierra.

Constructor Summary

Constructors

Constructor and Description
SafariDriver() Initializes a new SafariDriver} class with default SafariOptions.
SafariDriver(org.openqa.selenium.Capabilities desiredCapabilities) Converts the specified DesiredCapabilities to a SafariOptions instance and initializes a new SafariDriver using these options.
SafariDriver(SafariOptions safariOptions) Initializes a new SafariDriver using the specified SafariOptions.

Method Summary

Modifier and Type	Method and Description
private static CommandExecutor	getExecutor(SafariOptions options)
<X> X	getScreenshotAs(org.openqa.selenium.OutputType<X> target)
void	setFileDetector(FileDetector detector) Set the file detector to be used when sending keyboard input.
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, getFileDetector, getKeyboard, getMouse, getPageSource, getSessionId, getTitle, getW3CStandardComplianceLevel, getWindowHandle, getWindowHandles, log, manage, navigate, quit, setCommandExecutor, setElementConverter, setErrorHandler, setFoundBy, setLogLevel, setSessionId, startClient, startSession, startSession, stopClient, switchTo, toString

Methods inherited from class java.lang.Object

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

Field Detail

USE_LEGACY_DRIVER_CAPABILITY

public static final java.lang.String USE_LEGACY_DRIVER_CAPABILITY

Capability to force usage of the deprecated SafariDriver extension while running on macOS Sierra.

   DesiredCapabilities safariCap = DesiredCapabilities.Safari();
   safariCap.setCapability(SafariDriver.USE_LEGACY_DRIVER_CAPABILITY, true);
   WebDriver driver = new SafariDriver(safariCap);
 

See Also:

Constant Field Values

service

private SafariDriverService service

Constructor Detail

SafariDriver

public SafariDriver()

Initializes a new SafariDriver} class with default SafariOptions.

SafariDriver

public SafariDriver(org.openqa.selenium.Capabilities desiredCapabilities)

Converts the specified DesiredCapabilities to a SafariOptions instance and initializes a new SafariDriver using these options.

Parameters:

desiredCapabilities - capabilities requested of the driver

See Also:

SafariOptions.fromCapabilities(org.openqa.selenium.Capabilities)

SafariDriver

public SafariDriver(SafariOptions safariOptions)

Initializes a new SafariDriver using the specified SafariOptions.

Parameters:

safariOptions - safari specific options / capabilities for the driver

Method Detail

getExecutor

private static CommandExecutor getExecutor(SafariOptions options)

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

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

stopClient

protected void stopClient()

Description copied from class: RemoteWebDriver

Method called after executing a RemoteWebDriver.quit() command. The default implementation is a no-op, but subtypes should override this method to define custom behavior.

Overrides:

stopClient in class RemoteWebDriver

getScreenshotAs

public <X> X getScreenshotAs(org.openqa.selenium.OutputType<X> target)
                      throws org.openqa.selenium.WebDriverException

Specified by:

getScreenshotAs in interface org.openqa.selenium.TakesScreenshot

Overrides:

getScreenshotAs in class RemoteWebDriver

Throws:

org.openqa.selenium.WebDriverException