File download handling in Selenium Java - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the main challenge when automating file downloads with Selenium?

Selenium cannot directly interact with OS-level file download dialogs, so handling file downloads requires configuring the browser to download files automatically to a known location.

intermediate

How can you configure Firefox to download files automatically without a popup dialog in Selenium?

By setting Firefox profile preferences such as 'browser.download.folderList', 'browser.download.dir', and 'browser.helperApps.neverAsk.saveToDisk' to specify the download folder and MIME types to save automatically.

beginner

What is the purpose of checking the download folder after triggering a file download in a test?

To verify that the file was downloaded successfully by confirming the file exists and optionally checking its size or content.

intermediate

Why is it important to clean up the download folder before running a file download test?

To avoid false positives by ensuring no leftover files from previous tests interfere with the current test's verification.

beginner

Which Selenium WebDriver method is used to click a download link or button?

The 'click()' method on a WebElement is used to trigger the download by clicking the download link or button.

Which browser setting helps avoid the download dialog popup in Firefox during Selenium tests?

A browser.download.manager.showWhenStarting

B browser.download.animateNotifications

C browser.download.useDownloadDir

D browser.helperApps.neverAsk.saveToDisk

Setting 'browser.helperApps.neverAsk.saveToDisk' with the correct MIME types tells Firefox to save files automatically without asking.

What is a good practice before starting a file download test?

A Disable browser cache

B Clear the download folder

C Maximize the browser window

D Disable JavaScript

Clearing the download folder ensures no old files interfere with verifying the new download.

How do you verify a file was downloaded successfully in Selenium tests?

A Check the file exists in the download folder

B Check the browser console logs

C Check the page source

D Check the browser cookies

Verifying the file exists in the download folder confirms the download succeeded.

Which Selenium WebDriver command triggers a file download?

A driver.switchTo().alert()

B driver.navigate().to()

C driver.findElement(By...).click()

D driver.manage().window().maximize()

Clicking the download link or button triggers the file download.

Why can't Selenium handle OS-level file download dialogs directly?

A Because Selenium controls the browser, not the OS

B Because Selenium only works with JavaScript

C Because file downloads are blocked by Selenium

D Because Selenium requires admin rights

Selenium interacts with the browser but cannot control OS dialogs, so browser settings must be used.

Explain how to set up Firefox in Selenium to download files automatically without showing a popup dialog.

Think about configuring browser preferences before starting the test.

Describe the steps to verify a file download in an automated Selenium test.

Consider both test setup and verification.

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