org.openqa.selenium.ie

Class InternetExplorerOptions

java.lang.Object

org.openqa.selenium.MutableCapabilities

org.openqa.selenium.ie.InternetExplorerOptions

All Implemented Interfaces:

java.io.Serializable, Capabilities

@Beta
public class InternetExplorerOptions
extends MutableCapabilities

Options for configuring the use of IE. Can be used like so:

InternetExplorerOptions options = new InternetExplorerOptions()
   .requireWindowFocus();

new InternetExplorerDriver(options);

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
InternetExplorerOptions()
InternetExplorerOptions(Capabilities source)

Method Summary

Modifier and Type	Method and Description
InternetExplorerOptions	addCommandSwitches(java.lang.String... switches)
protected int	amendHashCode() Subclasses can use this to add information that isn't always in the capabilities map.
java.util.Map<java.lang.String,java.lang.Object>	asMap()
InternetExplorerOptions	destructivelyEnsureCleanSession() Clear the Internet Explorer cache before launching the browser.
InternetExplorerOptions	elementScrollTo(ElementScrollBehavior behavior)
InternetExplorerOptions	enableNativeEvents()
InternetExplorerOptions	enablePersistentHovering() Enable persistently sending WM_MOUSEMOVE messages to the IE window during a mouse hover.
boolean	equals(java.lang.Object o)
java.lang.Object	getCapability(java.lang.String capabilityName)
Platform	getPlatform()
int	hashCode()
InternetExplorerOptions	ignoreZoomSettings()
InternetExplorerOptions	introduceFlakinessByIgnoringSecurityDomains()
InternetExplorerOptions	merge(Capabilities extraCapabilities) Merges the extra capabilities provided into this DesiredCapabilities instance.
InternetExplorerOptions	requireWindowFocus()
void	setCapability(java.lang.String key, java.lang.Object value)
InternetExplorerOptions	setPageLoadStrategy(PageLoadStrategy strategy)
InternetExplorerOptions	setProxy(Proxy proxy)
InternetExplorerOptions	setUnhandledPromptBehaviour(UnexpectedAlertBehaviour behaviour)
InternetExplorerOptions	takeFullPageScreenshot()
java.util.Map<java.lang.String,java.lang.Object>	toJson()
java.lang.String	toString()
InternetExplorerOptions	useCreateProcessApiToLaunchIe() Force the use of the Windows CreateProcess API when launching Internet Explorer.
InternetExplorerOptions	usePerProcessProxy() Use the Proxy defined in other Capabilities on a per-process basis, not updating the system installed proxy setting.
InternetExplorerOptions	useShellWindowsApiToAttachToIe() Use the Windows ShellWindows API when attaching to Internet Explorer.
InternetExplorerOptions	waitForUploadDialogUpTo(java.time.Duration duration)
InternetExplorerOptions	waitForUploadDialogUpTo(long duration, java.util.concurrent.TimeUnit unit)
InternetExplorerOptions	withAttachTimeout(java.time.Duration duration)
InternetExplorerOptions	withAttachTimeout(long duration, java.util.concurrent.TimeUnit unit)
InternetExplorerOptions	withInitialBrowserUrl(java.lang.String url)

Methods inherited from class org.openqa.selenium.MutableCapabilities

setCapability, setCapability, setCapability

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.openqa.selenium.Capabilities

getBrowserName, getVersion, is, isJavascriptEnabled

Constructor Detail

InternetExplorerOptions

public InternetExplorerOptions()

InternetExplorerOptions

public InternetExplorerOptions(Capabilities source)

Method Detail

merge

public InternetExplorerOptions merge(Capabilities extraCapabilities)

Description copied from class: MutableCapabilities

Merges the extra capabilities provided into this DesiredCapabilities instance. If capabilities with the same name exist in this instance, they will be overridden by the values from the extraCapabilities object.

Specified by:

merge in interface Capabilities

Overrides:

merge in class MutableCapabilities

Parameters:

extraCapabilities - Additional capabilities to be added.

Returns:

DesiredCapabilities after the merge

withAttachTimeout

public InternetExplorerOptions withAttachTimeout(long duration,
                                                 java.util.concurrent.TimeUnit unit)

withAttachTimeout

public InternetExplorerOptions withAttachTimeout(java.time.Duration duration)

elementScrollTo

public InternetExplorerOptions elementScrollTo(ElementScrollBehavior behavior)

enablePersistentHovering

public InternetExplorerOptions enablePersistentHovering()

Enable persistently sending WM_MOUSEMOVE messages to the IE window during a mouse hover.

useCreateProcessApiToLaunchIe

public InternetExplorerOptions useCreateProcessApiToLaunchIe()

Force the use of the Windows CreateProcess API when launching Internet Explorer.

useShellWindowsApiToAttachToIe

public InternetExplorerOptions useShellWindowsApiToAttachToIe()

Use the Windows ShellWindows API when attaching to Internet Explorer.

destructivelyEnsureCleanSession

public InternetExplorerOptions destructivelyEnsureCleanSession()

Clear the Internet Explorer cache before launching the browser. When set clears the system cache for all instances of Internet Explorer, even those already running when the driven instance is launched.

addCommandSwitches

public InternetExplorerOptions addCommandSwitches(java.lang.String... switches)

usePerProcessProxy

public InternetExplorerOptions usePerProcessProxy()

Use the Proxy defined in other Capabilities on a per-process basis, not updating the system installed proxy setting. This is only valid when setting a Proxy where the Proxy.ProxyType is one of

• Proxy.ProxyType.DIRECT
• Proxy.ProxyType.MANUAL
• Proxy.ProxyType.SYSTEM

withInitialBrowserUrl

public InternetExplorerOptions withInitialBrowserUrl(java.lang.String url)

requireWindowFocus

public InternetExplorerOptions requireWindowFocus()

waitForUploadDialogUpTo

public InternetExplorerOptions waitForUploadDialogUpTo(long duration,
                                                       java.util.concurrent.TimeUnit unit)

waitForUploadDialogUpTo

public InternetExplorerOptions waitForUploadDialogUpTo(java.time.Duration duration)

introduceFlakinessByIgnoringSecurityDomains

public InternetExplorerOptions introduceFlakinessByIgnoringSecurityDomains()

enableNativeEvents

public InternetExplorerOptions enableNativeEvents()

ignoreZoomSettings

public InternetExplorerOptions ignoreZoomSettings()

takeFullPageScreenshot

public InternetExplorerOptions takeFullPageScreenshot()

setPageLoadStrategy

public InternetExplorerOptions setPageLoadStrategy(PageLoadStrategy strategy)

setUnhandledPromptBehaviour

public InternetExplorerOptions setUnhandledPromptBehaviour(UnexpectedAlertBehaviour behaviour)

setProxy

public InternetExplorerOptions setProxy(Proxy proxy)

setCapability

public void setCapability(java.lang.String key,
                          java.lang.Object value)

Overrides:

setCapability in class MutableCapabilities

getPlatform

public Platform getPlatform()

Specified by:

getPlatform in interface Capabilities

getCapability

public java.lang.Object getCapability(java.lang.String capabilityName)

Specified by:

getCapability in interface Capabilities

Parameters:

capabilityName - The capability to return.

Returns:

The value, or null if not set.

See Also:

CapabilityType

asMap

public java.util.Map<java.lang.String,java.lang.Object> asMap()

Specified by:

asMap in interface Capabilities

Returns:

The capabilities as a Map

toJson

public java.util.Map<java.lang.String,java.lang.Object> toJson()

amendHashCode

protected int amendHashCode()

Subclasses can use this to add information that isn't always in the capabilities map.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object