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)
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.
InternetExplorerOptions	ignoreZoomSettings()
InternetExplorerOptions	introduceFlakinessByIgnoringSecurityDomains()
InternetExplorerOptions	requireWindowFocus()
void	setCapability(java.lang.String key, java.lang.Object value)
InternetExplorerOptions	setPageLoadStrategy(PageLoadStrategy strategy)
InternetExplorerOptions	setUnhandledPromptBehaviour(UnexpectedAlertBehaviour behaviour)
InternetExplorerOptions	takeFullPageScreenshot()
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

amendHashCode, asMap, equals, getCapability, hashCode, merge, setCapability, setCapability, setCapability, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openqa.selenium.Capabilities

getBrowserName, getPlatform, getVersion, is, isJavascriptEnabled

Constructor Detail

InternetExplorerOptions

public InternetExplorerOptions()

InternetExplorerOptions

public InternetExplorerOptions(Capabilities source)

Method Detail

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)

setCapability

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

Overrides:

setCapability in class MutableCapabilities