findElement by partialLinkText in Selenium Java

Introduction

We use findElement by partialLinkText to find a link on a webpage when we only know part of its text. This helps us click or check links easily without needing the full text.

When the full link text is long or changes but part of it stays the same.

When you want to click a link but only remember a few words from it.

When testing a webpage with many links that share similar text.

When the link text is dynamic but contains a fixed keyword.

When you want to avoid errors from exact text mismatches in links.

Syntax

Selenium Java

WebElement element = driver.findElement(By.partialLinkText("partial text"));

The partialLinkText locator finds the first link containing the given text.

This method works only for links (<a> tags) on the page.

Examples

This finds the first link that has the word "Learn" anywhere in its text.

Selenium Java

WebElement element = driver.findElement(By.partialLinkText("Learn"));

This finds a link with text containing "Contact", like "Contact Us" or "Contact Support".

Selenium Java

WebElement element = driver.findElement(By.partialLinkText("Contact"));

This finds a link with "Home" in its text, such as "Homepage" or "Go Home".

Selenium Java

WebElement element = driver.findElement(By.partialLinkText("Home"));

Sample Program

This program opens a browser, goes to example.com, finds a link with the word "More" in its text, prints the link text, clicks it, and then closes the browser.

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;

public class PartialLinkTextExample {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://example.com");
            // Find link containing 'More' in its text
            WebElement link = driver.findElement(By.partialLinkText("More"));
            System.out.println("Link text found: " + link.getText());
            // Click the link
            link.click();
            System.out.println("Clicked the link successfully.");
        } catch (Exception e) {
            System.out.println("Error: " + e.getMessage());
        } finally {
            driver.quit();
        }
    }
}

Important Notes

If multiple links contain the partial text, only the first one is found.

Partial link text matching is case-sensitive in Selenium Java.

Make sure the link is visible and enabled before clicking it to avoid errors.

Summary

findElement by partialLinkText helps find links using part of their text.

It is useful when full link text is unknown or changes.

Remember it finds only the first matching link on the page.

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