chore: roll to 1.60.0-alpha-1778025033000

Ports the following upstream client-side PRs:

- microsoft/playwright#39767 - feat: Add `location()` to `WebError`
- microsoft/playwright#39950 - feat: page version of toMatchAriaSnapshot
- microsoft/playwright#40083 - feat(locator): add `description` option to getByRole
- microsoft/playwright#40092 - feat(expect): support pseudo-element in toHaveCSS
- microsoft/playwright#40159 - feat(tracing): add tracing.startHar / tracing.stopHar
- microsoft/playwright#40196 - chore: remove deprecated `handle` option from exposeBinding
- microsoft/playwright#40215 - feat(api): Locator.highlight({ style })
- microsoft/playwright#40219 - feat(api): Page.hideHighlight, Locator.hideHighlight, highlight() returns AutoCloseable
- microsoft/playwright#40283 - feat(locator): add drop API for files and clipboard-like data
- microsoft/playwright#40315 - feat(browser): Browser.onContext / offContext
- microsoft/playwright#40341 - feat(browsercontext): mirror Page lifecycle events on BrowserContext
- microsoft/playwright#40377 - feat(route): expose WebSocket subprotocols on WebSocketRoute
- microsoft/playwright#40606 - feat(api): unify WebError and ConsoleMessage location
- microsoft/playwright#40651 - docs: alias drop-payload Object types

Protocol shape change for FrameExpectResult.received (now `{ value, ariaSnapshot }` instead
of a bare SerializedValue) — updated AssertionsBase to unwrap it.

Generator updates: added new types to relevant import lists; share topLevelTypes between
the assertion and non-assertion generate runs so PseudoElement gets emitted into options/.

Author: yury-s

README.md

