Why Find element by link text in Selenium Python? - Purpose & Use Cases

The Big Idea

What if you could click any link on a page just by its words, without hunting through code or layout?

The Scenario

Imagine you need to test a website with many links. You try to click a link by looking at the page and guessing where it is. You scroll up and down, searching for the exact link text manually.

The Problem

This manual way is slow and tiring. You might click the wrong link by mistake. If the page changes, you have to search all over again. It's easy to miss links or make errors, and testing takes much longer.

The Solution

Using "Find element by link text" lets you tell the test exactly which link to click by its visible text. The test finds the link fast and clicks it every time, even if the page layout changes. This makes testing faster, more reliable, and less frustrating.

Before vs After

✗ Before

element = driver.find_element_by_xpath("//a[contains(text(),'Home')]")

✓ After

element = driver.find_element(By.LINK_TEXT, 'Home')

What It Enables

This method makes your tests smart and stable by directly targeting links by their text, saving time and avoiding mistakes.

Real Life Example

When testing an online store, you can quickly click the "Checkout" link by its text, no matter where it appears on the page, ensuring smooth test flow.

Key Takeaways

Manual searching for links is slow and error-prone.

Finding elements by link text targets links exactly by their visible words.

This makes automated tests faster, clearer, and more reliable.

Practice

1. What does the Selenium method find_element_by_link_text do?

easy

A. It finds elements by their CSS class name.

B. It finds any element by its HTML tag name.

C. It finds a link on the page by its exact visible text.

D. It finds elements by their XPath expression.

Solution

1. Step 1: Understand the method purpose

   find_element_by_link_text specifically searches for anchor (<a>) elements by their visible text on the page.

2. Step 2: Compare with other locator types

   Other methods like finding by tag name, class name, or XPath do not focus on link text but on different attributes or structures.

3. Final Answer:

   It finds a link on the page by its exact visible text. -> Option C

4. Quick Check:

   find_element_by_link_text = exact link text match [OK]

Hint: Link text locator matches exact visible text only [OK]

Common Mistakes:

• Confusing link text with partial text
• Using it to find non-link elements
• Assuming it matches partial text automatically

2. Which of the following is the correct syntax to find a link with text "Home" using Selenium in Python?

easy

A. driver.find_element_link_text("Home")

B. driver.find_element_by_link("Home")

C. driver.find_element_by_text_link("Home")

D. driver.find_element_by_link_text("Home")

Solution

1. Step 1: Recall Selenium method naming

   The correct method to find a link by its exact text is find_element_by_link_text.

2. Step 2: Check method call syntax

   The method is called on the driver object with the link text as a string argument, e.g., driver.find_element_by_link_text("Home").

3. Final Answer:

   driver.find_element_by_link_text("Home") -> Option D

4. Quick Check:

   Correct method name and syntax = driver.find_element_by_link_text("Home") [OK]

Hint: Remember full method name: find_element_by_link_text [OK]

Common Mistakes:

• Using incomplete or incorrect method names
• Missing parentheses or quotes
• Confusing with other locator methods

3. What will be the output of the following code snippet if the page contains a link with text exactly "Contact Us"?

element = driver.find_element_by_link_text("Contact Us")
print(element.tag_name)

medium

A. a

B. div

C. span

D. NoSuchElementException

Solution

1. Step 1: Understand what find_element_by_link_text returns

   This method returns the anchor (<a>) element whose visible text matches exactly "Contact Us".

2. Step 2: Check the tag name of a link element

   Links in HTML are represented by the <a> tag, so element.tag_name will be "a".

3. Final Answer:

   a -> Option A

4. Quick Check:

   Link tag name = "a" [OK]

Hint: Link elements always have tag name 'a' [OK]

Common Mistakes:

• Assuming tag name is 'div' or 'span'
• Expecting text output instead of tag name
• Not handling exceptions if link missing

4. Given the code below, what is the error and how to fix it?

element = driver.find_element_by_link_text('About')
print(element.text)

Assume the link text on the page is "About Us".

medium

A. SyntaxError due to missing parentheses; fix by adding parentheses.

B. NoSuchElementException because link text does not match exactly; fix by using full text "About Us".

C. AttributeError because element has no text attribute; fix by using element.get_text().

D. No error; code works fine.

Solution

1. Step 1: Check link text matching requirement

   The method find_element_by_link_text requires exact visible text match. "About" does not match "About Us" exactly.

2. Step 2: Identify the error and fix

   Because of mismatch, Selenium raises NoSuchElementException. Fix is to use the exact link text: 'About Us'.

3. Final Answer:

   NoSuchElementException because link text does not match exactly; fix by using full text "About Us". -> Option B

4. Quick Check:

   Exact text match needed = NoSuchElementException because link text does not match exactly; fix by using full text "About Us". [OK]

Hint: Link text must match exactly, no partial matches [OK]

Common Mistakes:

• Using partial link text with find_element_by_link_text
• Confusing element.text with get_text()
• Ignoring exception when element not found

5. You want to click a link that has the visible text "Learn More" but sometimes the link text changes to "Learn More About Us". How can you reliably find and click this link using Selenium in Python?

hard

A. Use find_element_by_partial_link_text("Learn More") to match both variations.

B. Use find_element_by_link_text("Learn More") only and ignore other cases.

C. Use find_element_by_id("learnMoreLink") assuming the link has an id.

D. Use find_element_by_tag_name("a") and click the first link.

Solution

1. Step 1: Understand the problem with exact link text

   Since the link text changes between "Learn More" and "Learn More About Us", exact match with find_element_by_link_text will fail for one variation.

2. Step 2: Use partial link text locator

   find_element_by_partial_link_text("Learn More") matches any link containing "Learn More", covering both cases reliably.

3. Step 3: Consider other options

   Using id requires knowing the id attribute, which may not exist. Clicking the first <a> tag is unreliable and may click wrong link.

4. Final Answer:

   Use find_element_by_partial_link_text("Learn More") to match both variations. -> Option A

5. Quick Check:

   Partial link text matches multiple variations [OK]

Hint: Partial link text finds links with text containing given string [OK]

Common Mistakes:

• Using exact link text when text varies
• Assuming link has id without checking
• Clicking first link without filtering