Skip to content

Screenshot capture in Selenium

Screenshot capture in Selenium allows users to programmatically save the current state of the browser window as an image file, which is useful for debugging test failures or verifying visual elements.^[600-developer-automatic-chromedriver.md]

Implementation

The capability to capture screenshots is provided by the TakesScreenshot interface. To perform a capture, the WebDriver instance must be cast to this interface to invoke the getScreenshotAs method.^[600-developer-automatic-chromedriver.md]

The method typically uses OutputType.FILE to save the screenshot, returning the image as a File object that can be copied to a specific location on the disk.^[600-developer-automatic-chromedriver.md]

Code Example

The following Java example demonstrates capturing a screenshot and saving it with a timestamp:

File screen = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
File file = new File(image, new Date().getTime() + ".png");
FileUtils.copyFile(screen, file);
^[600-developer-automatic-chromedriver.md]

Capturing Specific Elements

It is possible to capture only a specific area of the screen, such as a single WebElement (e.g., an image or banner), rather than the entire viewport.^[600-developer-automatic-chromedriver.md]

This process involves three main steps: 1. Identify the target element's dimensions (width, height) and its location (x, y) on the page. 2. Read the full screenshot into a BufferedImage. 3. Use image processing libraries (like ImageIO) to crop the original image based on the element's coordinates and save the result.^[600-developer-automatic-chromedriver.md]

  • [[Selenium]]
  • [[WebDriver]]
  • [[Headless browser]]

Sources

  • 600-developer-automatic-chromedriver.md