@@ -10,9 +10,9 @@ Playwright is a Java library to automate [Chromium](https://www.chromium.org/Hom
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->147.0.7727.15<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| Chromium <!-- GEN:chromium-version -->148.0.7778.96<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 | WebKit <!-- GEN:webkit-version -->26.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->148.0.2<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| Firefox <!-- GEN:firefox-version -->150.0.1<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 
 ## Documentation
 

examples/pom.xml

@@ -10,7 +10,7 @@
   <name>Playwright Client Examples</name>
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <playwright.version>1.59.0</playwright.version>
+    <playwright.version>1.60.0</playwright.version>
   </properties>
   <dependencies>
     <dependency>

playwright/src/main/java/com/microsoft/playwright/APIRequestContext.java

@@ -23,24 +23,23 @@
  * This API is used for the Web API testing. You can use it to trigger API endpoints, configure micro-services, prepare
  * environment or the service to your e2e test.
  *
- * <p> Each Playwright browser context has associated with it {@code APIRequestContext} instance which shares cookie storage
- * with the browser context and can be accessed via {@link com.microsoft.playwright.BrowserContext#request
- * BrowserContext.request()} or {@link com.microsoft.playwright.Page#request Page.request()}. It is also possible to create
- * a new APIRequestContext instance manually by calling {@link com.microsoft.playwright.APIRequest#newContext
- * APIRequest.newContext()}.
+ * <p> Each Playwright browser context has an associated {@code APIRequestContext}, accessible via {@link
+ * com.microsoft.playwright.BrowserContext#request BrowserContext.request()} or {@link
+ * com.microsoft.playwright.Page#request Page.request()} (these return the
+ *
+ * <p> **same instance** — {@code page.request} is a shortcut for {@code page.context().request}). You can also create a
+ * standalone, isolated instance with {@link com.microsoft.playwright.APIRequest#newContext APIRequest.newContext()}.
  *
  * <p> <strong>Cookie management</strong>
  *
- * <p> {@code APIRequestContext} returned by {@link com.microsoft.playwright.BrowserContext#request BrowserContext.request()}
- * and {@link com.microsoft.playwright.Page#request Page.request()} shares cookie storage with the corresponding {@code
- * BrowserContext}. Each API request will have {@code Cookie} header populated with the values from the browser context. If
- * the API response contains {@code Set-Cookie} header it will automatically update {@code BrowserContext} cookies and
- * requests made from the page will pick them up. This means that if you log in using this API, your e2e test will be
- * logged in and vice versa.
+ * <p> The {@code APIRequestContext} returned by {@link com.microsoft.playwright.BrowserContext#request
+ * BrowserContext.request()} and
+ *
+ * <p> {@link com.microsoft.playwright.Page#request Page.request()} uses the same cookie jar as its {@code BrowserContext}:
  *
- * <p> If you want API requests to not interfere with the browser cookies you should create a new {@code APIRequestContext} by
- * calling {@link com.microsoft.playwright.APIRequest#newContext APIRequest.newContext()}. Such {@code APIRequestContext}
- * object will have its own isolated cookie storage.
+ * <p> If you want API requests that do **not** share cookies with the browser, create an isolated context via {@link
+ * com.microsoft.playwright.APIRequest#newContext APIRequest.newContext()}. Such {@code APIRequestContext} object will have
+ * its own isolated cookie storage.
  */
 public interface APIRequestContext {
   class DisposeOptions {
@@ -484,5 +483,11 @@ default String storageState() {
    * @since v1.16
    */
   String storageState(StorageStateOptions options);
+  /**
+   *
+   *
+   * @since v1.60
+   */
+  Tracing tracing();
 }
 

playwright/src/main/java/com/microsoft/playwright/Browser.java

@@ -43,6 +43,15 @@
  */
 public interface Browser extends AutoCloseable {
 
+  /**
+   * Emitted when a new browser context is created.
+   */
+  void onContext(Consumer<BrowserContext> handler);
+  /**
+   * Removes handler that was previously added with {@link #onContext onContext(handler)}.
+   */
+  void offContext(Consumer<BrowserContext> handler);
+
   /**
    * Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
    * <ul>

playwright/src/main/java/com/microsoft/playwright/BrowserContext.java

@@ -114,6 +114,48 @@ public interface BrowserContext extends AutoCloseable {
    */
   void offDialog(Consumer<Dialog> handler);
 
+  /**
+   * Emitted when attachment download started in any page belonging to this context. User can access basic file operations on
+   * downloaded content via the passed {@code Download} instance. See also {@link com.microsoft.playwright.Page#onDownload
+   * Page.onDownload()} to receive events about a specific page.
+   */
+  void onDownload(Consumer<Download> handler);
+  /**
+   * Removes handler that was previously added with {@link #onDownload onDownload(handler)}.
+   */
+  void offDownload(Consumer<Download> handler);
+
+  /**
+   * Emitted when a frame is attached in any page belonging to this context. See also {@link
+   * com.microsoft.playwright.Page#onFrameAttached Page.onFrameAttached()} to receive events about a specific page.
+   */
+  void onFrameAttached(Consumer<Frame> handler);
+  /**
+   * Removes handler that was previously added with {@link #onFrameAttached onFrameAttached(handler)}.
+   */
+  void offFrameAttached(Consumer<Frame> handler);
+
+  /**
+   * Emitted when a frame is detached in any page belonging to this context. See also {@link
+   * com.microsoft.playwright.Page#onFrameDetached Page.onFrameDetached()} to receive events about a specific page.
+   */
+  void onFrameDetached(Consumer<Frame> handler);
+  /**
+   * Removes handler that was previously added with {@link #onFrameDetached onFrameDetached(handler)}.
+   */
+  void offFrameDetached(Consumer<Frame> handler);
+
+  /**
+   * Emitted when a frame is navigated to a new url in any page belonging to this context. See also {@link
+   * com.microsoft.playwright.Page#onFrameNavigated Page.onFrameNavigated()} to receive events about navigations in a
+   * specific page.
+   */
+  void onFrameNavigated(Consumer<Frame> handler);
+  /**
+   * Removes handler that was previously added with {@link #onFrameNavigated onFrameNavigated(handler)}.
+   */
+  void offFrameNavigated(Consumer<Frame> handler);
+
   /**
    * The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will
    * also fire for popup pages. See also {@link com.microsoft.playwright.Page#onPopup Page.onPopup()} to receive events about
@@ -141,6 +183,27 @@ public interface BrowserContext extends AutoCloseable {
    */
   void offPage(Consumer<Page> handler);
 
+  /**
+   * Emitted when a page in this context is closed. See also {@link com.microsoft.playwright.Page#onClose Page.onClose()} to
+   * receive events about a specific page.
+   */
+  void onPageClose(Consumer<Page> handler);
+  /**
+   * Removes handler that was previously added with {@link #onPageClose onPageClose(handler)}.
+   */
+  void offPageClose(Consumer<Page> handler);
+
+  /**
+   * Emitted when the JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/Events/load">{@code load}</a> event is
+   * dispatched in any page belonging to this context. See also {@link com.microsoft.playwright.Page#onLoad Page.onLoad()} to
+   * receive events about a specific page.
+   */
+  void onPageLoad(Consumer<Page> handler);
+  /**
+   * Removes handler that was previously added with {@link #onPageLoad onPageLoad(handler)}.
+   */
+  void offPageLoad(Consumer<Page> handler);
+
   /**
    * Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular page,
    * use {@link com.microsoft.playwright.Page#onPageError Page.onPageError()} instead.
@@ -271,20 +334,6 @@ public CloseOptions setReason(String reason) {
       return this;
     }
   }
-  class ExposeBindingOptions {
-    /**
-     * @deprecated This option will be removed in the future.
-     */
-    public Boolean handle;
-
-    /**
-     * @deprecated This option will be removed in the future.
-     */
-    public ExposeBindingOptions setHandle(boolean handle) {
-      this.handle = handle;
-      return this;
-    }
-  }
   class GrantPermissionsOptions {
     /**
      * The [origin] to grant permissions to, e.g. "https://example.com".
@@ -736,54 +785,7 @@ default List<Cookie> cookies() {
    * @param callback Callback function that will be called in the Playwright's context.
    * @since v1.8
    */
-  default AutoCloseable exposeBinding(String name, BindingCallback callback) {
-    return exposeBinding(name, callback, null);
-  }
-  /**
-   * The method adds a function called {@code name} on the {@code window} object of every frame in every page in the context.
-   * When called, the function executes {@code callback} and returns a <a
-   * href='https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise'>Promise</a> which
-   * resolves to the return value of {@code callback}. If the {@code callback} returns a <a
-   * href='https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise'>Promise</a>, it will be
-   * awaited.
-   *
-   * <p> The first argument of the {@code callback} function contains information about the caller: {@code { browserContext:
-   * BrowserContext, page: Page, frame: Frame }}.
-   *
-   * <p> See {@link com.microsoft.playwright.Page#exposeBinding Page.exposeBinding()} for page-only version.
-   *
-   * <p> <strong>Usage</strong>
-   *
-   * <p> An example of exposing page URL to all frames in all pages in the context:
-   * <pre>{@code
-   * import com.microsoft.playwright.*;
-   *
-   * public class Example {
-   *   public static void main(String[] args) {
-   *     try (Playwright playwright = Playwright.create()) {
-   *       BrowserType webkit = playwright.webkit();
-   *       Browser browser = webkit.launch(new BrowserType.LaunchOptions().setHeadless(false));
-   *       BrowserContext context = browser.newContext();
-   *       context.exposeBinding("pageURL", (source, args) -> source.page().url());
-   *       Page page = context.newPage();
-   *       page.setContent("<script>\n" +
-   *         "  async function onClick() {\n" +
-   *         "    document.querySelector('div').textContent = await window.pageURL();\n" +
-   *         "  }\n" +
-   *         "</script>\n" +
-   *         "<button onclick=\"onClick()\">Click me</button>\n" +
-   *         "<div></div>");
-   *       page.getByRole(AriaRole.BUTTON).click();
-   *     }
-   *   }
-   * }
-   * }</pre>
-   *
-   * @param name Name of the function on the window object.
-   * @param callback Callback function that will be called in the Playwright's context.
-   * @since v1.8
-   */
-  AutoCloseable exposeBinding(String name, BindingCallback callback, ExposeBindingOptions options);
+  AutoCloseable exposeBinding(String name, BindingCallback callback);
   /**
    * The method adds a function called {@code name} on the {@code window} object of every frame in every page in the context.
    * When called, the function executes {@code callback} and returns a <a

playwright/src/main/java/com/microsoft/playwright/BrowserType.java

@@ -133,6 +133,15 @@ class ConnectOverCDPOptions {
      * the file system being the same between Playwright and the Browser.
      */
     public Boolean isLocal;
+    /**
+     * When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, {@code
+     * acceptDownloads} is left at the browser's setting, focus emulation is not enabled, and media emulation options (such as
+     * {@code colorScheme}, {@code reducedMotion}, {@code forcedColors}, and {@code contrast}) are not applied. Useful when
+     * attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New
+     * contexts created via {@link com.microsoft.playwright.Browser#newContext Browser.newContext()} are not affected. Defaults
+     * to {@code false}.
+     */
+    public Boolean noDefaults;
     /**
      * Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
      * Defaults to 0.
@@ -159,6 +168,18 @@ public ConnectOverCDPOptions setIsLocal(boolean isLocal) {
       this.isLocal = isLocal;
       return this;
     }
+    /**
+     * When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, {@code
+     * acceptDownloads} is left at the browser's setting, focus emulation is not enabled, and media emulation options (such as
+     * {@code colorScheme}, {@code reducedMotion}, {@code forcedColors}, and {@code contrast}) are not applied. Useful when
+     * attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New
+     * contexts created via {@link com.microsoft.playwright.Browser#newContext Browser.newContext()} are not affected. Defaults
+     * to {@code false}.
+     */
+    public ConnectOverCDPOptions setNoDefaults(boolean noDefaults) {
+      this.noDefaults = noDefaults;
+      return this;
+    }
     /**
      * Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on.
      * Defaults to 0.

playwright/src/main/java/com/microsoft/playwright/Frame.java

@@ -867,6 +867,13 @@ class GetByRoleOptions {
      * <p> Learn more about <a href="https://www.w3.org/TR/wai-aria-1.2/#aria-checked">{@code aria-checked}</a>.
      */
     public Boolean checked;
+    /**
+     * Option to match the <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>. By
+     * default, matching is case-insensitive and searches for a substring, use {@code exact} to control this behavior.
+     *
+     * <p> Learn more about <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+     */
+    public Object description;
     /**
      * An attribute that is usually set by {@code aria-disabled} or {@code disabled}.
      *
@@ -875,8 +882,8 @@ class GetByRoleOptions {
      */
     public Boolean disabled;
     /**
-     * Whether {@code name} is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when {@code name}
-     * is a regular expression. Note that exact match still trims whitespace.
+     * Whether {@code name} and {@code description} are matched exactly: case-sensitive and whole-string. Defaults to false.
+     * Ignored when the value is a regular expression. Note that exact match still trims whitespace.
      */
     public Boolean exact;
     /**
@@ -928,6 +935,26 @@ public GetByRoleOptions setChecked(boolean checked) {
       this.checked = checked;
       return this;
     }
+    /**
+     * Option to match the <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>. By
+     * default, matching is case-insensitive and searches for a substring, use {@code exact} to control this behavior.
+     *
+     * <p> Learn more about <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+     */
+    public GetByRoleOptions setDescription(String description) {
+      this.description = description;
+      return this;
+    }
+    /**
+     * Option to match the <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>. By
+     * default, matching is case-insensitive and searches for a substring, use {@code exact} to control this behavior.
+     *
+     * <p> Learn more about <a href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+     */
+    public GetByRoleOptions setDescription(Pattern description) {
+      this.description = description;
+      return this;
+    }
     /**
      * An attribute that is usually set by {@code aria-disabled} or {@code disabled}.
      *
@@ -939,8 +966,8 @@ public GetByRoleOptions setDisabled(boolean disabled) {
       return this;
     }
     /**
-     * Whether {@code name} is matched exactly: case-sensitive and whole-string. Defaults to false. Ignored when {@code name}
-     * is a regular expression. Note that exact match still trims whitespace.
+     * Whether {@code name} and {@code description} are matched exactly: case-sensitive and whole-string. Defaults to false.
+     * Ignored when the value is a regular expression. Note that exact match still trims whitespace.
      */
     public GetByRoleOptions setExact(boolean exact) {
       this.exact = exact;