File download handling in Selenium Java

Introduction

We handle file downloads in tests to check if files are saved correctly when users download them from a website.

Testing if a report downloads correctly after clicking a button.

Verifying that an invoice PDF is saved when requested.

Checking if an image file downloads properly from a gallery.

Ensuring a CSV export feature saves the file as expected.

Syntax

Selenium Java

FirefoxProfile profile = new FirefoxProfile();
profile.setPreference("browser.download.folderList", 2);
profile.setPreference("browser.download.dir", "C:\\Downloads");
profile.setPreference("browser.helperApps.neverAsk.saveToDisk", "application/pdf");

WebDriver driver = new FirefoxDriver(new FirefoxOptions().setProfile(profile));

Set preferences to avoid popup dialogs during download.

Specify the folder path where files will be saved.

Examples

This sets Firefox to download PDF files automatically to the specified folder without asking.

Selenium Java

FirefoxProfile profile = new FirefoxProfile();
profile.setPreference("browser.download.folderList", 2);
profile.setPreference("browser.download.dir", "C:\\Users\\User\\Downloads");
profile.setPreference("browser.helperApps.neverAsk.saveToDisk", "application/pdf");
WebDriver driver = new FirefoxDriver(new FirefoxOptions().setProfile(profile));

This configures Chrome to download files automatically to the given folder without popups.

Selenium Java

ChromeOptions options = new ChromeOptions();
Map<String, Object> prefs = new HashMap<>();
prefs.put("download.default_directory", "C:\\Downloads");
prefs.put("download.prompt_for_download", false);
options.setExperimentalOption("prefs", prefs);
WebDriver driver = new ChromeDriver(options);

Sample Program

This test opens Firefox with settings to download PDF files automatically to C:\Downloads. It navigates to a PDF URL to trigger the download, waits 5 seconds, then prints a confirmation message.

Selenium Java

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;
import org.openqa.selenium.firefox.FirefoxProfile;

public class FileDownloadTest {
    public static void main(String[] args) throws InterruptedException {
        FirefoxProfile profile = new FirefoxProfile();
        profile.setPreference("browser.download.folderList", 2);
        profile.setPreference("browser.download.dir", "C:\\Downloads");
        profile.setPreference("browser.helperApps.neverAsk.saveToDisk", "application/pdf");

        FirefoxOptions options = new FirefoxOptions();
        options.setProfile(profile);

        WebDriver driver = new FirefoxDriver(options);

        driver.get("https://example.com/sample.pdf");

        // Wait for download to complete (simple wait for demo)
        Thread.sleep(5000);

        System.out.println("Download started and should be saved in C:\\Downloads");

        driver.quit();
    }
}

Important Notes

Always set the correct MIME type in preferences to avoid download prompts.

Use absolute paths for download directories to avoid confusion.

Waiting for download completion can be improved by checking the file system instead of fixed sleep.

Summary

File download handling lets tests check if files save correctly.

Set browser preferences to download files automatically without popups.

Use waits or file checks to confirm downloads finish before assertions.

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