selenium.webdriver.chromium.service

Classes

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

Service class responsible for starting and stopping the ChromiumDriver WebDriver instance.
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]

Service class responsible for starting and stopping the ChromiumDriver WebDriver instance.

Args:

executable_path: (Optional) Install path of the executable. port: (Optional) 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.

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

Check if the service is ready via the W3C WebDriver /status endpoint.

This makes an HTTP request to the /status endpoint and verifies if it is ready to accept new sessions.

Returns:

True if the service is ready to accept new sessions, False otherwise.

property path: str
send_remote_shutdown_command() → None

Dispatch an HTTP request to the shutdown endpoint to stop the service.

property service_url: str

Gets the url of the Service.

start() → None

Starts the Service.

Raises:
WebDriverException: Raised either when it can’t start the service

or when it can’t connect to the service

stop() → None

Stops the service.

command_line_args() → list[str][source]

A List of program arguments (excluding the executable).

property service_args: Sequence[str]

Returns the sequence of service arguments.