Headless browser execution in Selenium Python - Build an Automation Script

Verify Google Search page title using headless Chrome browser

Preconditions (3)

Step 1: Launch Chrome browser in headless mode

Step 2: Navigate to 'https://www.google.com'

Step 3: Wait until the page title is available

Step 4: Verify the page title contains the word 'Google'

Step 5: Close the browser

✅ Expected Result: The page title contains 'Google' and the test completes without opening a visible browser window

Automation Requirements - Selenium with Python

Assertions Needed:

Assert that the page title contains the word 'Google'

Best Practices:

Use explicit waits to wait for page title

Use ChromeOptions to enable headless mode

Properly close the browser after test

Use By and WebDriverWait from selenium.webdriver.support

Automated Solution

Selenium Python

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# Setup Chrome options for headless mode
options = Options()
options.add_argument('--headless=new')  # Use new headless mode for Chrome 109+
options.add_argument('--disable-gpu')  # Disable GPU for stability

# Setup ChromeDriver service (adjust path if needed)
service = Service()

# Create WebDriver instance with options
driver = webdriver.Chrome(service=service, options=options)

try:
    # Navigate to Google
    driver.get('https://www.google.com')

    # Wait up to 10 seconds for title to contain 'Google'
    WebDriverWait(driver, 10).until(EC.title_contains('Google'))

    # Assert title contains 'Google'
    assert 'Google' in driver.title, f"Title does not contain 'Google': {driver.title}"

finally:
    # Close the browser
    driver.quit()

This script uses Selenium with Python to open Google in a headless Chrome browser.

We set ChromeOptions to enable headless mode so no browser window appears.

We use WebDriverWait with title_contains to wait until the page title includes 'Google'.

Then we assert the title contains 'Google' to verify the page loaded correctly.

Finally, we close the browser with driver.quit() to clean up.

This approach ensures the test runs without a visible browser and waits properly for the page to load.

Common Mistakes - 4 Pitfalls

Not using explicit waits and immediately asserting the title

{'mistake': 'Forgetting to add headless argument in ChromeOptions', 'why_bad': 'The browser will open visibly, defeating the purpose of headless testing.', 'correct_approach': "Add '--headless=new' argument to ChromeOptions to run Chrome in headless mode."}

Not closing the browser after test

{'mistake': "Using deprecated headless argument '--headless' instead of '--headless=new'", 'why_bad': "Newer Chrome versions recommend '--headless=new' for better stability and features.", 'correct_approach': "Use '--headless=new' for Chrome 109 and above."}

Bonus Challenge

Now add data-driven testing to verify page titles for three different URLs in headless mode

Show Hint

Practice

1. What is the main advantage of running Selenium tests in headless mode?

easy

A. It requires more system resources than normal mode

B. It allows manual interaction with the browser during tests

C. Tests run faster without opening a visible browser window

D. It disables all JavaScript on the web page

Solution

1. Step 1: Understand headless mode purpose

   Headless mode runs browser tests without showing the browser window, saving time and resources.

2. Step 2: Compare options

   Only Tests run faster without opening a visible browser window correctly states that tests run faster without opening a visible window. Other options are incorrect or unrelated.

3. Final Answer:

   Tests run faster without opening a visible browser window -> Option C

4. Quick Check:

   Headless mode = faster tests without UI [OK]

Hint: Headless means no browser window visible during tests [OK]

Common Mistakes:

• Thinking headless disables JavaScript
• Assuming headless mode allows manual browser control
• Believing headless uses more resources

2. Which of the following is the correct way to enable headless mode in Selenium with Python using Chrome?

easy

A. options = webdriver.ChromeOptions()
options.add_argument('--headless')
driver = webdriver.Chrome(options=options)

B. driver = webdriver.Chrome(headless=True)

C. options = webdriver.ChromeOptions()
options.headless = True
driver = webdriver.Chrome(options=options)

D. driver = webdriver.Chrome()
driver.set_headless(True)

Solution

1. Step 1: Review Selenium headless syntax

   To enable headless mode, you add the '--headless' argument to ChromeOptions and pass it to the driver.

2. Step 2: Analyze options

   options = webdriver.ChromeOptions() options.add_argument('--headless') driver = webdriver.Chrome(options=options) correctly uses options.add_argument('--headless') and passes options to Chrome. options = webdriver.ChromeOptions() options.headless = True driver = webdriver.Chrome(options=options) incorrectly sets options.headless (not standard). Options B and D use invalid syntax.

