Headless execution in Selenium Java

Introduction

Headless execution runs browser tests without opening a visible window. It helps run tests faster and saves computer resources.

When running automated tests on a server without a screen.

When you want tests to run faster by skipping browser display.

When running many tests in parallel to save memory and CPU.

When integrating tests into continuous integration pipelines.

When you do not need to watch the browser during test execution.

Syntax

Selenium Java

ChromeOptions options = new ChromeOptions();
options.addArguments("--headless");
WebDriver driver = new ChromeDriver(options);

Use browser-specific options to enable headless mode.

Headless mode means the browser runs in the background without a GUI.

Examples

Run Chrome browser in headless mode.

Selenium Java

ChromeOptions options = new ChromeOptions();
options.addArguments("--headless");
WebDriver driver = new ChromeDriver(options);

Run Firefox browser in headless mode.

Selenium Java

FirefoxOptions options = new FirefoxOptions();
options.addArguments("-headless");
WebDriver driver = new FirefoxDriver(options);

Sample Program

This test opens example.com in headless Chrome, prints the page title, then closes the browser.

Selenium Java

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

public class HeadlessTest {
    public static void main(String[] args) {
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--headless");
        WebDriver driver = new ChromeDriver(options);

        driver.get("https://example.com");
        String title = driver.getTitle();
        System.out.println("Page title is: " + title);

        driver.quit();
    }
}

Important Notes

Headless mode may behave slightly differently than normal mode; test carefully.

Some websites may detect headless browsers and block them.

Use headless mode mainly for faster, resource-saving automated tests.

Summary

Headless execution runs browser tests without showing the browser window.

It is useful for running tests on servers or in automation pipelines.

Enable headless mode by adding specific arguments to browser options.