ChromiumOptions

Configures the browser before launch: the binary path, headless mode, command-line flags, and preferences. Learn more in Browser options.

pydoll.browser.options.ChromiumOptions

ChromiumOptions()

Bases: Options

A class to manage command-line options for a browser instance.

This class allows the user to specify command-line arguments and the binary location of the browser executable.

Initializes the Options instance.

Sets up an empty list for command-line arguments and a string for the binary location of the browser.

arguments property writable

arguments

Gets the list of command-line arguments.

RETURNS	DESCRIPTION
list	A list of command-line arguments added to the options. TYPE: list[str]

binary_location property writable

binary_location

Gets the location of the browser binary.

RETURNS	DESCRIPTION
str	The file path to the browser executable. TYPE: str

start_timeout property writable

start_timeout

Gets the timeout to verify the browser's running state.

RETURNS	DESCRIPTION
int	The timeout in seconds. TYPE: int

max_message_size property writable

max_message_size

Gets the largest CDP message, in bytes, a connection accepts.

A page controls the size of some CDP messages (a POST body in Network.requestWillBeSent or Fetch.requestPaused, a WebSocket frame), so the limit applies to every connection Pydoll opens: the browser's, each tab's and each iframe's. A larger message closes that connection, and the commands waiting on it raise WebSocketConnectionClosed. The next command opens a new connection.

RETURNS	DESCRIPTION
int | None	int | None: The limit in bytes (256 MiB by default), or None for no limit.

browser_preferences property writable

browser_preferences

prompt_for_download property writable

prompt_for_download

block_popups property writable

block_popups

password_manager_enabled property writable

password_manager_enabled

block_notifications property writable

block_notifications

allow_automatic_downloads property writable

allow_automatic_downloads

open_pdf_externally property writable

open_pdf_externally

headless property writable

headless

webrtc_leak_protection property writable

webrtc_leak_protection

page_load_state property writable

page_load_state

add_argument

add_argument(argument)

Adds a command-line argument to the options.

PARAMETER	DESCRIPTION
argument	The command-line argument to be added. TYPE: str

RAISES	DESCRIPTION
ArgumentAlreadyExistsInOptions	If the argument is already in the list of arguments.

remove_argument

remove_argument(argument)

Removes a command-line argument from the options.

PARAMETER	DESCRIPTION
argument	The command-line argument to be removed. TYPE: str

RAISES	DESCRIPTION
ArgumentNotFoundInOptions	If the argument is not in the list of arguments.

set_default_download_directory

set_default_download_directory(path)

Set the default directory where downloaded files will be saved.

Usage: Sets the 'download.default_directory' preference for Chrome.

PARAMETER	DESCRIPTION
path	Absolute path to the download destination folder. TYPE: str

set_accept_languages

set_accept_languages(languages)

Set the accepted languages for the browser.

Usage: Sets the 'intl.accept_languages' preference.

PARAMETER	DESCRIPTION
languages	A comma-separated string of language codes (e.g., 'pt-BR,pt,en-US,en'). TYPE: str