JavaScript executor basics in Selenium Python

Introduction

Sometimes, normal commands can't do everything on a webpage. JavaScript executor lets you run JavaScript code directly in the browser to control or check things.

When a button or element is hidden and normal click doesn't work.

To scroll the page to a specific position quickly.

To get or set values that are not accessible by usual methods.

To run custom JavaScript code for testing special page behaviors.

When you want to check or change styles or attributes dynamically.

Syntax

Selenium Python

driver.execute_script("JavaScript code here")

You use execute_script method of the Selenium WebDriver.

The JavaScript code is a string inside the parentheses and quotes.

Examples

This runs a JavaScript alert popup in the browser.

Selenium Python

driver.execute_script("alert('Hello from Selenium!')")

This scrolls the page to the bottom.

Selenium Python

driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")

This gets the page title using JavaScript and stores it in value.

Selenium Python

value = driver.execute_script("return document.title;")

Sample Program

This script opens a webpage, scrolls to the bottom, prints the page title using JavaScript, changes the background color, and then closes the browser.

Selenium Python

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.common.by import By
import time

# Setup Chrome driver (adjust path as needed)
service = Service('/path/to/chromedriver')
driver = webdriver.Chrome(service=service)

try:
    driver.get('https://example.com')
    
    # Scroll to bottom using JavaScript executor
    driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
    time.sleep(2)  # wait to see the scroll effect

    # Get page title using JavaScript
    title = driver.execute_script("return document.title;")
    print(f'Page title is: {title}')

    # Change background color using JavaScript
    driver.execute_script("document.body.style.backgroundColor = 'lightblue';")
    time.sleep(2)  # wait to see the color change

finally:
    driver.quit()

Important Notes

Always quit the driver to close the browser after tests.

Use return in JavaScript to get values back into Python.

JavaScript executor can run any JavaScript code, so be careful with syntax.

Summary

JavaScript executor runs JavaScript code inside the browser from Selenium.

It helps when normal Selenium commands can't interact with elements properly.

Use execute_script method with JavaScript code as a string.

Practice

1. What is the main purpose of using execute_script in Selenium with Python?

easy

A. To run JavaScript code inside the browser during a test

B. To start the Selenium WebDriver server

C. To locate elements using CSS selectors

D. To take screenshots of the browser window

Solution

1. Step 1: Understand the role of execute_script

   This method allows running JavaScript code inside the browser from Selenium tests.

2. Step 2: Compare with other Selenium functions

   Other functions locate elements or control the browser, but execute_script specifically runs JS code.

3. Final Answer:

   To run JavaScript code inside the browser during a test -> Option A

4. Quick Check:

   execute_script runs JS code [OK]

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

Common Mistakes:

• Confusing execute_script with element locating methods
• Thinking execute_script starts WebDriver server
• Assuming execute_script takes screenshots

2. Which of the following is the correct syntax to run JavaScript code that returns the page title using Selenium's execute_script in Python?

easy

A. driver.execute_script('return document.title')

B. driver.execute_script(document.title)

C. driver.execute_script('document.title')

D. driver.execute_script(return document.title)

Solution

1. Step 1: Check correct string usage for JS code

   The JavaScript code must be passed as a string, so quotes are needed around 'return document.title'.

2. Step 2: Verify the return keyword usage

   To get a value back from JS, 'return' must be used inside the string.

3. Final Answer:

   driver.execute_script('return document.title') -> Option A

4. Quick Check:

   JS code as string with return keyword [OK]

Hint: Always pass JS code as a quoted string with return [OK]

Common Mistakes:

• Passing JS code without quotes
• Omitting the return keyword when expecting a value
• Using invalid syntax without quotes or return

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

title = driver.execute_script('return document.title')
print(title)

medium

A. Prints the WebDriver object reference

B. Prints None because execute_script returns nothing

C. Prints the current page's title as a string

D. Raises a syntax error due to missing quotes

Solution

1. Step 1: Understand what execute_script returns

   When JavaScript code returns a value, execute_script returns it to Python.

2. Step 2: Analyze the JS code 'return document.title'

   This returns the page title as a string, so the variable 'title' holds that string.

3. Final Answer:

   Prints the current page's title as a string -> Option C

4. Quick Check:

   execute_script returns JS value [OK]

Hint: Return keyword in JS returns value to Python [OK]

Common Mistakes:

• Assuming execute_script returns None always
• Confusing JS code string syntax
• Expecting execute_script to print automatically

4. Identify the error in this code snippet:

driver.execute_script(return document.body.style.backgroundColor = 'red')

medium

A. Incorrect method name, should be execute_js

B. Missing quotes around the JavaScript code string

C. Cannot change background color with JavaScript

D. Syntax error due to missing parentheses

Solution

1. Step 1: Check the argument passed to execute_script

   The JavaScript code must be passed as a string, but here it is passed without quotes.

2. Step 2: Confirm method name and JS validity

   The method name is correct and changing background color with JS is valid.

3. Final Answer:

   Missing quotes around the JavaScript code string -> Option B

4. Quick Check:

   JS code must be a quoted string [OK]

Hint: Always wrap JS code in quotes for execute_script [OK]

Common Mistakes:

• Forgetting quotes around JS code
• Thinking method name is wrong
• Believing JS cannot change styles

5. You want to scroll the page down by 500 pixels using Selenium's JavaScript executor in Python. Which code snippet correctly does this?

hard

A. driver.execute_script('window.scrollTo(500, 0)')

B. driver.execute_script('scrollTo(0, 500)')

C. driver.execute_script('scrollBy(500, 0)')

D. driver.execute_script('window.scrollBy(0, 500)')

Solution

1. Step 1: Understand scrolling methods in JavaScript

   window.scrollBy(x, y) scrolls by x and y pixels relative to current position.

2. Step 2: Identify correct parameters for scrolling down

   To scroll down 500 pixels, x=0 and y=500 is correct.

3. Final Answer:

   driver.execute_script('window.scrollBy(0, 500)') -> Option D

4. Quick Check:

   scrollBy(0, 500) scrolls down 500px [OK]

Hint: Use window.scrollBy(0, pixels) to scroll down [OK]

Common Mistakes:

• Swapping x and y values
• Using scrollTo instead of scrollBy incorrectly
• Passing wrong parameters causing horizontal scroll