File download handling in Selenium Java - Test Execution Trace

Test Overview

This test automates downloading a file from a web page and verifies that the file is successfully saved in the expected folder.

Test Code - Selenium

Selenium Java

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;
import java.io.File;
import java.time.Duration;
import static org.junit.jupiter.api.Assertions.assertTrue;

public class FileDownloadTest {
    public static void main(String[] args) throws InterruptedException {
        String downloadFilepath = System.getProperty("user.dir") + "/downloads";
        File downloadDir = new File(downloadFilepath);
        if (!downloadDir.exists()) {
            downloadDir.mkdir();
        }

        ChromeOptions options = new ChromeOptions();
        options.addArguments("--headless=new");
        options.addArguments("--disable-gpu");
        options.addArguments("--window-size=1920,1080");
        options.addArguments("--no-sandbox");
        options.addArguments("--disable-dev-shm-usage");
        options.setExperimentalOption("prefs", java.util.Map.of(
            "download.default_directory", downloadFilepath,
            "download.prompt_for_download", false,
            "download.directory_upgrade", true,
            "safebrowsing.enabled", true
        ));

        WebDriver driver = new ChromeDriver(options);
        try {
            driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10));
            driver.get("https://www.selenium.dev/downloads/");

            // Find the download link for Selenium Server (example file)
            driver.findElement(By.linkText("4.12.0"))
                  .click();

            // Wait for the file to appear in the download folder
            File downloadedFile = new File(downloadFilepath + "/selenium-server-4.12.0.jar");
            int waitTime = 0;
            while (!downloadedFile.exists() && waitTime < 15000) { // wait max 15 seconds
                Thread.sleep(500);
                waitTime += 500;
            }

            assertTrue(downloadedFile.exists(), "Downloaded file should exist");
        } finally {
            driver.quit();
        }
    }
}

Execution Trace - 5 Steps

Step	Action	System State	Assertion	Result
1	Test starts and ChromeDriver is initialized with download preferences set to a custom folder	Browser is ready with headless mode and download folder configured	—	PASS
2	Browser navigates to https://www.selenium.dev/downloads/	Selenium downloads page is loaded	—	PASS
3	Finds the link with text '4.12.0' and clicks it to start file download	Download of selenium-server-4.12.0.jar file starts	—	PASS
4	Waits up to 15 seconds for the file selenium-server-4.12.0.jar to appear in the download folder	File appears in the download folder	Check if downloaded file exists in the folder	PASS
5	Test ends and browser closes	Browser closed, test complete	—	PASS

Failure Scenario

Failing Condition: The file does not download within 15 seconds or is saved to a different location

Execution Trace Quiz - 3 Questions

What is the purpose of setting 'download.default_directory' in ChromeOptions?

A To disable file downloads

B To open downloads in a new tab

C To specify where downloaded files are saved

D To clear browser cache before download

Key Result

Always configure the browser's download directory explicitly in automated tests to reliably verify file downloads without manual intervention.

Practice

1. What is the main purpose of handling file downloads in Selenium tests?

easy

A. To verify that files are downloaded correctly without manual intervention

B. To upload files to the web application

C. To change the browser's homepage

D. To clear browser cookies automatically

Solution

1. Step 1: Understand file download handling

   File download handling in Selenium is used to check if files are saved correctly during automated tests.

2. Step 2: Identify the correct purpose

   Among the options, only verifying file downloads matches this purpose.

3. Final Answer:

   To verify that files are downloaded correctly without manual intervention -> Option A

4. Quick Check:

   File download handling = verify downloads [OK]

Hint: File download handling checks saved files, not uploads [OK]

Common Mistakes:

• Confusing download handling with file upload
• Thinking it changes browser settings unrelated to downloads
• Assuming it clears cookies automatically

2. Which Java code snippet correctly sets Chrome options to automatically download files to a folder without popup?

easy

A. ChromeOptions options = new ChromeOptions(); options.addArguments("--disable-popup-blocking");

B. ChromeOptions options = new ChromeOptions(); options.setHeadless(true);

C. ChromeOptions options = new ChromeOptions(); Map prefs = new HashMap<>(); prefs.put("download.default_directory", "/path/to/download"); options.setExperimentalOption("prefs", prefs);

