Why findElement by partialLinkText in Selenium Java? - Purpose & Use Cases

The Big Idea

What if you could find any link by just remembering a few words, no matter how the full text changes?

The Scenario

Imagine you are testing a website with many links, and you need to click a link but only remember part of its text, like 'Contact'. You try to find it by scanning the whole page manually.

The Problem

Manually searching for links by exact text is slow and frustrating. If the link text changes slightly or is long, you might miss it or click the wrong one. This wastes time and causes errors.

The Solution

Using findElement by partialLinkText lets you find links by just part of their text. This means you don't need the full exact text, making tests faster, simpler, and more reliable.

Before vs After

✗ Before

driver.findElement(By.linkText("Contact Us Today"));

✓ After

driver.findElement(By.partialLinkText("Contact"));

What It Enables

This lets you quickly and flexibly find links even if their full text changes, making your tests more robust and easier to maintain.

Real Life Example

On a shopping site, a link might say 'View Contact Details' or 'Contact Support'. Using partialLinkText with 'Contact' finds both without changing your test.

Key Takeaways

Manual exact text search is slow and error-prone.

PartialLinkText finds links by part of their text easily.

It makes tests faster, flexible, and less fragile.

Practice

1. What does the Selenium method findElement(By.partialLinkText("Login")) do?

easy

A. Finds the first button with the text "Login".

B. Finds the first link containing the text "Login" anywhere in its visible text.

C. Finds all links that exactly match the text "Login".

D. Finds the first element with the attribute partialLinkText="Login".

Solution

1. Step 1: Understand the method purpose

   The method findElement(By.partialLinkText("Login")) searches for a link element whose visible text contains the substring "Login".

2. Step 2: Identify the matching behavior

   It returns the first matching link element, not all links or buttons, and does not look for attributes named partialLinkText.

3. Final Answer:

   Finds the first link containing the text "Login" anywhere in its visible text. -> Option B

4. Quick Check:

   Partial link text finds first matching link [OK]

Hint: PartialLinkText finds first link containing given substring [OK]

Common Mistakes:

• Confusing partialLinkText with exact link text
• Expecting multiple elements returned
• Using it to find buttons or other elements
• Assuming it matches attributes instead of visible text

2. Which of the following is the correct syntax to find a link containing the text "Register" using Selenium in Java?

easy

A. driver.findElement(By.partialTextLink("Register"));

B. driver.findElement(By.partialLink("Register"));

C. driver.findElement(By.linkTextContains("Register"));

D. driver.findElement(By.partialLinkText("Register"));

Solution

1. Step 1: Recall correct Selenium locator syntax

   The correct method to find a link by partial text is By.partialLinkText("text").

2. Step 2: Check each option's method name

   Only driver.findElement(By.partialLinkText("Register")); uses the correct method name partialLinkText. Others are invalid or do not exist in Selenium.

3. Final Answer:

   driver.findElement(By.partialLinkText("Register")); -> Option D

4. Quick Check:

   Correct method name is partialLinkText [OK]

Hint: Use By.partialLinkText("text") exactly for partial link search [OK]

Common Mistakes:

• Using incorrect method names like partialLink or partialTextLink
• Confusing partialLinkText with linkTextContains
• Missing parentheses or quotes in syntax
• Using By.linkText for partial matches

3. Given the HTML links:
<a href='home.html'>Home Page</a>
<a href='login.html'>User Login</a>
<a href='logout.html'>Logout</a>
What will the following Java Selenium code return?
WebElement link = driver.findElement(By.partialLinkText("Log"));
String href = link.getAttribute("href");

medium

A. "login.html"

B. "logout.html"

C. "home.html"

D. NoSuchElementException at runtime

Solution

1. Step 1: Identify links containing "Log"

   Links with visible text "User Login" and "Logout" both contain "Log" substring.

2. Step 2: Understand findElement behavior

   findElement returns the first matching element in the page order, which is "User Login" with href "login.html".

3. Final Answer:

   "login.html" -> Option A

4. Quick Check:

   First partial link match is "User Login" [OK]

Hint: findElement returns first partial match in page order [OK]

Common Mistakes:

• Assuming it returns all matches, not first
• Choosing "logout.html" because it also contains "Log"
• Expecting an exception if multiple matches exist
• Confusing visible text with href attribute

4. You wrote this Selenium Java code:
WebElement link = driver.findElement(By.partialLinkText("Sign Up"));
But it throws NoSuchElementException even though the page has a link with text "SignUp Now".
What is the most likely cause?

medium

A. You must use By.linkText instead of partialLinkText for multi-word links.

B. partialLinkText cannot find links with multiple words.

C. The partialLinkText "Sign Up" does not match because of the missing space in "SignUp".

D. The link is inside an iframe and not switched to it.

Solution

1. Step 1: Check partialLinkText matching rules

   partialLinkText requires an exact substring match in the link's visible text, case-sensitive and including spaces. "Sign Up" (with space after "Sign") is not a substring of "SignUp Now" (no space).

2. Step 2: Identify the most likely cause

   The spacing mismatch causes NoSuchElementException. Iframe issues are possible but less likely given the highlighted text difference.

3. Final Answer:

   The partialLinkText "Sign Up" does not match because of the missing space in "SignUp". -> Option C

4. Quick Check:

   partialLinkText requires exact substring match incl. spaces [OK]

Hint: partialLinkText matches exact substrings including spaces [OK]

Common Mistakes:

• Thinking partialLinkText ignores spaces or whitespace
• Using linkText instead of partialLinkText unnecessarily
• Not verifying exact visible link text on page
• Overlooking iframe context unnecessarily

5. You want to click a link that contains the text "Profile" but the page has multiple links like "User Profile", "Edit Profile", and "Profile Settings".
How can you ensure Selenium clicks the "Edit Profile" link using findElement(By.partialLinkText())?

hard

A. Use driver.findElement(By.partialLinkText("Edit Profile")) to match exactly that link.

B. Use driver.findElement(By.partialLinkText("Profile")) and then filter by href attribute manually.

C. Use driver.findElements(By.partialLinkText("Profile")) and click the second element in the list.

D. Use driver.findElement(By.linkText("Edit Profile")) instead of partialLinkText.

Solution

1. Step 1: Understand broad partialLinkText limitation

   By.partialLinkText("Profile") finds the first link like "User Profile", not necessarily "Edit Profile".

2. Step 2: Use precise substring with findElement

   driver.findElement(By.partialLinkText("Edit Profile")) targets links containing that specific phrase, matching "Edit Profile" without assuming order or using findElements.

3. Final Answer:

   Use driver.findElement(By.partialLinkText("Edit Profile")) to match exactly that link. -> Option A

4. Quick Check:

   Specific substring in partialLinkText ensures target [OK]

Hint: Use longer specific substring in partialLinkText for precision [OK]

Common Mistakes:

• Using vague "Profile" assuming findElement picks desired link
• Relying on findElements and assuming fixed page order
• Ignoring zero-based indexing in element lists
• Switching to linkText ignoring partialLinkText requirement