selenium.webdriver.chrome.options

Classes

Options()

class selenium.webdriver.chrome.options.Options[source]
property default_capabilities: dict

Return minimal capabilities necessary as a dictionary.

enable_mobile(android_package: str | None = 'com.android.chrome', android_activity: str | None = None, device_serial: str | None = None) → None[source]

Enables mobile browser use for browsers that support it.

Args:

android_activity: The name of the android package to start

BINARY_LOCATION_ERROR = 'Binary Location Must be a String'
KEY = 'goog:chromeOptions'
add_argument(argument) → None

Adds an argument to the list.

Args:

  • Sets the arguments

add_encoded_extension(extension: str) → None

Adds Base64 encoded string with extension data to a list that will be used to extract it to the ChromeDriver.

Args:

  • extension: Base64 encoded string with extension data

add_experimental_option(name: str, value: str | int | dict | List[str]) → None

Adds an experimental option which is passed to chromium.

Args:

name: The experimental option name. value: The option value.

add_extension(extension: str) → None

Adds the path to the extension to a list that will be used to extract it to the ChromeDriver.

Args:

  • extension: path to the *.crx file

property arguments
Returns:

A list of arguments needed for the browser.

property binary_location: str
Returns:

The location of the binary, otherwise an empty string.

property capabilities
property debugger_address: str | None
Returns:

The address of the remote devtools instance.

property experimental_options: dict
Returns:

A dictionary of experimental options for chromium.

property extensions: List[str]
Returns:

A list of encoded extensions that will be loaded.

ignore_local_proxy_environment_variables() → None

By calling this you will ignore HTTP_PROXY and HTTPS_PROXY from being picked up and used.

set_capability(name, value) → None

Sets a capability.

to_capabilities() → dict

Creates a capabilities with all the options that have been set :Returns: A dictionary with everything.

browser_version

Gets and Sets the version of the browser.

Usage

  • Get

    • self.browser_version

  • Set

    • self.browser_version = value

Parameters

value: str

Returns

  • Get

    • str

  • Set

    • None

platform_name

Gets and Sets name of the platform.

Usage

  • Get

    • self.platform_name

  • Set

    • self.platform_name = value

Parameters

value: str

Returns

  • Get

    • str

  • Set

    • None

accept_insecure_certs

Gets and Set whether the session accepts insecure certificates.

Usage

  • Get

    • self.accept_insecure_certs

  • Set

    • self.accept_insecure_certs = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None

strict_file_interactability

Gets and Sets whether session is about file interactability.

Usage

  • Get

    • self.strict_file_interactability

  • Set

    • self.strict_file_interactability = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None

set_window_rect

Gets and Sets window size and position.

Usage

  • Get

    • self.set_window_rect

  • Set

    • self.set_window_rect = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None

enable_bidi

Gets and Set whether the session has WebDriverBiDi enabled.

Usage

  • Get

    • self.enable_bidi

  • Set

    • self.enable_bidi = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None

web_socket_url

Gets and Sets WebSocket URL.

Usage

  • Get

    • self.web_socket_url

  • Set

    • self.web_socket_url = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None

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

Parameters

value: str

Returns

  • Get

    • str

  • Set

    • None

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

Parameters

value: str

Returns

  • Get

    • str

  • Set

    • None

timeouts

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

Usage

  • Get

    • self.timeouts

  • Set

    • self.timeouts = value

Parameters

value: dict

Returns

  • Get

    • dict

  • Set

    • None

proxy

Sets and Gets Proxy.

Usage

  • Get

    • self.proxy

  • Set

    • self.proxy = value

Parameters

value: Proxy

Returns

  • Get

    • Proxy

  • Set

    • None

enable_downloads

Gets and Sets whether session can download files.

Usage

  • Get

    • self.enable_downloads

  • Set

    • self.enable_downloads = value

Parameters

value: bool

Returns

  • Get

    • bool

  • Set

    • None