Package org.openqa.selenium.safari

Class SafariDriver

java.lang.Object

org.openqa.selenium.remote.RemoteWebDriver

org.openqa.selenium.safari.SafariDriver

All Implemented Interfaces:

HasFederatedCredentialManagement, HasCapabilities, HasDownloads, Interactive, JavascriptExecutor, PrintsPage, HasDebugger, HasPermissions, SearchContext, TakesScreenshot, HasVirtualAuthenticator, WebDriver

public class SafariDriver
extends RemoteWebDriver
implements HasPermissions, HasDebugger

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

WebDriver.Navigation, WebDriver.Options, WebDriver.TargetLocator, WebDriver.Timeouts, WebDriver.Window

Constructor Summary

Constructors

Constructor	Description
SafariDriver()	Initializes a new SafariDriver} class with default SafariOptions.
SafariDriver(DriverService service, SafariOptions options)	Initializes a new SafariDriver using the specified SafariOptions.
SafariDriver(DriverService service, SafariOptions options, ClientConfig clientConfig)
SafariDriver(SafariDriverService safariService)	Initializes a new SafariDriver backed by the specified SafariDriverService.
SafariDriver(SafariOptions safariOptions)	Initializes a new SafariDriver using the specified SafariOptions.

Method Summary

Modifier and Type	Method	Description
void	attachDebugger()	This opens Safari's Web Inspector If driver subsequently executes script of "debugger;" the execution will pause, no additional commands will be processed, and the code will time out.
static RemoteWebDriverBuilder	builder()
Map<String,Boolean>	getPermissions()
void	setFileDetector(FileDetector detector)	Set the file detector to be used when sending keyboard input.
void	setPermissions(String permission, boolean value)	Set permission on the browser.

Methods inherited from class org.openqa.selenium.remote.RemoteWebDriver

addVirtualAuthenticator, close, deleteDownloadableFiles, downloadFile, execute, execute, execute, executeAsyncScript, executeScript, findElement, findElements, findElements, get, getCapabilities, getCommandExecutor, getCurrentUrl, getDownloadableFiles, getElementConverter, getErrorHandler, getExecuteMethod, getFederatedCredentialManagementDialog, getFileDetector, getPageSource, getScreenshotAs, getSessionId, getTitle, getWindowHandle, getWindowHandles, log, manage, navigate, perform, print, quit, removeVirtualAuthenticator, resetCooldown, resetInputState, setCommandExecutor, setDelayEnabled, setElementConverter, setErrorHandler, setFoundBy, setLogLevel, setSessionId, startSession, switchTo, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.HasDownloads

requireDownloadsEnabled

Methods inherited from interface org.openqa.selenium.JavascriptExecutor

executeScript, getPinnedScripts, pin, unpin

Constructor Details

SafariDriver

public SafariDriver()

Initializes a new SafariDriver} class with default SafariOptions.

SafariDriver

public SafariDriver(SafariOptions safariOptions)

Initializes a new SafariDriver using the specified SafariOptions.

Parameters:

safariOptions - safari specific options / capabilities for the driver

SafariDriver

public SafariDriver(SafariDriverService safariService)

Initializes a new SafariDriver backed by the specified SafariDriverService.

Parameters:

safariService - preconfigured safari service

SafariDriver

public SafariDriver(DriverService service,
 SafariOptions options)

Initializes a new SafariDriver using the specified SafariOptions.

Parameters:

service - either SafariTechPreviewDriverService or SafariDriverService

options - safari specific options / capabilities for the driver

SafariDriver

public SafariDriver(DriverService service,
 SafariOptions options,
 ClientConfig clientConfig)

Method Details

builder

@Beta
public static RemoteWebDriverBuilder builder()

setPermissions

public void setPermissions(String permission,
 boolean value)

Description copied from interface: HasPermissions

Set permission on the browser. The only supported permission at this time is "getUserMedia".

Specified by:

setPermissions in interface HasPermissions

Parameters:

permission - the name of the item to set permission on.

value - whether the permission has been granted.

getPermissions

public Map<String,Boolean> getPermissions()

Specified by:

getPermissions in interface HasPermissions

Returns:

each permission and whether it is allowed or not.

attachDebugger

public void attachDebugger()

Description copied from interface: HasDebugger

This opens Safari's Web Inspector If driver subsequently executes script of "debugger;" the execution will pause, no additional commands will be processed, and the code will time out.

Specified by:

attachDebugger in interface HasDebugger

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