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 org.openqa.selenium.remote.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

org.openqa.selenium.remote.RemoteWebDriver.RemoteTargetLocator, org.openqa.selenium.remote.RemoteWebDriver.RemoteWebDriverOptions, org.openqa.selenium.remote.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 org.openqa.selenium.remote.CommandExecutor	getExecutor(SafariOptions options)
<X> X	getScreenshotAs(org.openqa.selenium.OutputType<X> target)
private static boolean	isLegacy(SafariOptions options)
private static org.openqa.selenium.Capabilities	requiredCapabilities(SafariOptions options) Ensure the new safaridriver receives non null required capabilities.
void	setFileDetector(org.openqa.selenium.remote.FileDetector detector)
protected void	startClient()
protected void	stopClient()

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, 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

requiredCapabilities

private static org.openqa.selenium.Capabilities requiredCapabilities(SafariOptions options)

Ensure the new safaridriver receives non null required capabilities.

getExecutor

private static org.openqa.selenium.remote.CommandExecutor getExecutor(SafariOptions options)

isLegacy

private static boolean isLegacy(SafariOptions options)

setFileDetector

public void setFileDetector(org.openqa.selenium.remote.FileDetector detector)

Overrides:

setFileDetector in class org.openqa.selenium.remote.RemoteWebDriver

startClient

protected void startClient()

Overrides:

startClient in class org.openqa.selenium.remote.RemoteWebDriver

stopClient

protected void stopClient()

Overrides:

stopClient in class org.openqa.selenium.remote.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 org.openqa.selenium.remote.RemoteWebDriver

Throws:

org.openqa.selenium.WebDriverException