refactor[py]: Add type hints to and options.py

- Added explicit type annotations to selenium.webdriver.common.options.py
- Improved code clarity and static type checking
- Ensured compatibility with modern type checkers like Pyright and Mypy

Author: duxtec

py/selenium/webdriver/common/options.py

@@ -88,9 +88,7 @@ def __set__(self, obj, value):
         if value in ("normal", "eager", "none"):
             obj.set_capability(self.name, value)
         else:
-            raise ValueError(
-                "Strategy can only be one of the following: normal, eager, none"
-            )
+            raise ValueError("Strategy can only be one of the following: normal, eager, none")
 
 
 class _UnHandledPromptBehaviorDescriptor:
@@ -144,9 +142,7 @@ def __set__(self, obj, value):
         if all(x in ("implicit", "pageLoad", "script") for x in value.keys()):
             obj.set_capability(self.name, value)
         else:
-            raise ValueError(
-                "Timeout keys can only be one of the following: implicit, pageLoad, script"
-            )
+            raise ValueError("Timeout keys can only be one of the following: implicit, pageLoad, script")
 
 
 class _ProxyDescriptor:
@@ -160,9 +156,7 @@ def __get__(self, obj, cls):
 
     def __set__(self, obj, value):
         if not isinstance(value, Proxy):
-            raise InvalidArgumentException(
-                "Only Proxy objects can be passed in."
-            )
+            raise InvalidArgumentException("Only Proxy objects can be passed in.")
         obj._proxy = value
         obj._caps[self.name] = value.to_capabilities()
 
@@ -236,9 +230,7 @@ class BaseOptions(metaclass=ABCMeta):
         - `None`
     """
 
-    strict_file_interactability = _BaseOptionsDescriptor(
-        "strictFileInteractability"
-    )
+    strict_file_interactability = _BaseOptionsDescriptor("strictFileInteractability")
     """Gets and Sets whether session is about file interactability.
 
     Usage
@@ -348,9 +340,7 @@ class BaseOptions(metaclass=ABCMeta):
         - `None`
     """
 
-    unhandled_prompt_behavior = _UnHandledPromptBehaviorDescriptor(
-        "unhandledPromptBehavior"
-    )
+    unhandled_prompt_behavior = _UnHandledPromptBehaviorDescriptor("unhandledPromptBehavior")
     """:Gets and Sets unhandled prompt behavior, the default is "dismiss and
     notify".