selenium.webdriver.chromium.service

Classes

ChromiumService([executable_path, port, ...])

A Service class that is responsible for the starting and stopping the WebDriver instance of the ChromiumDriver.
class selenium.webdriver.chromium.service.ChromiumService(executable_path: str | None = None, port: int = 0, service_args: Sequence[str] | None = None, log_output: int | str | IO[Any] | None = None, env: Mapping[str, str] | None = None, driver_path_env_key: str | None = None, **kwargs)[source]

A Service class that is responsible for the starting and stopping the WebDriver instance of the ChromiumDriver.

Parameters:

  • executable_path – install path of the executable.

  • port – Port for the service to run on, defaults to 0 where the operating system will decide.

  • service_args – (Optional) Sequence of args to be passed to the subprocess when launching the executable.

  • log_output – (Optional) int representation of STDOUT/DEVNULL, any IO instance or String path to file.

  • env – (Optional) Mapping of environment variables for the new process, defaults to os.environ.

  • driver_path_env_key – (Optional) Environment variable to use to get the path to the driver executable.

assert_process_still_running() → None

Check if the underlying process is still running.

command_line_args() → list[str][source]

A List of program arguments (excluding the executable).

env_path() → str | None
is_connectable() → bool

Establishes a socket connection to determine if the service running on the port is accessible.

property path: str
send_remote_shutdown_command() → None

Dispatch an HTTP request to the shutdown endpoint for the service in an attempt to stop it.

property service_url: str

Gets the url of the Service.

start() → None

Starts the Service.

Exceptions:

  • WebDriverException : Raised either when it can’t start the service or when it can’t connect to the service

stop() → None

Stops the service.

property service_args: Sequence[str]