Version: 1.10.0

Multi-page scenarios

Playwright can automate scenarios that span multiple browser contexts or multiple tabs in a browser window.

Multiple contexts#

Browser contexts are isolated environments on a single browser instance. Playwright can create multiple browser contexts within a single scenario. This is useful when you want to test for multi-user functionality, like chat.

public class Example {
public static void main(String[] args) {
try (Playwright playwright = Playwright.create()) {
BrowserType chromium = playwright.chromium();
// Create a Chromium browser instance
Browser browser = chromium.launch();
// Create two isolated browser contexts
BrowserContext userContext = browser.newContext();
BrowserContext adminContext = browser.newContext();
// Load user and admin cookies

API reference#

Multiple pages#

Each browser context can host multiple pages (tabs).

  • Each page behaves like a focused, active page. Bringing the page to front is not required.
  • Pages inside a context respect context-level emulation, like viewport sizes, custom network routes or browser locale.
// Create two pages
Page pageOne = context.newPage();
Page pageTwo = context.newPage();
// Get pages of a brower context
List<Page> allPages = context.pages();

API reference#

Handling new pages#

The page event on browser contexts can be used to get new pages that are created in the context. This can be used to handle new pages opened by target="_blank" links.

// Get page after a specific action (e.g. clicking a link)
Page newPage = context.waitForPage(() -> {"a[target='_blank']"); // Opens a new tab

If the action that triggers the new page is unknown, the following pattern can be used.

// Get all new pages (including popups) in the context
context.onPage(page -> {

API reference#

Handling popups#

If the page opens a pop-up, you can get a reference to it by listening to the popup event on the page.

This event is emitted in addition to the browserContext.on('page') event, but only for popups relevant to this page.

// Get popup after a specific action (e.g., click)
Page popup = page.waitForPopup(() -> {"#open");

If the action that triggers the popup is unknown, the following pattern can be used.

// Get all popups when they open
page.onPopup(popup -> {

API reference#