Merge branch 'trunk' into print-page-size-options

Author: yvsvarma

MODULE.bazel

@@ -93,7 +93,7 @@ register_toolchains("@dotnet_toolchains//:all")
 oci = use_extension("@rules_oci//oci:extensions.bzl", "oci")
 oci.pull(
     name = "java_image_base",
-    digest = "sha256:161a1d97d592b3f1919801578c3a47c8e932071168a96267698f4b669c24c76d",
+    digest = "sha256:1df9f3e6a2de0544dd04f1840aa811d334045c9126f9e93d8da45448061ad51e",
     image = "gcr.io/distroless/java17",
 )
 oci.pull(

py/selenium/webdriver/common/by.py

@@ -22,7 +22,58 @@
 
 
 class By:
-    """Set of supported locator strategies."""
+    """Set of supported locator strategies.
+
+    ID:
+    --
+    Select the element by its ID.
+
+    >>> element = driver.find_element(By.ID, 'myElement')
+
+    XPATH:
+    ------
+    Select the element via XPATH.
+        - absolute path
+        - relative path
+
+    >>> element = driver.find_element(By.XPATH, '//html/body/div')
+
+    LINK_TEXT:
+    ----------
+    Select the link element having the exact text.
+
+    >>> element = driver.find_element(By.LINK_TEXT, 'myLink')
+
+    PARTIAL_LINK_TEXT:
+    ------------------
+    Select the link element having the partial text.
+
+    >>> element = driver.find_element(By.PARTIAL_LINK_TEXT, 'my')
+
+    NAME:
+    ----
+    Select the element by its name attribute.
+
+    >>> element = driver.find_element(By.NAME, 'myElement')
+
+    TAG_NAME:
+    --------
+    Select the element by its tag name.
+
+    >>> element = driver.find_element(By.TAG_NAME, 'div')
+
+    CLASS_NAME:
+    ----------
+    Select the element by its class name.
+
+    >>> element = driver.find_element(By.CLASS_NAME, 'myElement')
+
+    CSS_SELECTOR:
+    -------------
+    Select the element by its CSS selector.
+
+    >>> element = driver.find_element(By.CSS_SELECTOR, 'div.myElement')
+    """
 
     ID = "id"
     XPATH = "xpath"