selenium.webdriver.ie.options

Classes

ElementScrollBehavior(value)	An enumeration.
Options()

class selenium.webdriver.ie.options.ElementScrollBehavior(value)

An enumeration.

TOP = 0

BOTTOM = 1

class selenium.webdriver.ie.options.Options

KEY = 'se:ieOptions'

SWITCHES = 'ie.browserCommandLineSwitches'

BROWSER_ATTACH_TIMEOUT = 'browserAttachTimeout'

ELEMENT_SCROLL_BEHAVIOR = 'elementScrollBehavior'

ENSURE_CLEAN_SESSION = 'ie.ensureCleanSession'

FILE_UPLOAD_DIALOG_TIMEOUT = 'ie.fileUploadDialogTimeout'

FORCE_CREATE_PROCESS_API = 'ie.forceCreateProcessApi'

FORCE_SHELL_WINDOWS_API = 'ie.forceShellWindowsApi'

FULL_PAGE_SCREENSHOT = 'ie.enableFullPageScreenshot'

IGNORE_PROTECTED_MODE_SETTINGS = 'ignoreProtectedModeSettings'

IGNORE_ZOOM_LEVEL = 'ignoreZoomSetting'

INITIAL_BROWSER_URL = 'initialBrowserUrl'

NATIVE_EVENTS = 'nativeEvents'

PERSISTENT_HOVER = 'enablePersistentHover'

REQUIRE_WINDOW_FOCUS = 'requireWindowFocus'

USE_PER_PROCESS_PROXY = 'ie.usePerProcessProxy'

USE_LEGACY_FILE_UPLOAD_DIALOG_HANDLING = 'ie.useLegacyFileUploadDialogHandling'

ATTACH_TO_EDGE_CHROME = 'ie.edgechromium'

EDGE_EXECUTABLE_PATH = 'ie.edgepath'

IGNORE_PROCESS_MATCH = 'ie.ignoreprocessmatch'

browser_attach_timeout

Gets and Sets browser_attach_timeout.

Usage:

• Get: self.browser_attach_timeout

• Set: self.browser_attach_timeout = value

Args:

value: int - Timeout in milliseconds.

element_scroll_behavior

Gets and Sets element_scroll_behavior.

Usage:

• Get: self.element_scroll_behavior

• Set: self.element_scroll_behavior = value

Args:

value: int - Either 0 (Top) or 1 (Bottom).

ensure_clean_session

Gets and Sets ensure_clean_session.

Usage:

• Get: self.ensure_clean_session

• Set: self.ensure_clean_session = value

Args:

value: bool

file_upload_dialog_timeout

Gets and Sets file_upload_dialog_timeout.

Usage:

• Get: self.file_upload_dialog_timeout

• Set: self.file_upload_dialog_timeout = value

Args:

value: int - Timeout in milliseconds.

force_create_process_api

Gets and Sets force_create_process_api.

Usage:

• Get: self.force_create_process_api

• Set: self.force_create_process_api = value

Args:

value: bool

force_shell_windows_api

Gets and Sets force_shell_windows_api.

Usage:

• Get: self.force_shell_windows_api

• Set: self.force_shell_windows_api = value

Args:

value: bool

full_page_screenshot

Gets and Sets full_page_screenshot.

Usage:

• Get: self.full_page_screenshot

• Set: self.full_page_screenshot = value

Args:

value: bool

ignore_protected_mode_settings

Gets and Sets ignore_protected_mode_settings.

Usage:

• Get: self.ignore_protected_mode_settings

• Set: self.ignore_protected_mode_settings = value

Args:

value: bool

ignore_zoom_level

Gets and Sets ignore_zoom_level.

Usage:

• Get: self.ignore_zoom_level

• Set: self.ignore_zoom_level = value

Args:

value: bool

initial_browser_url

Gets and Sets initial_browser_url.

Usage:

• Get: self.initial_browser_url

• Set: self.initial_browser_url = value

Args:

value: str

native_events

Gets and Sets native_events.

Usage:

• Get: self.native_events

• Set: self.native_events = value

Args:

value: bool

persistent_hover

Gets and Sets persistent_hover.

Usage:

• Get: self.persistent_hover

• Set: self.persistent_hover = value

Args:

value: bool

BINARY_LOCATION_ERROR = 'Binary Location Must be a String'

FEDCM_CAPABILITY = 'fedcm:accounts'

add_argument(argument: str) → None

Adds an argument to the list.

Args:

argument: Sets the arguments

property arguments

Returns a list of arguments needed for the browser.

