findElement by partialLinkText in Selenium Java - Test Execution Trace

Test Overview

This test opens a web page and finds a link using a part of its visible text. It then clicks the link and verifies that the new page contains expected content.

Test Code - JUnit

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class PartialLinkTextTest {
    private WebDriver driver;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
    }

    @Test
    public void testFindElementByPartialLinkText() {
        driver.get("https://example.com");
        WebElement link = driver.findElement(By.partialLinkText("More information"));
        link.click();
        String pageSource = driver.getPageSource();
        assertTrue(pageSource.contains("Example Domain"), "Page should contain 'Example Domain'");
    }

    @AfterEach
    public void tearDown() {
        if (driver != null) {
            driver.quit();
        }
    }
}

Execution Trace - 6 Steps

Step	Action	System State	Assertion	Result
1	Test starts and Chrome browser opens	Chrome browser window is open and ready	—	PASS
2	Browser navigates to https://example.com	Page loads showing Example Domain homepage	—	PASS
3	Find element by partial link text 'More information'	Link with text containing 'More information' is located	Element is found and not null	PASS
4	Click the found link	Browser navigates to the linked page	—	PASS
5	Get page source and check it contains 'Example Domain'	Page source is retrieved	Assert page source contains 'Example Domain'	PASS
6	Test ends and browser closes	Browser window is closed	—	PASS

Failure Scenario

Failing Condition: The link with partial text 'More information' is not found on the page

Execution Trace Quiz - 3 Questions

What method is used to find the link in this test?

A findElement(By.id("More information"))

B findElement(By.className("More information"))

C findElement(By.partialLinkText("More information"))

D findElement(By.tagName("a"))

Key Result

Using partialLinkText locator helps find links when you know only part of the link text, making tests more flexible and less brittle.

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