# selenium.webdriver.common.utils

The Utils methods.

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) | Tries to connect to the HTTP server at /status path and specified port to see if it responds successfully.
`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.

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 - A hostname.

    - port - Optional 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 - A hostname.

    - port - An integer port.

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 - The port to connect.

selenium.webdriver.common.utils.is_url_connectable(port: int | str) → bool

  Tries to connect to the HTTP server at /status path and specified port to see if it responds successfully.

  Args:

    - port - The port to connect.

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

  Processes the values that will be typed in the element.