osn-selenium 0.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

osn_selenium/webdrivers/sync/blink/base.py

@@ -0,0 +1,140 @@
+import pathlib
+from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
+from osn_selenium.flags.blink import BlinkFlagsManager
+from osn_selenium.flags.models.blink import BlinkFlags
+from osn_selenium.webdrivers.sync.core.base import CoreBaseMixin
+from osn_selenium._typehints import (
+	ARCHITECTURES_TYPEHINT,
+	PATH_TYPEHINT
+)
+from osn_selenium.webdrivers.unified.blink.base import (
+	UnifiedBlinkBaseMixin
+)
+from osn_selenium.abstract.webdriver.blink.base import (
+	AbstractBlinkBaseMixin
+)
+from selenium.webdriver.chromium.webdriver import (
+	ChromiumDriver as legacyWebDriver
+)
+
+
+__all__ = ["BlinkBaseMixin"]
+
+
+class BlinkBaseMixin(UnifiedBlinkBaseMixin, CoreBaseMixin, AbstractBlinkBaseMixin):
+	"""
+	Base mixin for Blink WebDrivers handling core initialization and state management.
+
+	This class serves as the foundation for browser-specific implementations, managing
+	the WebDriver executable path, configuration flags, timeouts, and the active
+	driver instance.
+	"""
+	
+	def __init__(
+			self,
+			browser_exe: Optional[PATH_TYPEHINT],
+			browser_name_in_system: str,
+			webdriver_path: str,
+			architecture: ARCHITECTURES_TYPEHINT,
+			use_browser_exe: bool = True,
+			flags_manager_type: Type[BlinkFlagsManager] = BlinkFlagsManager,
+			flags: Optional[BlinkFlags] = None,
+			start_page_url: str = "",
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+	):
+		"""
+		Initializes the BlinkWebDriver instance.
+
+		This constructor sets up the necessary components for controlling a Blink-based browser,
+		including paths, flag managers, timeouts, and integration with DevTools and Trio.
+		It also initializes properties related to console encoding and IP pattern matching
+		for managing browser processes.
+
+		Args:
+			browser_exe (Optional[PATH_TYPEHINT]): The path to the browser executable
+				(e.g., `chrome.exe` or `msedge.exe`). If None, the browser executable will not be
+				managed directly by this class (e.g., for remote WebDriver connections where the
+				browser is already running).
+			browser_name_in_system (str): The common name of the browser executable in the system
+				(e.g., "Chrome", "Edge"). Used to auto-detect `browser_exe` if `use_browser_exe` is True.
+			webdriver_path (str): The file path to the WebDriver executable (e.g., `chromedriver.exe`).
+			use_browser_exe (bool): If True, the browser executable path will be
+				automatically determined based on `browser_name_in_system` if `browser_exe`
+				is not explicitly provided. If False, `browser_exe` must be None.
+				Defaults to True.
+			flags_manager_type (Type[BlinkFlagsManager]): The type of flags manager to use.
+				Defaults to `BlinkFlagsManager`, which is suitable for Chrome/Edge.
+			flags (Optional[BlinkFlags]): Initial browser flags or options
+				specific to Blink-based browsers. Can be a `BlinkFlags` object or a generic mapping.
+				Defaults to None.
+			start_page_url (str): The URL that the browser will attempt to navigate to
+				immediately after starting. Defaults to an empty string.
+			implicitly_wait (int): The default implicit wait time in seconds for element searches.
+				Defaults to 5.
+			page_load_timeout (int): The default page load timeout in seconds. Defaults to 5.
+			script_timeout (int): The default asynchronous script timeout in seconds. Defaults to 5.
+			window_rect (Optional[WindowRect]): The initial window size and position. If None,
+				the browser's default window size will be used. Defaults to None.
+			cdp_versioned_packages_paths (Optional[Mapping[int, PATH_TYPEHINT]]): Custom local paths for specific CDP versions packages.
+			ignore_cdp_version_package_missing (bool): Whether to ignore missing CDP package errors.
+		"""
+		
+		CoreBaseMixin.__init__(
+				self,
+				webdriver_path=webdriver_path,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+		
+		UnifiedBlinkBaseMixin.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				webdriver_path=webdriver_path,
+				architecture=architecture,
+				use_browser_exe=use_browser_exe,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+	
+	@property
+	def browser_exe(self) -> Optional[pathlib.Path]:
+		return self._browser_exe_impl
+	
+	@property
+	def debugging_ip(self) -> Optional[str]:
+		return self._debugging_ip_impl
+	
+	@property
+	def debugging_port(self) -> Optional[int]:
+		return self._debugging_port_impl
+	
+	@property
+	def driver(self) -> Optional[legacyWebDriver]:
+		return self._driver_impl
+	
+	def set_start_page_url(self, start_page_url: str) -> None:
+		self._webdriver_flags_manager.start_page_url = start_page_url

osn_selenium/webdrivers/sync/blink/casting.py

@@ -0,0 +1,34 @@
+from typing import Any, Dict, List
+from osn_selenium.webdrivers.unified.blink.casting import (
+	UnifiedBlinkCastingMixin
+)
+from osn_selenium.abstract.webdriver.blink.casting import (
+	AbstractBlinkCastingMixin
+)
+
+
+__all__ = ["BlinkCastingMixin"]
+
+
+class BlinkCastingMixin(UnifiedBlinkCastingMixin, AbstractBlinkCastingMixin):
+	"""
+	Mixin handling object type casting and wrapping for Blink WebDrivers.
+
+	Ensures that raw Selenium objects are converted into their corresponding
+	internal wrapper representations and vice versa during method calls.
+	"""
+	
+	def get_sinks(self) -> List[Dict[str, Any]]:
+		return self._get_sinks_impl()
+	
+	def set_sink_to_use(self, sink_name: str) -> Dict[str, Any]:
+		return self._set_sink_to_use_impl(sink_name=sink_name)
+	
+	def start_desktop_mirroring(self, sink_name: str) -> Dict[str, Any]:
+		return self._start_desktop_mirroring_impl(sink_name=sink_name)
+	
+	def start_tab_mirroring(self, sink_name: str) -> Dict[str, Any]:
+		return self._start_tab_mirroring_impl(sink_name=sink_name)
+	
+	def stop_casting(self, sink_name: str) -> Dict[str, Any]:
+		return self._stop_casting_impl(sink_name=sink_name)

osn_selenium/webdrivers/sync/blink/features.py

@@ -0,0 +1,28 @@
+from typing import Any, Dict
+from osn_selenium.webdrivers.unified.blink.features import (
+	UnifiedBlinkFeaturesMixin
+)
+from osn_selenium.abstract.webdriver.blink.features import (
+	AbstractBlinkFeaturesMixin
+)
+
+
+__all__ = ["BlinkFeaturesMixin"]
+
+
+class BlinkFeaturesMixin(UnifiedBlinkFeaturesMixin, AbstractBlinkFeaturesMixin):
+	"""
+	Mixin for managing browser features and capabilities for Blink WebDrivers.
+
+	Provides interfaces to query, enable, or disable specific browser features
+	and inspect the supported capabilities of the current session.
+	"""
+	
+	def get_issue_message(self) -> Any:
+		return self._get_issue_message_impl()
+	
+	def launch_app(self, id: str) -> Dict[str, Any]:
+		return self._launch_app_impl(id=id)
+	
+	def set_permissions(self, name: str, value: str) -> None:
+		self._set_permissions_impl(name=name, value=value)

osn_selenium/webdrivers/sync/blink/lifecycle.py

@@ -0,0 +1,66 @@
+from typing import Optional
+from osn_selenium.models import WindowRect
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.models.blink import BlinkFlags
+from osn_selenium.webdrivers.sync.core.lifecycle import CoreLifecycleMixin
+from osn_selenium.webdrivers.unified.blink.lifecycle import (
+	UnifiedBlinkLifecycleMixin
+)
+from osn_selenium.abstract.webdriver.blink.lifecycle import (
+	AbstractBlinkLifecycleMixin
+)
+
+
+__all__ = ["BlinkLifecycleMixin"]
+
+
+class BlinkLifecycleMixin(
+		UnifiedBlinkLifecycleMixin,
+		CoreLifecycleMixin,
+		AbstractBlinkLifecycleMixin
+):
+	"""
+	Mixin for managing the lifecycle of the Blink WebDriver.
+
+	Handles the creation, startup, shutdown, and restarting processes of the
+	underlying browser instance, ensuring clean session management.
+	"""
+	
+	def close_webdriver(self) -> None:
+		self._close_webdriver_impl()
+	
+	def restart_webdriver(
+			self,
+			flags: Optional[BlinkFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._restart_webdriver_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect
+		)
+	
+	def start_webdriver(
+			self,
+			flags: Optional[BlinkFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._start_webdriver_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)

osn_selenium/webdrivers/sync/blink/logging.py

@@ -0,0 +1,25 @@
+from typing import Any
+from osn_selenium.webdrivers.unified.blink.logging import (
+	UnifiedBlinkLoggingMixin
+)
+from osn_selenium.abstract.webdriver.blink.logging import (
+	AbstractBlinkLoggingMixin
+)
+
+
+__all__ = ["BlinkLoggingMixin"]
+
+
+class BlinkLoggingMixin(UnifiedBlinkLoggingMixin, AbstractBlinkLoggingMixin):
+	"""
+	Mixin for retrieving and managing browser logs for Blink WebDrivers.
+
+	Allows access to various log types (e.g., browser, performance, driver)
+	generated during the session execution.
+	"""
+	
+	def get_log(self, log_type: str) -> Any:
+		return self._get_log_impl(log_type=log_type)
+	
+	def log_types(self) -> Any:
+		return self._log_types_impl()

osn_selenium/webdrivers/sync/blink/network.py

@@ -0,0 +1,28 @@
+from typing import Any, Dict
+from osn_selenium.webdrivers.unified.blink.network import (
+	UnifiedBlinkNetworkMixin
+)
+from osn_selenium.abstract.webdriver.blink.network import (
+	AbstractBlinkNetworkMixin
+)
+
+
+__all__ = ["BlinkNetworkMixin"]
+
+
+class BlinkNetworkMixin(UnifiedBlinkNetworkMixin, AbstractBlinkNetworkMixin):
+	"""
+	Mixin for network interception and condition simulation for Blink WebDrivers.
+
+	Facilitates monitoring of network traffic, modifying requests/responses,
+	and emulating specific network conditions like offline mode or latency.
+	"""
+	
+	def delete_network_conditions(self) -> None:
+		self._delete_network_conditions_impl()
+	
+	def get_network_conditions(self) -> Dict[str, Any]:
+		return self._get_network_conditions_impl()
+	
+	def set_network_conditions(self, **network_conditions: Any) -> None:
+		self._set_network_conditions_impl(**network_conditions)

osn_selenium/webdrivers/sync/blink/settings.py

@@ -0,0 +1,63 @@
+from typing import Optional
+from osn_selenium.models import WindowRect
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.models.blink import BlinkFlags
+from osn_selenium.webdrivers.sync.core.settings import CoreSettingsMixin
+from osn_selenium.webdrivers.unified.blink.settings import (
+	UnifiedBlinkSettingsMixin
+)
+from osn_selenium.abstract.webdriver.blink.settings import (
+	AbstractBlinkSettingsMixin
+)
+
+
+__all__ = ["BlinkSettingsMixin"]
+
+
+class BlinkSettingsMixin(
+		UnifiedBlinkSettingsMixin,
+		CoreSettingsMixin,
+		AbstractBlinkSettingsMixin
+):
+	"""
+	Mixin for configuring and updating settings of the Blink WebDriver.
+
+	Provides methods to modify browser flags, window rectangles, and other
+	configuration parameters either before startup or during a reset.
+	"""
+	
+	def reset_settings(
+			self,
+			flags: Optional[BlinkFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: str = "",
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._reset_settings_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+	
+	def update_settings(
+			self,
+			flags: Optional[BlinkFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._update_settings_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)

osn_selenium/webdrivers/sync/chrome/__init__.py

@@ -0,0 +1,102 @@
+from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.chrome import ChromeFlagsManager
+from osn_selenium.flags.models.chrome import ChromeFlags
+from osn_selenium.webdrivers.sync.blink import BlinkWebDriver
+from osn_selenium.webdrivers.sync.chrome.base import ChromeBaseMixin
+from osn_selenium.webdrivers.sync.chrome.settings import ChromeSettingsMixin
+from osn_selenium.webdrivers.sync.chrome.lifecycle import ChromeLifecycleMixin
+from osn_selenium.abstract.webdriver.chrome import (
+	AbstractChromeWebDriver
+)
+
+
+__all__ = ["ChromeWebDriver"]
+
+
+class ChromeWebDriver(
+		ChromeBaseMixin,
+		ChromeLifecycleMixin,
+		ChromeSettingsMixin,
+		BlinkWebDriver,
+		AbstractChromeWebDriver,
+):
+	def __init__(
+			self,
+			webdriver_path: str,
+			flags_manager_type: Type[ChromeFlagsManager] = ChromeFlagsManager,
+			use_browser_exe: bool = True,
+			browser_name_in_system: str = "Google Chrome",
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			flags: Optional[ChromeFlags] = None,
+			start_page_url: str = "",
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+	):
+		"""
+		Initializes the synchronous Chrome WebDriver with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the ChromeDriver executable.
+			flags_manager_type (Type[ChromeFlagsManager]): The class type used for managing Chrome flags.
+				Defaults to ChromeFlagsManager.
+			use_browser_exe (bool): Whether to use a specific browser executable path or auto-detect.
+				Defaults to True.
+			browser_name_in_system (str): The name of the browser in the system registry or path.
+				Defaults to "Google Chrome".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Chrome browser executable.
+				If None, it may be auto-detected based on other parameters.
+			flags (Optional[ChromeFlags]): Initial set of flags to configure the Chrome instance.
+			start_page_url (str): The URL to navigate to immediately upon startup.
+				Defaults to "about:blank".
+			implicitly_wait (int): Default implicit wait time in seconds. Defaults to 5.
+			page_load_timeout (int): Default page load timeout in seconds. Defaults to 5.
+			script_timeout (int): Default script execution timeout in seconds. Defaults to 5.
+			window_rect (Optional[WindowRect]): Initial window dimensions and position.
+				If None, browser defaults are used.
+			cdp_versioned_packages_paths (Optional[Mapping[int, PATH_TYPEHINT]]): Custom local paths for specific CDP versions packages.
+			ignore_cdp_version_package_missing (bool): Whether to ignore missing CDP package errors.
+		"""
+		
+		BlinkWebDriver.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				webdriver_path=webdriver_path,
+				use_browser_exe=use_browser_exe,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+		
+		ChromeBaseMixin.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				webdriver_path=webdriver_path,
+				architecture="sync",
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)

osn_selenium/webdrivers/sync/chrome/base.py

@@ -0,0 +1,118 @@
+from osn_selenium.models import WindowRect
+from typing import (
+	Mapping,
+	Optional,
+	Type
+)
+from osn_selenium.flags.chrome import ChromeFlagsManager
+from osn_selenium.flags.models.chrome import ChromeFlags
+from selenium.webdriver import (
+	Chrome as legacyChrome
+)
+from osn_selenium.webdrivers.sync.blink.base import BlinkBaseMixin
+from osn_selenium._typehints import (
+	ARCHITECTURES_TYPEHINT,
+	PATH_TYPEHINT
+)
+from osn_selenium.webdrivers.unified.chrome.base import (
+	UnifiedChromeBaseMixin
+)
+from osn_selenium.abstract.webdriver.chrome.base import (
+	AbstractChromeBaseMixin
+)
+
+
+__all__ = ["ChromeBaseMixin"]
+
+
+class ChromeBaseMixin(UnifiedChromeBaseMixin, BlinkBaseMixin, AbstractChromeBaseMixin):
+	"""
+	Base mixin for Chrome WebDrivers handling core initialization and state management.
+
+	This class serves as the foundation for browser-specific implementations, managing
+	the WebDriver executable path, configuration flags, timeouts, and the active
+	driver instance.
+	"""
+	
+	def __init__(
+			self,
+			webdriver_path: str,
+			architecture: ARCHITECTURES_TYPEHINT,
+			flags_manager_type: Type[ChromeFlagsManager] = ChromeFlagsManager,
+			use_browser_exe: bool = True,
+			browser_name_in_system: str = "Google Chrome",
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			flags: Optional[ChromeFlags] = None,
+			start_page_url: str = "about:blank",
+			implicitly_wait: int = 5,
+			page_load_timeout: int = 5,
+			script_timeout: int = 5,
+			window_rect: Optional[WindowRect] = None,
+			cdp_versioned_packages_paths: Optional[Mapping[int, PATH_TYPEHINT]] = None,
+			ignore_cdp_version_package_missing: bool = True,
+	):
+		"""
+		Initializes the synchronous Chrome WebDriver mixin with specified configuration.
+
+		Args:
+			webdriver_path (str): Path to the ChromeDriver executable.
+			architecture (ARCHITECTURE_TYPEHINT): System architecture.
+			flags_manager_type (Type[ChromeFlagsManager]): The class type used for managing Chrome flags.
+				Defaults to ChromeFlagsManager.
+			use_browser_exe (bool): Whether to use a specific browser executable path or auto-detect.
+				Defaults to True.
+			browser_name_in_system (str): The name of the browser in the system registry or path.
+				Defaults to "Google Chrome".
+			browser_exe (Optional[PATH_TYPEHINT]): Explicit path to the Chrome browser executable.
+				If None, it may be auto-detected based on other parameters.
+			flags (Optional[ChromeFlags]): Initial set of flags to configure the Chrome instance.
+			start_page_url (str): The URL to navigate to immediately upon startup.
+				Defaults to "about:blank".
+			implicitly_wait (int): Default implicit wait time in seconds. Defaults to 5.
+			page_load_timeout (int): Default page load timeout in seconds. Defaults to 5.
+			script_timeout (int): Default script execution timeout in seconds. Defaults to 5.
+			window_rect (Optional[WindowRect]): Initial window dimensions and position.
+				If None, browser defaults are used.
+			cdp_versioned_packages_paths (Optional[Mapping[int, PATH_TYPEHINT]]): Custom local paths for specific CDP versions packages.
+			ignore_cdp_version_package_missing (bool): Whether to ignore missing CDP package errors.
+		"""
+		
+		BlinkBaseMixin.__init__(
+				self,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				webdriver_path=webdriver_path,
+				architecture=architecture,
+				flags_manager_type=flags_manager_type,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+		
+		UnifiedChromeBaseMixin.__init__(
+				self,
+				webdriver_path=webdriver_path,
+				architecture=architecture,
+				flags_manager_type=flags_manager_type,
+				use_browser_exe=use_browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				browser_exe=browser_exe,
+				flags=flags,
+				start_page_url=start_page_url,
+				implicitly_wait=implicitly_wait,
+				page_load_timeout=page_load_timeout,
+				script_timeout=script_timeout,
+				window_rect=window_rect,
+				cdp_versioned_packages_paths=cdp_versioned_packages_paths,
+				ignore_cdp_version_package_missing=ignore_cdp_version_package_missing,
+		)
+	
+	@property
+	def driver(self) -> Optional[legacyChrome]:
+		return self._driver_impl

osn_selenium/webdrivers/sync/chrome/lifecycle.py

@@ -0,0 +1,63 @@
+from typing import Optional
+from osn_selenium.models import WindowRect
+from osn_selenium._typehints import PATH_TYPEHINT
+from osn_selenium.flags.models.chrome import ChromeFlags
+from osn_selenium.webdrivers.sync.blink import BlinkLifecycleMixin
+from osn_selenium.webdrivers.unified.chrome.lifecycle import (
+	UnifiedChromeLifecycleMixin
+)
+from osn_selenium.abstract.webdriver.chrome.lifecycle import (
+	AbstractChromeLifecycleMixin
+)
+
+
+__all__ = ["ChromeLifecycleMixin"]
+
+
+class ChromeLifecycleMixin(
+		UnifiedChromeLifecycleMixin,
+		BlinkLifecycleMixin,
+		AbstractChromeLifecycleMixin
+):
+	"""
+	Mixin for managing the lifecycle of the Chrome WebDriver.
+
+	Handles the creation, startup, shutdown, and restarting processes of the
+	underlying browser instance, ensuring clean session management.
+	"""
+	
+	def restart_webdriver(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._restart_webdriver_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)
+	
+	def start_webdriver(
+			self,
+			flags: Optional[ChromeFlags] = None,
+			browser_exe: Optional[PATH_TYPEHINT] = None,
+			browser_name_in_system: Optional[str] = None,
+			use_browser_exe: Optional[bool] = None,
+			start_page_url: Optional[str] = None,
+			window_rect: Optional[WindowRect] = None,
+	) -> None:
+		self._start_webdriver_impl(
+				flags=flags,
+				browser_exe=browser_exe,
+				browser_name_in_system=browser_name_in_system,
+				use_browser_exe=use_browser_exe,
+				start_page_url=start_page_url,
+				window_rect=window_rect,
+		)