findElement by partialLinkText in Selenium Java - Build an Automation Script

Verify navigation using partial link text

Preconditions (2)

Step 1: Locate the link using partial link text 'Selenium'

Step 2: Click on the located link

Step 3: Wait for the new page to load

Step 4: Verify the URL contains 'selenium-automation'

Step 5: Verify the page title contains 'Selenium Automation'

✅ Expected Result: Clicking the link with partial text 'Selenium' navigates to the Selenium Automation page with correct URL and page title

Automation Requirements - Selenium WebDriver with JUnit 5

Assertions Needed:

Assert current URL contains 'selenium-automation'

Assert page title contains 'Selenium Automation'

Best Practices:

Use explicit waits to wait for page load

Use By.partialLinkText locator for finding the link

Use Page Object Model pattern for maintainability

Close the browser after test execution

Automated Solution

Selenium Java

import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.support.ui.WebDriverWait;

import java.time.Duration;

import static org.junit.jupiter.api.Assertions.assertTrue;

public class PartialLinkTextTest {
    private WebDriver driver;
    private WebDriverWait wait;

    @BeforeEach
    public void setUp() {
        driver = new ChromeDriver();
        wait = new WebDriverWait(driver, Duration.ofSeconds(10));
        driver.manage().window().maximize();
        driver.get("https://example.com/homepage");
    }

    @Test
    public void testNavigateUsingPartialLinkText() {
        // Locate link by partial link text 'Selenium'
        WebElement link = wait.until(ExpectedConditions.elementToBeClickable(By.partialLinkText("Selenium")));
        link.click();

        // Wait for URL to contain 'selenium-automation'
        wait.until(ExpectedConditions.urlContains("selenium-automation"));

        // Assert URL contains expected text
        String currentUrl = driver.getCurrentUrl();
        assertTrue(currentUrl.contains("selenium-automation"), "URL should contain 'selenium-automation'");

        // Assert page title contains expected text
        String title = driver.getTitle();
        assertTrue(title.contains("Selenium Automation"), "Title should contain 'Selenium Automation'");
    }

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

This test uses Selenium WebDriver with JUnit 5 to automate the manual test case.

Setup: We open Chrome browser and navigate to the homepage URL.

Test: We locate the link using By.partialLinkText("Selenium") which finds any link containing the word 'Selenium'. We wait until the link is clickable, then click it.

We then wait explicitly for the URL to contain 'selenium-automation' to ensure the page has loaded.

Assertions check that the current URL and page title contain the expected text, confirming correct navigation.

Teardown: The browser closes after the test to clean up.

This approach uses explicit waits to avoid timing issues and follows best practices for maintainability and reliability.

Common Mistakes - 3 Pitfalls

Using Thread.sleep() instead of explicit waits

Using By.linkText instead of By.partialLinkText when partial text is needed

Not closing the browser after test execution

Bonus Challenge

Now add data-driven testing with 3 different partial link texts to verify navigation for each.

Show Hint

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