Window management (maximize, size) in Selenium Java

Introduction

We use window management to control the browser size during tests. This helps us see the web page as a user would and test how it looks and works in different window sizes.

When you want to test how a website looks in full screen.

When you need to set a specific browser window size to test responsive design.

When a test requires the browser window to be a certain size to show all elements.

When you want to avoid issues caused by small or hidden browser windows during testing.

Syntax

Selenium Java

driver.manage().window().maximize();
driver.manage().window().setSize(new Dimension(width, height));
Dimension size = driver.manage().window().getSize();

maximize() makes the browser window fill the screen.

setSize() sets the window to a specific width and height in pixels.

Examples

This command makes the browser window fill the entire screen.

Selenium Java

driver.manage().window().maximize();

This sets the browser window size to 1024 pixels wide and 768 pixels tall.

Selenium Java

driver.manage().window().setSize(new Dimension(1024, 768));

This gets the current size of the browser window and prints the width and height.

Selenium Java

Dimension size = driver.manage().window().getSize();
System.out.println("Width: " + size.getWidth() + ", Height: " + size.getHeight());

Sample Program

This program opens a browser, maximizes the window, prints the size, then resizes the window to 800x600 pixels and prints the new size. Finally, it closes the browser.

Selenium Java

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

public class WindowManagementTest {
    public static void main(String[] args) {
        System.setProperty("webdriver.chrome.driver", "path/to/chromedriver");
        WebDriver driver = new ChromeDriver();

        // Open a website
        driver.get("https://example.com");

        // Maximize the window
        driver.manage().window().maximize();

        // Print the size after maximize
        Dimension maxSize = driver.manage().window().getSize();
        System.out.println("Maximized size: Width = " + maxSize.getWidth() + ", Height = " + maxSize.getHeight());

        // Set window size to 800x600
        driver.manage().window().setSize(new Dimension(800, 600));

        // Print the size after resizing
        Dimension newSize = driver.manage().window().getSize();
        System.out.println("Resized size: Width = " + newSize.getWidth() + ", Height = " + newSize.getHeight());

        // Close the browser
        driver.quit();
    }
}

Important Notes

Make sure the browser driver path is correct before running the test.

Window size values depend on your screen resolution and browser.

Maximize may behave differently on different operating systems.

Summary

Use maximize() to fill the screen with the browser window.

Use setSize() to set a custom window size.

Use getSize() to check the current window size.