Package org.openqa.selenium.ie

Class InternetExplorerOptions

java.lang.Object

org.openqa.selenium.MutableCapabilities

org.openqa.selenium.remote.AbstractDriverOptions<InternetExplorerOptions>

org.openqa.selenium.ie.InternetExplorerOptions

All Implemented Interfaces:

Serializable, Capabilities

public class InternetExplorerOptions
extends AbstractDriverOptions<InternetExplorerOptions>

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

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

 new InternetExplorerDriver(options);

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	IE_OPTIONS

Constructor Summary

Constructors

Constructor	Description
InternetExplorerOptions()
InternetExplorerOptions(Capabilities source)

Method Summary

Modifier and Type	Method	Description
InternetExplorerOptions	addCommandSwitches(String... switches)
InternetExplorerOptions	attachToEdgeChrome()
InternetExplorerOptions	destructivelyEnsureCleanSession()	Clear the Internet Explorer cache before launching the browser.
InternetExplorerOptions	disableNativeEvents()	Deprecated. Non W3C compliant
InternetExplorerOptions	elementScrollTo(ElementScrollBehavior behavior)
InternetExplorerOptions	enablePersistentHovering()	Enable persistently sending WM_MOUSEMOVE messages to the IE window during a mouse hover.
protected Object	getExtraCapability(String capabilityName)
protected Set<String>	getExtraCapabilityNames()
InternetExplorerOptions	ignoreProcessMatch()
InternetExplorerOptions	ignoreZoomSettings()
InternetExplorerOptions	introduceFlakinessByIgnoringSecurityDomains()
InternetExplorerOptions	merge(Capabilities extraCapabilities)	Merge two Capabilities together and return the union of the two as a new Capabilities instance.
InternetExplorerOptions	requireWindowFocus()
void	setCapability(String key, Object value)
InternetExplorerOptions	takeFullPageScreenshot()
InternetExplorerOptions	useCreateProcessApiToLaunchIe()	Force the use of the Windows CreateProcess API when launching Internet Explorer.
InternetExplorerOptions	useLegacyUploadDialog()
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(long duration, TimeUnit unit)
InternetExplorerOptions	waitForUploadDialogUpTo(Duration duration)
InternetExplorerOptions	withAttachTimeout(long duration, TimeUnit unit)
InternetExplorerOptions	withAttachTimeout(Duration duration)
InternetExplorerOptions	withEdgeExecutablePath(String path)
InternetExplorerOptions	withInitialBrowserUrl(String url)

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

asMap, getCapability, getCapabilityNames, setAcceptInsecureCerts, setBrowserVersion, setEnableDownloads, setImplicitWaitTimeout, setPageLoadStrategy, setPageLoadTimeout, setPlatformName, setProxy, setScriptTimeout, setStrictFileInteractability, setUnhandledPromptBehaviour

Methods inherited from class org.openqa.selenium.MutableCapabilities

equals, hashCode, setCapability, setCapability, setCapability, toJson, 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, getBrowserVersion, getPlatformName, is

Field Details

IE_OPTIONS

public static final String IE_OPTIONS

See Also:

• Constant Field Values

Constructor Details

InternetExplorerOptions

public InternetExplorerOptions()

InternetExplorerOptions

public InternetExplorerOptions(Capabilities source)

Method Details

merge

public InternetExplorerOptions merge(Capabilities extraCapabilities)

Description copied from class: MutableCapabilities

Merge two Capabilities together and return the union of the two as a new Capabilities instance. Capabilities from other will override those in this.

Specified by:

merge in interface Capabilities

Overrides:

merge in class MutableCapabilities

withAttachTimeout

public InternetExplorerOptions withAttachTimeout(long duration,
 TimeUnit unit)

withAttachTimeout

public InternetExplorerOptions withAttachTimeout(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(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(String url)

requireWindowFocus

public InternetExplorerOptions requireWindowFocus()

waitForUploadDialogUpTo

public InternetExplorerOptions waitForUploadDialogUpTo(long duration,
 TimeUnit unit)

waitForUploadDialogUpTo

public InternetExplorerOptions waitForUploadDialogUpTo(Duration duration)

introduceFlakinessByIgnoringSecurityDomains

public InternetExplorerOptions introduceFlakinessByIgnoringSecurityDomains()

disableNativeEvents

@Deprecated
public InternetExplorerOptions disableNativeEvents()

Deprecated.

Non W3C compliant

Method that defines to use whether to use native or javascript events during operations.

ignoreZoomSettings

public InternetExplorerOptions ignoreZoomSettings()

takeFullPageScreenshot

public InternetExplorerOptions takeFullPageScreenshot()

useLegacyUploadDialog

public InternetExplorerOptions useLegacyUploadDialog()

attachToEdgeChrome

public InternetExplorerOptions attachToEdgeChrome()

ignoreProcessMatch

public InternetExplorerOptions ignoreProcessMatch()

withEdgeExecutablePath

public InternetExplorerOptions withEdgeExecutablePath(String path)

setCapability

public void setCapability(String key,
 Object value)

Overrides:

setCapability in class MutableCapabilities

getExtraCapabilityNames

protected Set<String> getExtraCapabilityNames()

Specified by:

getExtraCapabilityNames in class AbstractDriverOptions<InternetExplorerOptions>

getExtraCapability

protected Object getExtraCapability(String capabilityName)

Specified by:

getExtraCapability in class AbstractDriverOptions<InternetExplorerOptions>