Element-level screenshot in Selenium Python

Introduction

Taking a screenshot of a specific element helps you focus on just that part of the page. It makes it easier to check if that element looks right or works well.

You want to verify the appearance of a button after a click.

You need to capture only the logo image on a webpage for comparison.

You want to save a screenshot of an error message box to share with developers.

You want to check if a form field is displayed correctly on different devices.

Syntax

Selenium Python

element = driver.find_element(By.CSS_SELECTOR, "selector")
element.screenshot('filename.png')

The element.screenshot() method saves the screenshot of that element only.

Use a good locator (like CSS selector or XPath) to find the element precisely.

Examples

This saves a screenshot of the button with ID 'submit-btn'.

Selenium Python

button = driver.find_element(By.ID, "submit-btn")
button.screenshot('submit_button.png')

This captures only the logo image inside the element with class 'site-logo'.

Selenium Python

logo = driver.find_element(By.CSS_SELECTOR, ".site-logo img")
logo.screenshot('logo.png')

Sample Program

This script opens a webpage, finds the main heading <h1>, and saves a screenshot of just that heading element.

Selenium Python

from selenium import webdriver
from selenium.webdriver.common.by import By
import time

# Setup driver (make sure chromedriver is in PATH)
driver = webdriver.Chrome()

# Open example page
driver.get('https://www.example.com')

# Wait for page to load
time.sleep(2)

# Find the heading element
heading = driver.find_element(By.TAG_NAME, 'h1')

# Take screenshot of the heading element
heading.screenshot('heading_element.png')

print('Screenshot saved as heading_element.png')

driver.quit()

Important Notes

Make sure the element is visible on the screen before taking the screenshot.

Element screenshots capture only the element's area, not the whole page.

Use explicit waits instead of time.sleep() for better reliability in real tests.

Summary

Element-level screenshots help focus on specific parts of a webpage.

Use element.screenshot('file.png') after locating the element.

Good locators and visible elements ensure accurate screenshots.

Practice

1. What does the element.screenshot('file.png') method do in Selenium Python?

easy

A. Takes a screenshot of the entire webpage and saves it as 'file.png'.

B. Takes a screenshot of the specific web element and saves it as 'file.png'.

C. Locates the element and highlights it on the page.

D. Deletes the element from the webpage.

Solution

1. Step 1: Understand the method purpose

   The element.screenshot() method captures only the visible part of the specific element, not the whole page.

2. Step 2: Confirm the file saving behavior

   The method saves the screenshot as the given filename, like 'file.png'.

3. Final Answer:

   Takes a screenshot of the specific web element and saves it as 'file.png'. -> Option B

4. Quick Check:

   element.screenshot() = element screenshot [OK]

Hint: Remember: element.screenshot saves only that element's image [OK]

Common Mistakes:

• Confusing element screenshot with full page screenshot
• Thinking it highlights or deletes the element
• Using it without locating the element first

2. Which of the following is the correct syntax to take a screenshot of a web element stored in variable button and save it as 'button.png'?

easy

A. button.save_screenshot('button.png')

B. driver.screenshot('button.png')

C. driver.save_element_screenshot(button, 'button.png')

D. button.screenshot('button.png')

Solution

1. Step 1: Identify the correct method for element screenshot

   The screenshot() method is called on the element object, here button.

2. Step 2: Confirm the syntax matches the method signature

   The correct syntax is button.screenshot('button.png'). Other options use incorrect methods or call on driver.

3. Final Answer:

   button.screenshot('button.png') -> Option D

4. Quick Check:

   element.screenshot(filename) = correct syntax [OK]

Hint: Call screenshot() on element, not driver [OK]

Common Mistakes:

• Calling screenshot on driver instead of element
• Using non-existent methods like save_screenshot on element
• Passing element as argument to driver methods

3. Given the code snippet:

element = driver.find_element(By.ID, 'logo')
element.screenshot('logo.png')

What will happen if the element with ID 'logo' is not visible on the page?

medium

A. The screenshot will be taken but the image will be blank or empty.

B. An exception will be raised because the element is not visible.

C. The entire page screenshot will be saved instead.

D. The file 'logo.png' will not be created.

Solution

1. Step 1: Understand element visibility effect on screenshot

   If the element is found but not visible, Selenium still takes a screenshot of the element's area, which may be blank.

2. Step 2: Confirm behavior on invisible elements

   No exception is raised for invisibility; the file is created but image content is empty or transparent.

3. Final Answer:

   The screenshot will be taken but the image will be blank or empty. -> Option A

4. Quick Check:

   Invisible element screenshot = blank image [OK]

Hint: Invisible element screenshot saves blank image, no error [OK]

Common Mistakes:

• Expecting an exception for invisible elements
• Thinking full page screenshot is saved
• Assuming file won't be created

4. Identify the error in this code snippet:

element = driver.find_element(By.CLASS_NAME, 'submit-btn')
element.screenshot = 'submit.png'

medium

A. The element variable should be a list, not a single element.

B. The locator By.CLASS_NAME is invalid.

C. Incorrect assignment; screenshot is a method, not a property.

D. The filename must be a full path, not just 'submit.png'.

Solution

1. Step 1: Check method usage for screenshot

   The code assigns a string to element.screenshot, but screenshot is a method and must be called with parentheses.

2. Step 2: Confirm correct method call syntax

   The correct usage is element.screenshot('submit.png'), not assignment.

3. Final Answer:

   Incorrect assignment; screenshot is a method, not a property. -> Option C

4. Quick Check:

   Use parentheses to call screenshot() method [OK]

Hint: Remember: screenshot is a method, call with () [OK]

Common Mistakes:

• Assigning filename to screenshot instead of calling method
• Using wrong locator strategy
• Expecting list when find_element returns single element

5. You want to take screenshots of multiple buttons on a page and save them as 'button1.png', 'button2.png', etc. Which code snippet correctly does this?

hard

A. buttons = driver.find_elements(By.TAG_NAME, 'button')
for i, btn in enumerate(buttons, 1):
btn.screenshot(f'button{i}.png')

B. buttons = driver.find_elements(By.TAG_NAME, 'button')
for i in range(len(buttons)):
buttons.screenshot(f'button{i}.png')

C. buttons = driver.find_element(By.TAG_NAME, 'button')
for i, btn in enumerate(buttons):
btn.screenshot('button.png')

D. buttons = driver.find_elements(By.CLASS_NAME, 'button')
for btn in buttons:
btn.screenshot('button.png')

Solution

1. Step 1: Locate multiple elements correctly

   Use find_elements to get a list of all buttons by tag name 'button'.

2. Step 2: Loop with index and save unique filenames

   Use enumerate starting at 1 to create filenames like 'button1.png', 'button2.png'. Call btn.screenshot() on each element.

3. Final Answer:

   buttons = driver.find_elements(By.TAG_NAME, 'button') for i, btn in enumerate(buttons, 1): btn.screenshot(f'button{i}.png') -> Option A

4. Quick Check:

   Loop elements with enumerate and call screenshot() [OK]

Hint: Use enumerate to name files uniquely in loop [OK]

Common Mistakes:

• Calling screenshot on list instead of element
• Using find_element instead of find_elements for multiple
• Saving all screenshots with same filename