selenium.webdriver.common.utils

Utility functions.

Functions

find_connectable_ip(host[, port])	Resolve a hostname to an IP, preferring IPv4 addresses.
free_port()	Determines a free port using sockets.
is_connectable(port[, host])	Tries to connect to the server at port to see if it is running.
is_url_connectable(port[, host, scheme])	Send a request to the HTTP server at the /status endpoint to verify connectivity.
join_host_port(host, port)	Joins a hostname and port together.
keys_to_typing(value)	Processes the values that will be typed in the element.

selenium.webdriver.common.utils.free_port() → int

Determines a free port using sockets.

First try IPv4, but use IPv6 if it can’t bind (IPv6-only system).

selenium.webdriver.common.utils.find_connectable_ip(host: str | bytes | bytearray | None, port: int | None = None) → str | None

Resolve a hostname to an IP, preferring IPv4 addresses.

We prefer IPv4 so that we don’t change behavior from previous IPv4-only implementations, and because some drivers (e.g., FirefoxDriver) do not support IPv6 connections.

If the optional port number is provided, only IPs that listen on the given port are considered.

Args:

host: hostname port: port number

Returns:

A single IP address, as a string. If any IPv4 address is found, one is returned. Otherwise, if any IPv6 address is found, one is returned. If neither, then None is returned.

selenium.webdriver.common.utils.join_host_port(host: str, port: int) → str

Joins a hostname and port together.

This is a minimal implementation intended to cope with IPv6 literals. For example, _join_host_port(‘::1’, 80) == ‘[::1]:80’.

Args:

host: hostname or IP port: port number

selenium.webdriver.common.utils.is_connectable(port: int, host: str | None = 'localhost') → bool

Tries to connect to the server at port to see if it is running.

Args:

port: port number host: hostname or IP

selenium.webdriver.common.utils.is_url_connectable(port: int | str, host: str | None = '127.0.0.1', scheme: str | None = 'http') → bool

Send a request to the HTTP server at the /status endpoint to verify connectivity.

Args:

port: port number host: hostname or IP scheme: URL scheme

selenium.webdriver.common.utils.keys_to_typing(value: Iterable[str | int | float]) → list[str]

Processes the values that will be typed in the element.