3. Final Answer:

   options = webdriver.ChromeOptions() options.add_argument('--headless') driver = webdriver.Chrome(options=options) -> Option A

4. Quick Check:

   Use add_argument('--headless') to enable headless [OK]

Hint: Use add_argument('--headless') on ChromeOptions [OK]

Common Mistakes:

• Setting options.headless = True (not standard)
• Passing headless=True directly to webdriver.Chrome()
• Calling non-existent set_headless method

3. What will be the output of the following code snippet?

from selenium import webdriver
options = webdriver.ChromeOptions()
options.add_argument('--headless')
driver = webdriver.Chrome(options=options)
driver.get('https://example.com')
print(driver.title)
driver.quit()

medium

A. Opens a visible browser window and prints the title

B. Raises an error because headless mode cannot get page title

C. Prints an empty string because page is not loaded in headless mode

D. Prints the title of the page 'Example Domain' without opening a browser window

Solution

1. Step 1: Understand headless execution effect

   Headless mode runs browser without UI but fully loads pages and executes scripts.

2. Step 2: Analyze code behavior

   The code loads 'https://example.com' and prints the page title. Headless mode does not prevent getting the title, so it prints 'Example Domain'.

3. Final Answer:

   Prints the title of the page 'Example Domain' without opening a browser window -> Option D

4. Quick Check:

   Headless loads page and gets title correctly [OK]

Hint: Headless runs full browser without UI, so title is accessible [OK]

Common Mistakes:

• Assuming headless mode blocks page loading
• Expecting errors when accessing page title in headless
• Thinking headless opens visible browser window

4. You wrote this code to run Chrome in headless mode but the browser window still appears. What is the likely mistake?

from selenium import webdriver
options = webdriver.ChromeOptions()
driver = webdriver.Chrome(options=options)
options.add_argument('--headless')
driver.get('https://example.com')

medium

A. Headless mode is not supported on Chrome

B. The headless argument was added after creating the driver, so it was ignored

C. You must call driver.set_headless(True) after creating the driver

D. You forgot to call driver.quit() to close the window

Solution

1. Step 1: Check order of setting options

   The headless argument must be added to options before creating the driver instance.

2. Step 2: Identify mistake in code

   Here, options.add_argument('--headless') is called after driver creation, so the driver does not run headless.

3. Final Answer:

   The headless argument was added after creating the driver, so it was ignored -> Option B

4. Quick Check:

   Add headless argument before driver creation [OK]

Hint: Add headless option before creating driver instance [OK]

Common Mistakes:

• Adding headless argument after driver creation
• Calling non-existent set_headless method
• Assuming headless unsupported on Chrome

5. You want to run Selenium tests in headless mode on a Linux server without a display. Which combination of steps is correct to ensure tests run smoothly?

hard

A. Use ChromeOptions with '--headless' argument and set '--no-sandbox' and '--disable-dev-shm-usage' arguments

B. Use FirefoxOptions with '--headless' and run tests without any additional arguments

C. Run Chrome without headless mode but use Xvfb to simulate display

D. Use ChromeOptions with '--headless' only; no other arguments needed

Solution

1. Step 1: Understand Linux server constraints

   Linux servers often lack GUI and have limited shared memory, so Chrome needs extra flags to run headless smoothly.

2. Step 2: Identify required ChromeOptions

   Adding '--no-sandbox' and '--disable-dev-shm-usage' helps avoid permission and memory issues on Linux servers.

3. Step 3: Evaluate options

   Use ChromeOptions with '--headless' argument and set '--no-sandbox' and '--disable-dev-shm-usage' arguments correctly includes these flags with '--headless'. Use FirefoxOptions with '--headless' and run tests without any additional arguments misses Linux-specific flags. Run Chrome without headless mode but use Xvfb to simulate display uses Xvfb but not headless mode. Use ChromeOptions with '--headless' only; no other arguments needed misses important flags.

4. Final Answer:

   Use ChromeOptions with '--headless' argument and set '--no-sandbox' and '--disable-dev-shm-usage' arguments -> Option A

5. Quick Check:

   Linux headless Chrome needs extra flags for stability [OK]

Hint: Add '--no-sandbox' and '--disable-dev-shm-usage' on Linux [OK]

Common Mistakes:

• Using headless without Linux-specific flags
• Assuming Firefox needs no extra setup
• Relying on Xvfb instead of headless mode