selenium.webdriver.remote.remote_connection

Classes

RemoteConnection([remote_server_addr, ...])

A connection with the Remote WebDriver server.

class selenium.webdriver.remote.remote_connection.RemoteConnection(remote_server_addr: str | None = None, keep_alive: bool | None = True, ignore_proxy: bool | None = False, ignore_certificates: bool | None = False, init_args_for_pool_manager: dict | None = None, client_config: ClientConfig | None = None)

A connection with the Remote WebDriver server.

Communicates with the server using the WebDriver wire protocol: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol

browser_name = None

os = <module 'os' (frozen)>

socket = <module 'socket' from '/opt/homebrew/Cellar/python@3.11/3.11.6/Frameworks/Python.framework/Versions/3.11/lib/python3.11/socket.py'>

certifi = <module 'certifi' from '/Users/diegomolina/projects/github.com/seleniumhq/selenium/py/.tox/docs/lib/python3.11/site-packages/certifi/__init__.py'>

system = 'mac'

extra_headers = None

user_agent = 'selenium/4.29.0.202501201850 (python mac)'

classmethod get_timeout()

Returns:

Timeout value in seconds for all http requests made to the Remote Connection

classmethod set_timeout(timeout)

Override the default timeout.

Args:

• timeout - timeout value for http requests in seconds

classmethod reset_timeout()

Reset the http request timeout to socket._GLOBAL_DEFAULT_TIMEOUT.

classmethod get_certificate_bundle_path()

Returns:

Paths of the .pem encoded certificate to verify connection to command executor. Defaults to certifi.where() or REQUESTS_CA_BUNDLE env variable if set.

classmethod set_certificate_bundle_path(path)

Set the path to the certificate bundle to verify connection to command executor. Can also be set to None to disable certificate validation.

Args:

• path - path of a .pem encoded certificate chain.

classmethod get_remote_connection_headers(parsed_url, keep_alive=False)

Get headers for remote request.

Args:

• parsed_url - The parsed url

• keep_alive (Boolean) - Is this a keep-alive connection (default: False)

extra_commands = {}

add_command(name, method, url)

Register a new command.

get_command(name: str)

Retrieve a command if it exists.

execute(command, params)

Send a command to the remote server.

Any path substitutions required for the URL mapped to the command should be included in the command parameters.

Args:

• command - A string specifying the command to execute.

• params - A dictionary of named parameters to send with the command as its JSON payload.

close()

Clean up resources when finished with the remote_connection.