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

Recall & Review

beginner

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

Selenium cannot directly interact with the browser's native file download dialog, so handling downloads requires configuring browser settings or using workarounds.

intermediate

How can you set a custom download folder in Selenium with Python for Firefox?

You can set Firefox profile preferences like 'browser.download.dir' to specify the folder and 'browser.helperApps.neverAsk.saveToDisk' to auto-download certain file types.

beginner

Why is it important to disable the download prompt in automated tests?

Disabling the prompt allows the test to download files automatically without manual intervention, making tests fully automated and faster.

beginner

What Python module can help verify that a file has been downloaded successfully?

The 'os' module can check if the expected file exists in the download directory after the download action.

intermediate

How do you handle file downloads in Chrome using Selenium with Python?

You configure ChromeOptions with 'prefs' to set 'download.default_directory' and disable the download prompt by setting 'download.prompt_for_download' to False.

Which Selenium feature helps set the download folder for Firefox?

A FirefoxProfile preferences

B ChromeOptions arguments

C WebDriverWait

D ActionChains

FirefoxProfile preferences allow setting download folder and behavior for Firefox browser.

What must you disable to avoid the download dialog popup during automated tests?

A Implicit wait

B Download prompt

C Page load timeout

D JavaScript execution

Disabling the download prompt allows files to download automatically without manual clicks.

Which Python module is commonly used to check if a file exists after download?

A sys

B random

C math

D os

The 'os' module provides functions like os.path.exists() to verify file presence.

In Chrome, which preference sets the default download directory?

A download.default_directory

B browser.download.dir

C download.prompt_for_download

D profile.default_content_settings.popups

'download.default_directory' sets the folder where Chrome saves downloaded files.

Why can't Selenium directly handle native OS file dialogs?

A Because file dialogs are disabled in browsers

B Because Selenium only works with JavaScript

C Because they are outside the browser DOM

D Because Selenium only supports Chrome

Native OS dialogs are outside the browser's HTML structure, so Selenium cannot control them.

Explain how to configure Selenium with Python to download files automatically without user interaction.

Think about browser settings and how to check files after download.

Describe why handling file downloads is different from other web interactions in Selenium automation.

Consider the difference between browser content and OS-level dialogs.

Practice

1. What is the main purpose of setting browser preferences in Selenium for file downloads?

easy

A. To specify the folder where downloaded files are saved automatically

B. To speed up the browser loading time

C. To change the browser's theme

D. To disable JavaScript on the page

Solution

1. Step 1: Understand browser preferences role

   Browser preferences let you control how downloads behave, like where files save.

2. Step 2: Identify the correct purpose

   Setting preferences to specify download folder avoids manual prompts and saves files automatically.

3. Final Answer:

   To specify the folder where downloaded files are saved automatically -> Option A

4. Quick Check:

   Download folder control = A [OK]

Hint: Remember: preferences set download folder and disable prompts [OK]

Common Mistakes:

• Thinking preferences speed up browser loading
• Confusing download folder with browser theme
• Assuming preferences disable JavaScript

2. Which of the following is the correct way to set Firefox preferences in Selenium to automatically download PDF files to a folder without prompt?

easy

A. profile.set_preference('browser.download.folderList', '2')

B. profile.set_preference('browser.download.folderList', 2)

C. profile.set_preference('browser.download.folderList', True)

D. profile.set_preference('browser.download.folderList', None)

Solution

1. Step 1: Recall Firefox preference for download folder

   The 'browser.download.folderList' preference expects an integer: 0 (desktop), 1 (default), 2 (custom folder).

2. Step 2: Choose correct data type and value

   Using integer 2 sets a custom folder; string or other types cause errors.

3. Final Answer:

   profile.set_preference('browser.download.folderList', 2) -> Option B

4. Quick Check:

   Integer 2 for custom folder = B [OK]

Hint: Use integer 2, not string, for custom download folder [OK]

Common Mistakes:

• Passing '2' as string instead of integer
• Using boolean True instead of integer
• Passing None which disables setting

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

import os
from selenium import webdriver

options = webdriver.FirefoxOptions()
profile = webdriver.FirefoxProfile()
profile.set_preference('browser.download.folderList', 2)
profile.set_preference('browser.download.dir', '/tmp/downloads')
profile.set_preference('browser.helperApps.neverAsk.saveToDisk', 'application/pdf')
driver = webdriver.Firefox(firefox_profile=profile, options=options)
driver.get('http://example.com/sample.pdf')

file_path = '/tmp/downloads/sample.pdf'
print(os.path.exists(file_path))

medium

A. True

B. False

C. SyntaxError

D. FileNotFoundError

Solution

1. Step 1: Analyze download setup

   Preferences set to save PDF automatically to '/tmp/downloads'.

2. Step 2: Check file existence print

   After download, os.path.exists returns True if file is present.

3. Final Answer:

   True -> Option A

4. Quick Check:

   File exists after download = True [OK]

Hint: os.path.exists returns True if file is saved correctly [OK]

Common Mistakes:

• Assuming print outputs file path string
• Expecting False without download
• Confusing syntax or runtime errors

4. Identify the error in this Selenium Python code for downloading a CSV file:

profile = webdriver.FirefoxProfile()
profile.set_preference('browser.download.folderList', 2)
profile.set_preference('browser.download.dir', '/tmp/downloads')
profile.set_preference('browser.helperApps.neverAsk.saveToDisk', 'text/csv')
driver = webdriver.Firefox(profile)
driver.get('http://example.com/data.csv')

medium

A. Missing options parameter in webdriver.Firefox()

B. Download folder path must be absolute

C. Incorrect argument name; should be firefox_profile=profile

D. Wrong MIME type for CSV files

Solution

1. Step 1: Check webdriver.Firefox() usage

   Firefox expects profile passed as firefox_profile=profile, not just profile.

2. Step 2: Confirm other settings

   MIME type 'text/csv' and folder path are correct; no options parameter needed here.

3. Final Answer:

   Incorrect argument name; should be firefox_profile=profile -> Option C

4. Quick Check:

   Use firefox_profile=profile argument = D [OK]

Hint: Pass profile with firefox_profile=profile keyword [OK]

Common Mistakes:

• Passing profile as positional argument
• Changing MIME type unnecessarily
• Using relative folder path

5. You want to verify that a file named 'report.xlsx' has been downloaded successfully using Selenium Python. Which approach is best to confirm the download in an automated test?

hard

A. Check the page source for the file name

B. Check the browser's download history via Selenium API

C. Wait for an alert popup confirming download

D. Use os.path.exists() to check the file in the download folder

Solution

1. Step 1: Understand Selenium's download verification limits

   Selenium cannot access browser download history or alerts for downloads.

2. Step 2: Use file system check

   Checking file existence with os.path.exists() in the download folder confirms the file saved.

3. Final Answer:

   Use os.path.exists() to check the file in the download folder -> Option D

4. Quick Check:

   File system check confirms download = A [OK]

Hint: Verify downloads by checking file presence on disk [OK]

Common Mistakes:

• Trying to read browser download history
• Waiting for non-existent alert popups
• Searching page source for downloaded file