Executing JavaScript in Selenium Java

Introduction

Sometimes, Selenium cannot perform certain actions directly. Executing JavaScript helps control the browser in ways Selenium alone cannot.

When clicking a button that Selenium's click() cannot reach.

To scroll the page to a specific position.

To get or set values of elements not accessible by Selenium methods.

To change the style or attributes of elements dynamically during tests.

To trigger browser alerts or confirm dialogs.

Syntax

Selenium Java

JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("javascript code here");

You must cast the WebDriver instance to JavascriptExecutor.

The executeScript method runs JavaScript code in the browser context.

Examples

This example shows how to display a browser alert using JavaScript.

Selenium Java

JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("alert('Hello from JavaScript!')");

This scrolls the page down by 500 pixels vertically.

Selenium Java

JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("window.scrollBy(0, 500);");

This adds a red border around a specific element to highlight it.

Selenium Java

JavascriptExecutor js = (JavascriptExecutor) driver;
WebElement element = driver.findElement(By.id("myElement"));
js.executeScript("arguments[0].style.border='3px solid red';", element);

Sample Program

This test opens a webpage, scrolls down, highlights the main heading by changing its background color, and prints the page title using JavaScript execution.

Selenium Java

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

public class ExecuteJavaScriptExample {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();
        try {
            driver.get("https://www.example.com");

            JavascriptExecutor js = (JavascriptExecutor) driver;

            // Scroll down 300 pixels
            js.executeScript("window.scrollBy(0,300);");

            // Find element and highlight it
            WebElement heading = driver.findElement(By.tagName("h1"));
            js.executeScript("arguments[0].style.backgroundColor = 'yellow';", heading);

            // Get page title using JavaScript
            String title = (String) js.executeScript("return document.title;");
            System.out.println("Page title is: " + title);

        } finally {
            driver.quit();
        }
    }
}

Important Notes

Always cast your WebDriver to JavascriptExecutor before running JavaScript.

Use arguments[0], arguments[1], etc., to pass WebElements or values safely into the script.

Be careful with JavaScript code syntax; errors can cause test failures.

Summary

Executing JavaScript lets you do things Selenium cannot do directly.

Use JavascriptExecutor and executeScript() method to run JavaScript in the browser.

Pass WebElements as arguments to manipulate page elements safely.

Practice

1. What is the main purpose of using JavascriptExecutor in Selenium Java?

easy

A. To locate elements on the page using JavaScript selectors

B. To execute JavaScript code directly in the browser during a test

C. To start the Selenium WebDriver session

D. To generate test reports automatically

Solution

1. Step 1: Understand the role of JavascriptExecutor

   JavascriptExecutor allows running JavaScript code inside the browser from Selenium tests.

2. Step 2: Identify the main use case

   It is mainly used to perform actions or retrieve information that Selenium WebDriver cannot do directly.

3. Final Answer:

   To execute JavaScript code directly in the browser during a test -> Option B

4. Quick Check:

   JavascriptExecutor runs JS code in browser [OK]

Hint: Remember: JavascriptExecutor runs JS code inside browser [OK]

Common Mistakes:

• Confusing JavascriptExecutor with element locators
• Thinking it starts WebDriver sessions
• Assuming it generates reports

2. Which of the following is the correct way to cast a WebDriver instance to JavascriptExecutor in Selenium Java?

easy

A. JavascriptExecutor js = driver.executeScript();

B. JavascriptExecutor js = driver.getJavascriptExecutor();

C. JavascriptExecutor js = new JavascriptExecutor(driver);

D. JavascriptExecutor js = (JavascriptExecutor) driver;

Solution

1. Step 1: Recall the casting syntax in Java

   To use JavascriptExecutor, you cast the WebDriver instance like this: (JavascriptExecutor) driver.

2. Step 2: Check each option

   JavascriptExecutor js = (JavascriptExecutor) driver; uses correct casting syntax. The other options are invalid method calls or constructors.

3. Final Answer:

   JavascriptExecutor js = (JavascriptExecutor) driver; -> Option D

4. Quick Check:

   Cast driver to JavascriptExecutor using (JavascriptExecutor) [OK]

Hint: Casting uses (JavascriptExecutor) before driver [OK]

Common Mistakes:

• Using non-existent methods like getJavascriptExecutor()
• Trying to instantiate JavascriptExecutor with new keyword
• Calling executeScript() without casting

3. What will be the output of the following code snippet?

JavascriptExecutor js = (JavascriptExecutor) driver;
String title = (String) js.executeScript("return document.title;");
System.out.println(title);

medium

A. Prints the current page's title

B. Throws a ClassCastException

C. Prints 'undefined'

D. Prints the URL of the page

Solution

1. Step 1: Understand the JavaScript executed

   The script returns document.title, which is the page's title as a string.

2. Step 2: Check the casting and output

   The returned object is cast to String and printed, so it outputs the page title.

3. Final Answer:

   Prints the current page's title -> Option A

4. Quick Check:

   executeScript returns document.title string [OK]

Hint: executeScript returns JS value; cast to String for title [OK]

Common Mistakes:

• Expecting URL instead of title
• Not casting return value to String
• Confusing output with undefined or errors

4. Identify the error in the following code snippet:

JavascriptExecutor js = (JavascriptExecutor) driver;
js.executeScript("arguments[0].click();");

medium

A. Incorrect casting of driver to JavascriptExecutor

B. executeScript method does not exist

C. Missing WebElement argument to click()

D. JavaScript syntax error in the string

Solution

1. Step 1: Analyze the executeScript call

   The script uses arguments[0].click(); which requires a WebElement passed as an argument.

2. Step 2: Check the method call parameters

   No WebElement is passed to executeScript, so it will fail at runtime.

3. Final Answer:

   Missing WebElement argument to click() -> Option C

4. Quick Check:

   arguments[0] needs a WebElement passed [OK]

Hint: Pass WebElement as argument when using arguments[0] [OK]

Common Mistakes:

• Forgetting to pass WebElement argument
• Assuming casting is wrong
• Thinking executeScript method is missing

5. You want to scroll a page to a specific WebElement using JavaScript in Selenium Java. Which code snippet correctly achieves this?

hard

A. js.executeScript("arguments[0].scrollIntoView(true);", element);

B. js.executeScript("window.scrollTo(element);");

C. js.executeScript("scrollToElement(arguments[0]);", element);

D. js.executeScript("document.scrollTo(arguments[0]);");

Solution

1. Step 1: Recall JavaScript method to scroll to element

   The correct JS method is scrollIntoView(true) called on the element.

2. Step 2: Check the Selenium executeScript usage

   Pass the WebElement as an argument and use arguments[0].scrollIntoView(true); to scroll.

3. Final Answer:

   js.executeScript("arguments[0].scrollIntoView(true);", element); -> Option A

4. Quick Check:

   Use scrollIntoView with element argument [OK]

Hint: Use arguments[0].scrollIntoView(true) with element [OK]

Common Mistakes:

• Using window.scrollTo with element (invalid)
• Calling non-existent scrollToElement function
• Not passing element as argument