selenium.webdriver.common.by

The By implementation.

Classes

By()	Set of supported locator strategies.

class By

Bases: object

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, strategy)

Parameters:

• name (str)

• strategy (str)

Return type:

None

classmethod get_finder(name)

Parameters:

name (str)

Return type:

str | None

classmethod clear_custom_finders()

Return type:

None