Configuration Options

/**
 * Configuration options for Internet Explorer WebDriver.
 * Provides fluent API for setting IE-specific capabilities.
 */
public class InternetExplorerOptions extends AbstractDriverOptions<InternetExplorerOptions> {
    
    public static final String IE_OPTIONS = "se:ieOptions";
    
    /**
     * Creates default InternetExplorerOptions with browser name set to IE.
     */
    public InternetExplorerOptions();
    
    /**
     * Creates InternetExplorerOptions from existing capabilities.
     * @param source Existing capabilities to copy from
     */
    public InternetExplorerOptions(Capabilities source);
    
    /**
     * Merges this options with additional capabilities.
     * @param extraCapabilities Additional capabilities to merge
     * @return New InternetExplorerOptions instance with merged capabilities
     */
    @Override
    public InternetExplorerOptions merge(Capabilities extraCapabilities);
}

/**
 * Ignores the browser zoom level during automation.
 * Prevents zoom-related element location issues.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions ignoreZoomSettings();

/**
 * Requires window focus before performing operations.
 * Ensures reliable element interaction in multi-window environments.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions requireWindowFocus();

/**
 * Enables persistent sending of WM_MOUSEMOVE messages during mouse hover.
 * Improves hover behavior reliability.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions enablePersistentHovering();

/**
 * Sets the initial URL to load when IE launches.
 * @param url Initial browser URL (cannot be null)
 * @return Self reference for method chaining
 */
public InternetExplorerOptions withInitialBrowserUrl(String url);

/**
 * Configures how elements are scrolled into view.
 * @param behavior Scroll behavior (TOP or BOTTOM)
 * @return Self reference for method chaining
 */
public InternetExplorerOptions elementScrollTo(ElementScrollBehavior behavior);

/**
 * Sets timeout for attaching to new browser windows.
 * @param duration Timeout duration
 * @param unit Time unit for duration
 * @return Self reference for method chaining
 */
public InternetExplorerOptions withAttachTimeout(long duration, TimeUnit unit);

/**
 * Sets timeout for attaching to new browser windows.
 * @param duration Timeout as Duration object
 * @return Self reference for method chaining
 */
public InternetExplorerOptions withAttachTimeout(Duration duration);

/**
 * Sets timeout for file upload dialog operations.
 * @param duration Timeout duration
 * @param unit Time unit for duration
 * @return Self reference for method chaining
 */
public InternetExplorerOptions waitForUploadDialogUpTo(long duration, TimeUnit unit);

/**
 * Sets timeout for file upload dialog operations.
 * @param duration Timeout as Duration object
 * @return Self reference for method chaining
 */
public InternetExplorerOptions waitForUploadDialogUpTo(Duration duration);

/**
 * Forces use of Windows CreateProcess API when launching IE.
 * Alternative to default ShellExecute method.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions useCreateProcessApiToLaunchIe();

/**
 * Uses Windows ShellWindows API when attaching to IE instances.
 * Alternative attachment mechanism.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions useShellWindowsApiToAttachToIe();

/**
 * Adds command line switches for IE process when using CreateProcess API.
 * @param switches Variable number of command line switches
 * @return Self reference for method chaining
 */
public InternetExplorerOptions addCommandSwitches(String... switches);

/**
 * Uses per-process proxy settings instead of system-wide proxy.
 * Only valid with DIRECT, MANUAL, or SYSTEM proxy types.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions usePerProcessProxy();

/**
 * Clears Internet Explorer cache before launching browser.
 * WARNING: Clears system cache for ALL IE instances, including existing ones.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions destructivelyEnsureCleanSession();

/**
 * Ignores browser protected mode settings during startup.
 * WARNING: Makes tests unstable and hard to debug. Use with caution.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions introduceFlakinessByIgnoringSecurityDomains();

/**
 * Enables full page screenshot capture instead of viewport-only.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions takeFullPageScreenshot();

/**
 * Uses legacy file upload dialog handling mechanism.
 * For compatibility with older IE versions or specific configurations.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions useLegacyUploadDialog();

/**
 * Configures IE driver to attach to Edge browser in IE mode.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions attachToEdgeChrome();

/**
 * Sets path to Edge executable for IE mode operations.
 * @param path Full path to Edge executable
 * @return Self reference for method chaining
 */
public InternetExplorerOptions withEdgeExecutablePath(String path);

/**
 * Ignores process matching when attaching to browser instances.
 * @return Self reference for method chaining
 */
public InternetExplorerOptions ignoreProcessMatch();

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

WebDriver driver = new InternetExplorerDriver(options);

InternetExplorerOptions options = new InternetExplorerOptions()
    .withAttachTimeout(30, TimeUnit.SECONDS)
    .waitForUploadDialogUpTo(Duration.ofMinutes(2));

InternetExplorerOptions options = new InternetExplorerOptions()
    .useCreateProcessApiToLaunchIe()
    .addCommandSwitches("-private", "-noframemerging")
    .usePerProcessProxy()
    .destructivelyEnsureCleanSession();

InternetExplorerOptions options = new InternetExplorerOptions()
    .attachToEdgeChrome()
    .withEdgeExecutablePath("C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe")
    .ignoreProcessMatch();

InternetExplorerOptions options = new InternetExplorerOptions()
    .withInitialBrowserUrl("about:blank")
    .takeFullPageScreenshot()
    .useLegacyUploadDialog()
    // Use with extreme caution:
    .introduceFlakinessByIgnoringSecurityDomains();

/**
 * Capability constants used by InternetExplorerOptions.
 * These are automatically set by the fluent API methods.
 */
public static final String IE_OPTIONS = "se:ieOptions";

// Private capability constants (used internally)
private static final String FULL_PAGE_SCREENSHOT = "ie.enableFullPageScreenshot";
private static final String UPLOAD_DIALOG_TIMEOUT = "ie.fileUploadDialogTimeout";
private static final String FORCE_WINDOW_SHELL_API = "ie.forceShellWindowsApi";
private static final String LEGACY_FILE_UPLOAD_DIALOG_HANDLING = "ie.useLegacyFileUploadDialogHandling";
private static final String ATTACH_TO_EDGE_CHROME = "ie.edgechromium";
private static final String EDGE_EXECUTABLE_PATH = "ie.edgepath";
private static final String IGNORE_PROCESS_MATCH = "ie.ignoreprocessmatch";