property capabilities

enable_mobile(android_package: str | None = None, android_activity: str | None = None, device_serial: str | None = None) → None

Enables mobile browser use for browsers that support it.

Args:

android_package: The name of the android package to start android_activity: The name of the android activity device_serial: The device serial number

ignore_local_proxy_environment_variables() → None

Ignore HTTP_PROXY and HTTPS_PROXY environment variables.

This method is deprecated; use a Proxy instance with ProxyType.DIRECT instead.

require_window_focus

Gets and Sets require_window_focus.

Usage:

• Get: self.require_window_focus

• Set: self.require_window_focus = value

Args:

value: bool

set_capability(name, value) → None

Sets a capability.

browser_version

Gets and Sets the version of the browser.

Usage:

• Get: self.browser_version

• Set: self.browser_version = value

Args:

value: str

Returns:

str when getting, None when setting.

platform_name

Gets and Sets name of the platform.

Usage:

• Get: self.platform_name

• Set: self.platform_name = value

Args:

value: str

Returns:

str when getting, None when setting.

accept_insecure_certs

Gets and Set whether the session accepts insecure certificates.

Usage:

• Get: self.accept_insecure_certs

• Set: self.accept_insecure_certs = value

Args:

value: bool

Returns:

bool when getting, None when setting.

strict_file_interactability

Gets and Sets whether session is about file interactability.

Usage:

• Get: self.strict_file_interactability

• Set: self.strict_file_interactability = value

Args:

value: bool

Returns:

bool when getting, None when setting.

set_window_rect

Gets and Sets window size and position.

Usage:

• Get: self.set_window_rect

• Set: self.set_window_rect = value

Args:

value: bool

Returns:

bool when getting, None when setting.

enable_bidi

Gets and Set whether the session has WebDriverBiDi enabled.

Usage:

• Get: self.enable_bidi

• Set: self.enable_bidi = value

Args:

value: bool

Returns:

bool when getting, None when setting.

page_load_strategy

Gets and Sets page load strategy, the default is “normal”.

Usage:

• Get: self.page_load_strategy

• Set: self.page_load_strategy = value

Args:

value: str

Returns:

str when getting, None when setting.

unhandled_prompt_behavior

Gets and Sets unhandled prompt behavior, the default is “dismiss and notify”.

Usage:

• Get: self.unhandled_prompt_behavior

• Set: self.unhandled_prompt_behavior = value

Args:

value: str

Returns:

str when getting, None when setting.

timeouts

Gets and Sets implicit timeout, pageLoad timeout and script timeout if set (in milliseconds).

Usage:

• Get: self.timeouts

• Set: self.timeouts = value

Args:

value: dict

Returns:

dict when getting, None when setting.

proxy

Sets and Gets Proxy.

Usage:

• Get: self.proxy

• Set: self.proxy = value

Args:

value: Proxy

Returns:

Proxy when getting, None when setting.

enable_downloads

Gets and Sets whether session can download files.

Usage:

• Get: self.enable_downloads

• Set: self.enable_downloads = value

Args:

value: bool

Returns:

bool when getting, None when setting.

web_socket_url

Gets and Sets WebSocket URL.

Usage:

• Get: self.web_socket_url

• Set: self.web_socket_url = value

Args:

value: str

Returns:

str when getting, None when setting.

use_per_process_proxy

Gets and Sets use_per_process_proxy.

Usage:

• Get: self.use_per_process_proxy

• Set: self.use_per_process_proxy = value

Args:

value: bool

use_legacy_file_upload_dialog_handling

Gets and Sets use_legacy_file_upload_dialog_handling.

Usage:

• Get: self.use_legacy_file_upload_dialog_handling

• Set: self.use_legacy_file_upload_dialog_handling = value

Args:

value: bool

attach_to_edge_chrome

Gets and Sets attach_to_edge_chrome.

Usage:

• Get: self.attach_to_edge_chrome

• Set: self.attach_to_edge_chrome = value

Args:

value: bool

edge_executable_path

Gets and Sets edge_executable_path.

Usage:

• Get: self.edge_executable_path

• Set: self.edge_executable_path = value

Args:

value: str

property options: dict

Returns a dictionary of browser options.

property additional_options: dict

Returns the additional options.

add_additional_option(name: str, value) → None

Adds an additional option not yet added as a safe option for IE.

Args:

name: name of the option to add value: value of the option to add

to_capabilities() → dict

Marshals the IE options to the correct object.

property default_capabilities: dict

Return minimal capabilities necessary as a dictionary.