D. ChromeOptions options = new ChromeOptions(); options.addArguments("--start-maximized");

Solution

1. Step 1: Identify how to set download folder in ChromeOptions

   Setting the "download.default_directory" preference in ChromeOptions disables popup and sets download path.

2. Step 2: Match code snippet with correct setting

   ChromeOptions options = new ChromeOptions(); Map prefs = new HashMap<>(); prefs.put("download.default_directory", "/path/to/download"); options.setExperimentalOption("prefs", prefs); correctly creates prefs map and sets it as experimental option for ChromeOptions.

3. Final Answer:

   ChromeOptions options = new ChromeOptions(); Map prefs = new HashMap<>(); prefs.put("download.default_directory", "/path/to/download"); options.setExperimentalOption("prefs", prefs); -> Option C

4. Quick Check:

   Set prefs for download folder = ChromeOptions options = new ChromeOptions(); Map prefs = new HashMap<>(); prefs.put("download.default_directory", "/path/to/download"); options.setExperimentalOption("prefs", prefs); [OK]

Hint: Use prefs map with "download.default_directory" for downloads [OK]

Common Mistakes:

• Using addArguments instead of prefs for download folder
• Setting headless mode does not affect downloads
• Forgetting to set experimental options

3. Given the following code snippet, what will be the output if the file is downloaded successfully?

File file = new File("/downloads/report.pdf");
boolean isDownloaded = file.exists();
System.out.println(isDownloaded);

medium

A. false

B. Compilation error

C. FileNotFoundException

D. true

Solution

1. Step 1: Understand file.exists() method

   The exists() method returns true if the file exists at the given path, false otherwise.

2. Step 2: Analyze the scenario

   If the file "report.pdf" is downloaded successfully to "/downloads", file.exists() returns true and prints it.

3. Final Answer:

   true -> Option D

4. Quick Check:

   file.exists() = true if file present [OK]

Hint: file.exists() returns true if file is present [OK]

Common Mistakes:

• Assuming file.exists() throws exception if file missing
• Confusing boolean output with exceptions
• Thinking it returns file content

4. You wrote this code to check file download but the test always fails. What is the likely issue?

File file = new File("/downloads/report.pdf");
assertTrue(file.exists());

Options:

medium

A. The test does not wait for the download to complete before checking

B. The file path is incorrect syntax in Java

C. assertTrue is not a valid assertion method

D. File class cannot check file existence

Solution

1. Step 1: Identify timing issue in file existence check

   The test may check file existence before download finishes, causing false failure.

2. Step 2: Understand need for wait or polling

   Adding wait or retry logic ensures file is fully downloaded before assertion.

3. Final Answer:

   The test does not wait for the download to complete before checking -> Option A

4. Quick Check:

   Wait for download before assertTrue(file.exists()) [OK]

Hint: Always wait for download to finish before checking file [OK]

Common Mistakes:

• Assuming file path syntax is wrong
• Thinking assertTrue is invalid
• Believing File class can't check existence

5. You want to verify a file download in Selenium Java tests for multiple file types (.pdf, .csv, .xlsx) saved in the same folder. Which approach best ensures correct file download handling?

hard

A. Check only the file size of the last downloaded file without verifying extension

B. Set browser to download automatically, then check folder for new file with expected extension after triggering download

C. Use Thread.sleep(5000) after download trigger and assume file is saved

D. Manually open the download popup and click save for each file type

Solution

1. Step 1: Configure browser for automatic downloads

   Setting browser preferences to auto-download files avoids popup interruptions for all file types.

2. Step 2: Verify download by checking folder for new file with expected extension

   After triggering download, checking the folder for a new file with the correct extension confirms success reliably.

3. Final Answer:

   Set browser to download automatically, then check folder for new file with expected extension after triggering download -> Option B

4. Quick Check:

   Auto-download + check file extension = reliable verification [OK]

Hint: Auto-download + check folder for new file extension [OK]

Common Mistakes:

• Relying on manual popup handling in automated tests
• Using fixed sleep without checking file presence
• Ignoring file extension verification