selenium.webdriver.common.by

The By implementation.

Classes

By()

Set of supported locator strategies.
class selenium.webdriver.common.by.By[source]

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: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'id'
XPATH: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'xpath'
LINK_TEXT: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'link text'
PARTIAL_LINK_TEXT: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'partial link text'
NAME: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'name'
TAG_NAME: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'tag name'
CLASS_NAME: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'class name'
CSS_SELECTOR: Literal['id', 'xpath', 'link text', 'partial link text', 'name', 'tag name', 'class name', 'css selector'] = 'css selector'
classmethod register_custom_finder(name: str, strategy: str) → None[source]
classmethod get_finder(name: str) → str | None[source]
classmethod clear_custom_finders() → None[source]