v1.63.0

🪟 Locate across frames

page.frameLocator() and frame.frameLocator() called without a selector search in any frame of the
subtree, so you no longer need to locate the iframe first:

// Finds the button in any frame on the page.
page.frameLocator().getByRole(AriaRole.BUTTON).click();

The rest of the locator resolves inside a single frame, just like a regular locator, and an error is thrown when it
matches elements in several frames.

👁️ Visible-only locators

New locator.visible() returns a locator that matches only visible elements. It is the recommended
replacement for the :visible CSS pseudo-class:

page.locator("button").visible().click();

🖼️ Aria and screen snapshots in traces

New ariaSnapshots and screenSnapshots options of
tracing.start() capture an aria snapshot and a screenshot of the page on every action:

context.tracing().start(new Tracing.StartOptions()
  .setSnapshots(true)
  .setAriaSnapshots(true)
  .setScreenSnapshots(true));

With aria and screen snapshots recorded, the new Display Aria mode in the trace viewer shows the action screenshot
side by side with the aria snapshot, and hovering an aria node highlights it on the screenshot.

☕ Nullability annotations

The public API is now annotated with JSpecify nullability annotations. The
com.microsoft.playwright, com.microsoft.playwright.options and com.microsoft.playwright.assertions packages are
@NullMarked, and values that can be absent are marked @Nullable, so null-checking tools such as NullAway, as well as
Kotlin code, can catch missing null checks at compile time.

New APIs

Browser and Context

• httpCredentials now also accepts a list of credentials. The first entry matching the request origin is used, and entries without an origin match any request.
• New option opfs includes the origin private file system in the storage state, so it can be persisted and restored into later contexts.
• New events page.onDialogClosed() and browserContext.onDialogClosed() are emitted when a JavaScript dialog is accepted, dismissed or closed by the user.

Command line

• mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="install --no-remove" keeps the browsers of other Playwright installations instead of removing them.
• mvn exec:java -e -D exec.mainClass=com.microsoft.playwright.CLI -D exec.args="codegen --http-credentials" records against pages behind HTTP authentication.

Announcements

• ⚠️ Ubuntu 20.04 is not supported anymore.
• 🐧 On Linux arm64, Playwright now downloads the Chrome for Testing build of Chromium, the same build used on all other platforms.

Browser Versions

• Chromium 153.0.8010.12
• Mozilla Firefox 155.0
• WebKit 26.6

This version was also tested against the following stable channels:

• Google Chrome 153
• Microsoft Edge 153