chore: set version 1.44.0 (#1578 )

chore: roll 1.44.0 (#1575 )
devops: stop producing .sha256 files, they are not required anymore (#1570 )
2026-05-23 03:03:15 +00:00 · 2024-05-17 09:10:14 -07:00 · 2024-05-08 12:10:05 -07:00 · 2024-05-03 11:03:45 -07:00 · 2024-05-03 10:55:40 -07:00 · 2024-05-03 09:03:41 -07:00
58 changed files with 1401 additions and 200 deletions
@@ -55,27 +55,23 @@ extends:
          env:
            GPG_PASSPHRASE: $(GPG_PASSPHRASE) # secret variable has to be mapped to an env variable
        
-        - bash: |
-            for file in $(find snapshots -type f); do
-              echo "processing: $file"
-              if [[ $file =~ \.(md5|sha1|sha256)$ ]]; then
-                continue
-              fi
-              sha256sum "$file" | cut -f1 -d \ > "$file.sha256"
-            done
-          displayName: 'Create .sha256 files'
-        
-        - task: EsrpRelease@4
+        - task: EsrpRelease@7
          inputs:
-            ConnectedServiceName: 'Playwright-ESRP'
-            Intent: 'PackageDistribution'
-            ContentType: 'Maven'
-            ContentSource: 'Folder'
-            FolderLocation: './local-build'
-            WaitForReleaseCompletion: true
-            Owners: 'yurys@microsoft.com'
-            Approvers: 'maxschmitt@microsoft.com'
-            ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
-            MainPublisher: 'Playwright'
-            DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
+            connectedservicename: 'Playwright-ESRP-Azure'
+            keyvaultname: 'pw-publishing-secrets'
+            authcertname: 'ESRP-Release-Auth'
+            signcertname: 'ESRP-Release-Sign'
+            clientid: '13434a40-7de4-4c23-81a3-d843dc81c2c5'
+            intent: 'PackageDistribution'
+            contenttype: 'Maven'
+            # Keeping it commented out as a workaround for:
+            # https://portal.microsofticm.com/imp/v3/incidents/incident/499972482/summary
+            # contentsource: 'folder'
+            folderlocation: './local-build'
+            waitforreleasecompletion: true
+            owners: 'yurys@microsoft.com'
+            approvers: 'maxschmitt@microsoft.com'
+            serviceendpointurl: 'https://api.esrp.microsoft.com'
+            mainpublisher: 'Playwright'
+            domaintenantid: '72f988bf-86f1-41af-91ab-2d7cd011db47'
          displayName: 'ESRP Release to Maven'
@@ -12,14 +12,21 @@ jobs:
  publish-canary-docker:
    name: publish to DockerHub
    runs-on: ubuntu-22.04
+    permissions:
+      id-token: write   # This is required for OIDC login (azure/login) to succeed
+      contents: read    # This is required for actions/checkout to succeed
+    environment: Docker
    if: github.repository == 'microsoft/playwright-java'
    steps:
    - uses: actions/checkout@v4
-    - uses: azure/docker-login@v1
+    - name: Azure login
+      uses: azure/login@v2
      with:
-        login-server: playwright.azurecr.io
-        username: playwright
-        password: ${{ secrets.DOCKER_PASSWORD }}
+        client-id: ${{ secrets.AZURE_DOCKER_CLIENT_ID }}
+        tenant-id: ${{ secrets.AZURE_DOCKER_TENANT_ID }}
+        subscription-id: ${{ secrets.AZURE_DOCKER_SUBSCRIPTION_ID }}
+    - name: Login to ACR via OIDC
+      run: az acr login --name playwright
    - name: Set up Docker QEMU for arm64 docker builds
      uses: docker/setup-qemu-action@v3
      with:
@@ -11,9 +11,9 @@ Playwright is a Java library to automate [Chromium](https://www.chromium.org/Hom

 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->124.0.6367.29<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| Chromium <!-- GEN:chromium-version -->125.0.6422.26<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
 | WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->124.0<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| Firefox <!-- GEN:firefox-version -->125.0.1<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |

 Headless execution is supported for all the browsers on all platforms. Check out [system requirements](https://playwright.dev/java/docs/intro#system-requirements) for details.

@@ -6,7 +6,7 @@
  <parent>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>parent-pom</artifactId>
-    <version>1.43.0</version>
+    <version>1.44.0</version>
  </parent>

  <artifactId>driver-bundle</artifactId>
@@ -6,7 +6,7 @@
  <parent>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>parent-pom</artifactId>
-    <version>1.43.0</version>
+    <version>1.44.0</version>
  </parent>

  <artifactId>driver</artifactId>
@@ -6,7 +6,7 @@

  <groupId>org.example</groupId>
  <artifactId>examples</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Playwright Client Examples</name>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
@@ -7,7 +7,7 @@
  <parent>
    <groupId>com.microsoft.playwright</groupId>
    <artifactId>parent-pom</artifactId>
-    <version>1.43.0</version>
+    <version>1.44.0</version>
  </parent>

  <artifactId>playwright</artifactId>
@@ -91,10 +91,11 @@ public interface APIRequestContext {
  void dispose();
  /**
   * Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-   * context cookies from the response. The method will automatically follow redirects. JSON objects can be passed directly
-   * to the request.
+   * context cookies from the response. The method will automatically follow redirects.
   *
   * <p> <strong>Usage</strong>
+   *
+   * <p> JSON objects can be passed directly to the request:
   * <pre>{@code
   * Map<String, Object> data = new HashMap();
   * data.put("title", "Book Title");
@@ -102,8 +103,9 @@ public interface APIRequestContext {
   * request.fetch("https://example.com/api/createBook", RequestOptions.create().setMethod("post").setData(data));
   * }</pre>
   *
-   * <p> The common way to send file(s) in the body of a request is to encode it as form fields with {@code multipart/form-data}
-   * encoding. You can achieve that with Playwright API like this:
+   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -114,7 +116,7 @@ public interface APIRequestContext {
   * // Or you can pass the file content directly as FilePayload object:
   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.fetch("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.fetch("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMethod("post").setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -127,10 +129,11 @@ public interface APIRequestContext {
  }
  /**
   * Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-   * context cookies from the response. The method will automatically follow redirects. JSON objects can be passed directly
-   * to the request.
+   * context cookies from the response. The method will automatically follow redirects.
   *
   * <p> <strong>Usage</strong>
+   *
+   * <p> JSON objects can be passed directly to the request:
   * <pre>{@code
   * Map<String, Object> data = new HashMap();
   * data.put("title", "Book Title");
@@ -138,8 +141,9 @@ public interface APIRequestContext {
   * request.fetch("https://example.com/api/createBook", RequestOptions.create().setMethod("post").setData(data));
   * }</pre>
   *
-   * <p> The common way to send file(s) in the body of a request is to encode it as form fields with {@code multipart/form-data}
-   * encoding. You can achieve that with Playwright API like this:
+   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -150,7 +154,7 @@ public interface APIRequestContext {
   * // Or you can pass the file content directly as FilePayload object:
   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.fetch("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.fetch("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMethod("post").setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -162,10 +166,11 @@ public interface APIRequestContext {
  APIResponse fetch(String urlOrRequest, RequestOptions params);
  /**
   * Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-   * context cookies from the response. The method will automatically follow redirects. JSON objects can be passed directly
-   * to the request.
+   * context cookies from the response. The method will automatically follow redirects.
   *
   * <p> <strong>Usage</strong>
+   *
+   * <p> JSON objects can be passed directly to the request:
   * <pre>{@code
   * Map<String, Object> data = new HashMap();
   * data.put("title", "Book Title");
@@ -173,8 +178,9 @@ public interface APIRequestContext {
   * request.fetch("https://example.com/api/createBook", RequestOptions.create().setMethod("post").setData(data));
   * }</pre>
   *
-   * <p> The common way to send file(s) in the body of a request is to encode it as form fields with {@code multipart/form-data}
-   * encoding. You can achieve that with Playwright API like this:
+   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -185,7 +191,7 @@ public interface APIRequestContext {
   * // Or you can pass the file content directly as FilePayload object:
   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.fetch("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.fetch("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMethod("post").setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -198,10 +204,11 @@ public interface APIRequestContext {
  }
  /**
   * Sends HTTP(S) request and returns its response. The method will populate request cookies from the context and update
-   * context cookies from the response. The method will automatically follow redirects. JSON objects can be passed directly
-   * to the request.
+   * context cookies from the response. The method will automatically follow redirects.
   *
   * <p> <strong>Usage</strong>
+   *
+   * <p> JSON objects can be passed directly to the request:
   * <pre>{@code
   * Map<String, Object> data = new HashMap();
   * data.put("title", "Book Title");
@@ -209,8 +216,9 @@ public interface APIRequestContext {
   * request.fetch("https://example.com/api/createBook", RequestOptions.create().setMethod("post").setData(data));
   * }</pre>
   *
-   * <p> The common way to send file(s) in the body of a request is to encode it as form fields with {@code multipart/form-data}
-   * encoding. You can achieve that with Playwright API like this:
+   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -221,7 +229,7 @@ public interface APIRequestContext {
   * // Or you can pass the file content directly as FilePayload object:
   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.fetch("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.fetch("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMethod("post").setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -337,7 +345,8 @@ public interface APIRequestContext {
   * }</pre>
   *
   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
-   * multipart/form-data} encoding. You can achieve that with Playwright API like this:
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -346,9 +355,9 @@ public interface APIRequestContext {
   *     FormData.create().set("fileField", file)));
   *
   * // Or you can pass the file content directly as FilePayload object:
-   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
+   * FilePayload filePayload1 = new FilePayload("f1.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.post("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.post("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -384,7 +393,8 @@ public interface APIRequestContext {
   * }</pre>
   *
   * <p> The common way to send file(s) in the body of a request is to upload them as form fields with {@code
-   * multipart/form-data} encoding. You can achieve that with Playwright API like this:
+   * multipart/form-data} encoding. Use {@code FormData} to construct request body and pass it to the request as {@code
+   * multipart} parameter:
   * <pre>{@code
   * // Pass file path to the form data constructor:
   * Path file = Paths.get("team.csv");
@@ -393,9 +403,9 @@ public interface APIRequestContext {
   *     FormData.create().set("fileField", file)));
   *
   * // Or you can pass the file content directly as FilePayload object:
-   * FilePayload filePayload = new FilePayload("f.js", "text/javascript",
+   * FilePayload filePayload1 = new FilePayload("f1.js", "text/javascript",
   *       "console.log(2022);".getBytes(StandardCharsets.UTF_8));
-   * APIResponse response = request.post("https://example.com/api/uploadTeamList",
+   * APIResponse response = request.post("https://example.com/api/uploadScript",
   *   RequestOptions.create().setMultipart(
   *     FormData.create().set("fileField", filePayload)));
   * }</pre>
@@ -44,6 +44,22 @@ import java.util.regex.Pattern;
 */
 public interface BrowserContext extends AutoCloseable {

+  /**
+   * <strong>NOTE:</strong> Only works with Chromium browser's persistent context.
+   *
+   * <p> Emitted when new background page is created in the context.
+   * <pre>{@code
+   * context.onBackgroundPage(backgroundPage -> {
+   *   System.out.println(backgroundPage.url());
+   * });
+   * }</pre>
+   */
+  void onBackgroundPage(Consumer<Page> handler);
+  /**
+   * Removes handler that was previously added with {@link #onBackgroundPage onBackgroundPage(handler)}.
+   */
+  void offBackgroundPage(Consumer<Page> handler);
+
  /**
   * Emitted when Browser context gets closed. This might happen because of one of the following:
   * <ul>
@@ -111,7 +127,10 @@ public interface BrowserContext extends AutoCloseable {
   *
   * <p> The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
   * popup with {@code window.open('http://example.com')}, this event will fire when the network request to
-   * "http://example.com" is done and its response has started loading in the popup.
+   * "http://example.com" is done and its response has started loading in the popup. If you would like to route/listen to
+   * this network request, use {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} and {@link
+   * com.microsoft.playwright.BrowserContext#onRequest BrowserContext.onRequest()} respectively instead of similar methods on
+   * the {@code Page}.
   * <pre>{@code
   * Page newPage = context.waitForPage(() -> {
   *   page.getByText("open new page").click();
@@ -551,6 +570,14 @@ public interface BrowserContext extends AutoCloseable {
   * @since v1.8
   */
  void addInitScript(Path script);
+  /**
+   * <strong>NOTE:</strong> Background pages are only supported on Chromium-based browsers.
+   *
+   * <p> All existing background pages in the context.
+   *
+   * @since v1.11
+   */
+  List<Page> backgroundPages();
  /**
   * Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
   *
@@ -161,7 +161,8 @@ public interface ElementHandle extends JSHandle {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -220,7 +221,8 @@ public interface ElementHandle extends JSHandle {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public ClickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -286,7 +288,8 @@ public interface ElementHandle extends JSHandle {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -338,7 +341,8 @@ public interface ElementHandle extends JSHandle {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public DblclickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -444,7 +448,8 @@ public interface ElementHandle extends JSHandle {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -482,7 +487,8 @@ public interface ElementHandle extends JSHandle {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public HoverOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -995,7 +1001,8 @@ public interface ElementHandle extends JSHandle {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1033,7 +1040,8 @@ public interface ElementHandle extends JSHandle {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public TapOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1820,7 +1828,7 @@ public interface ElementHandle extends JSHandle {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -1851,7 +1859,7 @@ public interface ElementHandle extends JSHandle {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -266,7 +266,8 @@ public interface Frame {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -330,7 +331,8 @@ public interface Frame {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public ClickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -404,7 +406,8 @@ public interface Frame {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -461,7 +464,8 @@ public interface Frame {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public DblclickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1115,7 +1119,8 @@ public interface Frame {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1158,7 +1163,8 @@ public interface Frame {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public HoverOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1938,7 +1944,8 @@ public interface Frame {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1981,7 +1988,8 @@ public interface Frame {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public TapOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -4082,7 +4090,8 @@ public interface Frame {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -4111,7 +4120,8 @@ public interface Frame {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -4989,6 +4999,9 @@ public interface Frame {
   * <p> This returns when the frame reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * frame.click("button"); // Click triggers navigation.
@@ -5014,6 +5027,9 @@ public interface Frame {
   * <p> This returns when the frame reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * frame.click("button"); // Click triggers navigation.
@@ -5031,6 +5047,9 @@ public interface Frame {
   * <p> This returns when the frame reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * frame.click("button"); // Click triggers navigation.
@@ -97,7 +97,8 @@ public interface Keyboard {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -147,7 +148,8 @@ public interface Keyboard {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -193,7 +195,8 @@ public interface Keyboard {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -220,7 +220,8 @@ public interface Locator {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -279,7 +280,8 @@ public interface Locator {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public ClickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -345,7 +347,8 @@ public interface Locator {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -397,7 +400,8 @@ public interface Locator {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public DblclickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1056,7 +1060,8 @@ public interface Locator {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1094,7 +1099,8 @@ public interface Locator {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public HoverOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1901,7 +1907,8 @@ public interface Locator {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1939,7 +1946,8 @@ public interface Locator {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public TapOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -4186,7 +4194,8 @@ public interface Locator {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -4226,7 +4235,8 @@ public interface Locator {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -242,7 +242,10 @@ public interface Page extends AutoCloseable {
   *
   * <p> The earliest moment that page is available is when it has navigated to the initial url. For example, when opening a
   * popup with {@code window.open('http://example.com')}, this event will fire when the network request to
-   * "http://example.com" is done and its response has started loading in the popup.
+   * "http://example.com" is done and its response has started loading in the popup. If you would like to route/listen to
+   * this network request, use {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} and {@link
+   * com.microsoft.playwright.BrowserContext#onRequest BrowserContext.onRequest()} respectively instead of similar methods on
+   * the {@code Page}.
   * <pre>{@code
   * Page popup = page.waitForPopup(() -> {
   *   page.getByText("open the popup").click();
@@ -533,7 +536,8 @@ public interface Page extends AutoCloseable {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -597,7 +601,8 @@ public interface Page extends AutoCloseable {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public ClickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -698,7 +703,8 @@ public interface Page extends AutoCloseable {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -755,7 +761,8 @@ public interface Page extends AutoCloseable {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public DblclickOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -1578,7 +1585,8 @@ public interface Page extends AutoCloseable {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -1621,7 +1629,8 @@ public interface Page extends AutoCloseable {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public HoverOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -2327,6 +2336,35 @@ public interface Page extends AutoCloseable {
      return this;
    }
  }
+  class AddLocatorHandlerOptions {
+    /**
+     * By default, after calling the handler Playwright will wait until the overlay becomes hidden, and only then Playwright
+     * will continue with the action/assertion that triggered the handler. This option allows to opt-out of this behavior, so
+     * that overlay can stay visible after the handler has run.
+     */
+    public Boolean noWaitAfter;
+    /**
+     * Specifies the maximum number of times this handler should be called. Unlimited by default.
+     */
+    public Integer times;
+
+    /**
+     * By default, after calling the handler Playwright will wait until the overlay becomes hidden, and only then Playwright
+     * will continue with the action/assertion that triggered the handler. This option allows to opt-out of this behavior, so
+     * that overlay can stay visible after the handler has run.
+     */
+    public AddLocatorHandlerOptions setNoWaitAfter(boolean noWaitAfter) {
+      this.noWaitAfter = noWaitAfter;
+      return this;
+    }
+    /**
+     * Specifies the maximum number of times this handler should be called. Unlimited by default.
+     */
+    public AddLocatorHandlerOptions setTimes(int times) {
+      this.times = times;
+      return this;
+    }
+  }
  class ReloadOptions {
    /**
     * Maximum operation time in milliseconds, defaults to 30 seconds, pass {@code 0} to disable timeout. The default value can
@@ -2938,7 +2976,8 @@ public interface Page extends AutoCloseable {
    public Boolean force;
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public List<KeyboardModifier> modifiers;
    /**
@@ -2981,7 +3020,8 @@ public interface Page extends AutoCloseable {
    }
    /**
     * Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current
-     * modifiers back. If not specified, currently pressed modifiers are used.
+     * modifiers back. If not specified, currently pressed modifiers are used. "ControlOrMeta" resolves to "Control" on Windows
+     * and Linux and to "Meta" on macOS.
     */
    public TapOptions setModifiers(List<KeyboardModifier> modifiers) {
      this.modifiers = modifiers;
@@ -5958,7 +5998,8 @@ public interface Page extends AutoCloseable {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -6002,7 +6043,8 @@ public interface Page extends AutoCloseable {
   * ArrowUp}, etc.
   *
   * <p> Following modification shortcuts are also supported: {@code Shift}, {@code Control}, {@code Alt}, {@code Meta}, {@code
-   * ShiftLeft}.
+   * ShiftLeft}, {@code ControlOrMeta}. {@code ControlOrMeta} resolves to {@code Control} on Windows and Linux and to {@code
+   * Meta} on macOS.
   *
   * <p> Holding down {@code Shift} will type the text that corresponds to the {@code key} in the upper case.
   *
@@ -6058,9 +6100,7 @@ public interface Page extends AutoCloseable {
   */
  List<ElementHandle> querySelectorAll(String selector);
  /**
-   * <strong>NOTE:</strong> This method is experimental and its behavior may change in the upcoming releases.
-   *
-   * <p> When testing a web page, sometimes unexpected overlays like a "Sign up" dialog appear and block actions you want to
+   * When testing a web page, sometimes unexpected overlays like a "Sign up" dialog appear and block actions you want to
   * automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making them
   * tricky to handle in automated tests.
   *
@@ -6077,6 +6117,8 @@ public interface Page extends AutoCloseable {
   * assertion check. When overlay is visible, Playwright calls the handler first, and then proceeds with the
   * action/assertion. Note that the handler is only called when you perform an action/assertion - if the overlay becomes
   * visible but you don't perform any actions, the handler will not be triggered.</li>
+   * <li> After executing the handler, Playwright will ensure that overlay that triggered the handler is not visible anymore. You
+   * can opt-out of this behavior with {@code noWaitAfter}.</li>
   * <li> The execution time of the handler counts towards the timeout of the action/assertion that executed the handler. If your
   * handler takes too long, it might cause timeouts.</li>
   * <li> You can register multiple handlers. However, only a single handler will be running at a time. Make sure the actions
@@ -6122,24 +6164,135 @@ public interface Page extends AutoCloseable {
   * }</pre>
   *
   * <p> An example with a custom callback on every actionability check. It uses a {@code <body>} locator that is always visible,
-   * so the handler is called before every actionability check:
+   * so the handler is called before every actionability check. It is important to specify {@code noWaitAfter}, because the
+   * handler does not hide the {@code <body>} element.
   * <pre>{@code
   * // Setup the handler.
   * page.addLocatorHandler(page.locator("body")), () => {
   *   page.evaluate("window.removeObstructionsForTestIfNeeded()");
-   * });
+   * }, new Page.AddLocatorHandlerOptions.setNoWaitAfter(true));
   *
   * // Write the test as usual.
   * page.goto("https://example.com");
   * page.getByRole("button", Page.GetByRoleOptions().setName("Start here")).click();
   * }</pre>
   *
+   * <p> Handler takes the original locator as an argument. You can also automatically remove the handler after a number of
+   * invocations by setting {@code times}:
+   * <pre>{@code
+   * page.addLocatorHandler(page.getByLabel("Close"), locator => {
+   *   locator.click();
+   * }, new Page.AddLocatorHandlerOptions().setTimes(1));
+   * }</pre>
+   *
   * @param locator Locator that triggers the handler.
   * @param handler Function that should be run once {@code locator} appears. This function should get rid of the element that blocks
   * actions like click.
   * @since v1.42
   */
-  void addLocatorHandler(Locator locator, Runnable handler);
+  default void addLocatorHandler(Locator locator, Consumer<Locator> handler) {
+    addLocatorHandler(locator, handler, null);
+  }
+  /**
+   * When testing a web page, sometimes unexpected overlays like a "Sign up" dialog appear and block actions you want to
+   * automate, e.g. clicking a button. These overlays don't always show up in the same way or at the same time, making them
+   * tricky to handle in automated tests.
+   *
+   * <p> This method lets you set up a special function, called a handler, that activates when it detects that overlay is
+   * visible. The handler's job is to remove the overlay, allowing your test to continue as if the overlay wasn't there.
+   *
+   * <p> Things to keep in mind:
+   * <ul>
+   * <li> When an overlay is shown predictably, we recommend explicitly waiting for it in your test and dismissing it as a part of
+   * your normal test flow, instead of using {@link com.microsoft.playwright.Page#addLocatorHandler
+   * Page.addLocatorHandler()}.</li>
+   * <li> Playwright checks for the overlay every time before executing or retrying an action that requires an <a
+   * href="https://playwright.dev/java/docs/actionability">actionability check</a>, or before performing an auto-waiting
+   * assertion check. When overlay is visible, Playwright calls the handler first, and then proceeds with the
+   * action/assertion. Note that the handler is only called when you perform an action/assertion - if the overlay becomes
+   * visible but you don't perform any actions, the handler will not be triggered.</li>
+   * <li> After executing the handler, Playwright will ensure that overlay that triggered the handler is not visible anymore. You
+   * can opt-out of this behavior with {@code noWaitAfter}.</li>
+   * <li> The execution time of the handler counts towards the timeout of the action/assertion that executed the handler. If your
+   * handler takes too long, it might cause timeouts.</li>
+   * <li> You can register multiple handlers. However, only a single handler will be running at a time. Make sure the actions
+   * within a handler don't depend on another handler.</li>
+   * </ul>
+   *
+   * <p> <strong>NOTE:</strong> Running the handler will alter your page state mid-test. For example it will change the currently focused element and
+   * move the mouse. Make sure that actions that run after the handler are self-contained and do not rely on the focus and
+   * mouse state being unchanged. <br /> <br /> For example, consider a test that calls {@link
+   * com.microsoft.playwright.Locator#focus Locator.focus()} followed by {@link com.microsoft.playwright.Keyboard#press
+   * Keyboard.press()}. If your handler clicks a button between these two actions, the focused element most likely will be
+   * wrong, and key press will happen on the unexpected element. Use {@link com.microsoft.playwright.Locator#press
+   * Locator.press()} instead to avoid this problem. <br /> <br /> Another example is a series of mouse actions, where {@link
+   * com.microsoft.playwright.Mouse#move Mouse.move()} is followed by {@link com.microsoft.playwright.Mouse#down
+   * Mouse.down()}. Again, when the handler runs between these two actions, the mouse position will be wrong during the mouse
+   * down. Prefer self-contained actions like {@link com.microsoft.playwright.Locator#click Locator.click()} that do not rely
+   * on the state being unchanged by a handler.
+   *
+   * <p> <strong>Usage</strong>
+   *
+   * <p> An example that closes a "Sign up to the newsletter" dialog when it appears:
+   * <pre>{@code
+   * // Setup the handler.
+   * page.addLocatorHandler(page.getByText("Sign up to the newsletter"), () => {
+   *   page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("No thanks")).click();
+   * });
+   *
+   * // Write the test as usual.
+   * page.goto("https://example.com");
+   * page.getByRole("button", Page.GetByRoleOptions().setName("Start here")).click();
+   * }</pre>
+   *
+   * <p> An example that skips the "Confirm your security details" page when it is shown:
+   * <pre>{@code
+   * // Setup the handler.
+   * page.addLocatorHandler(page.getByText("Confirm your security details")), () => {
+   *   page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Remind me later")).click();
+   * });
+   *
+   * // Write the test as usual.
+   * page.goto("https://example.com");
+   * page.getByRole("button", Page.GetByRoleOptions().setName("Start here")).click();
+   * }</pre>
+   *
+   * <p> An example with a custom callback on every actionability check. It uses a {@code <body>} locator that is always visible,
+   * so the handler is called before every actionability check. It is important to specify {@code noWaitAfter}, because the
+   * handler does not hide the {@code <body>} element.
+   * <pre>{@code
+   * // Setup the handler.
+   * page.addLocatorHandler(page.locator("body")), () => {
+   *   page.evaluate("window.removeObstructionsForTestIfNeeded()");
+   * }, new Page.AddLocatorHandlerOptions.setNoWaitAfter(true));
+   *
+   * // Write the test as usual.
+   * page.goto("https://example.com");
+   * page.getByRole("button", Page.GetByRoleOptions().setName("Start here")).click();
+   * }</pre>
+   *
+   * <p> Handler takes the original locator as an argument. You can also automatically remove the handler after a number of
+   * invocations by setting {@code times}:
+   * <pre>{@code
+   * page.addLocatorHandler(page.getByLabel("Close"), locator => {
+   *   locator.click();
+   * }, new Page.AddLocatorHandlerOptions().setTimes(1));
+   * }</pre>
+   *
+   * @param locator Locator that triggers the handler.
+   * @param handler Function that should be run once {@code locator} appears. This function should get rid of the element that blocks
+   * actions like click.
+   * @since v1.42
+   */
+  void addLocatorHandler(Locator locator, Consumer<Locator> handler, AddLocatorHandlerOptions options);
+  /**
+   * Removes all locator handlers added by {@link com.microsoft.playwright.Page#addLocatorHandler Page.addLocatorHandler()}
+   * for a specific locator.
+   *
+   * @param locator Locator passed to {@link com.microsoft.playwright.Page#addLocatorHandler Page.addLocatorHandler()}.
+   * @since v1.44
+   */
+  void removeLocatorHandler(Locator locator);
  /**
   * This method reloads the current page, in the same way as if the user had triggered a browser refresh. Returns the main
   * resource response. In case of multiple redirects, the navigation will resolve with the response of the last redirect.
@@ -6175,6 +6328,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -6231,6 +6387,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -6285,6 +6444,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -6341,6 +6503,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -6395,6 +6560,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -6451,6 +6619,9 @@ public interface Page extends AutoCloseable {
   * <a href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers
   * when using request interception by setting {@code Browser.newContext.serviceWorkers} to {@code "block"}.
   *
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#route Page.route()} will not intercept the first request of a popup page. Use
+   * {@link com.microsoft.playwright.BrowserContext#route BrowserContext.route()} instead.
+   *
   * <p> <strong>Usage</strong>
   *
   * <p> An example of a naive handler that aborts all image requests:
@@ -7588,6 +7759,9 @@ public interface Page extends AutoCloseable {
   * <p> This resolves when the page reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * page.getByRole(AriaRole.BUTTON).click(); // Click triggers navigation.
@@ -7621,6 +7795,9 @@ public interface Page extends AutoCloseable {
   * <p> This resolves when the page reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * page.getByRole(AriaRole.BUTTON).click(); // Click triggers navigation.
@@ -7646,6 +7823,9 @@ public interface Page extends AutoCloseable {
   * <p> This resolves when the page reaches a required load state, {@code load} by default. The navigation must have been
   * committed when this method is called. If current document has already reached the required state, resolves immediately.
   *
+   * <p> <strong>NOTE:</strong> Most of the time, this method is not needed because Playwright <a
+   * href="https://playwright.dev/java/docs/actionability">auto-waits before every action</a>.
+   *
   * <p> <strong>Usage</strong>
   * <pre>{@code
   * page.getByRole(AriaRole.BUTTON).click(); // Click triggers navigation.
@@ -17,6 +17,7 @@
 package com.microsoft.playwright.assertions;

 import java.util.regex.Pattern;
+import com.microsoft.playwright.options.AriaRole;

 /**
 * The {@code LocatorAssertions} class provides assertion methods that can be used to make assertions about the {@code
@@ -253,6 +254,60 @@ public interface LocatorAssertions {
      return this;
    }
  }
+  class HasAccessibleDescriptionOptions {
+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public Boolean ignoreCase;
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public Double timeout;
+
+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public HasAccessibleDescriptionOptions setIgnoreCase(boolean ignoreCase) {
+      this.ignoreCase = ignoreCase;
+      return this;
+    }
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public HasAccessibleDescriptionOptions setTimeout(double timeout) {
+      this.timeout = timeout;
+      return this;
+    }
+  }
+  class HasAccessibleNameOptions {
+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public Boolean ignoreCase;
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public Double timeout;
+
+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public HasAccessibleNameOptions setIgnoreCase(boolean ignoreCase) {
+      this.ignoreCase = ignoreCase;
+      return this;
+    }
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public HasAccessibleNameOptions setTimeout(double timeout) {
+      this.timeout = timeout;
+      return this;
+    }
+  }
  class HasAttributeOptions {
    /**
     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
@@ -350,6 +405,20 @@ public interface LocatorAssertions {
      return this;
    }
  }
+  class HasRoleOptions {
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public Double timeout;
+
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
+     */
+    public HasRoleOptions setTimeout(double timeout) {
+      this.timeout = timeout;
+      return this;
+    }
+  }
  class HasTextOptions {
    /**
     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
@@ -1076,6 +1145,126 @@ public interface LocatorAssertions {
   * @since v1.20
   */
  void containsText(Pattern[] expected, ContainsTextOptions options);
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleDescription("Save results to disk");
+   * }</pre>
+   *
+   * @param description Expected accessible description.
+   * @since v1.44
+   */
+  default void hasAccessibleDescription(String description) {
+    hasAccessibleDescription(description, null);
+  }
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleDescription("Save results to disk");
+   * }</pre>
+   *
+   * @param description Expected accessible description.
+   * @since v1.44
+   */
+  void hasAccessibleDescription(String description, HasAccessibleDescriptionOptions options);
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleDescription("Save results to disk");
+   * }</pre>
+   *
+   * @param description Expected accessible description.
+   * @since v1.44
+   */
+  default void hasAccessibleDescription(Pattern description) {
+    hasAccessibleDescription(description, null);
+  }
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-description">accessible description</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleDescription("Save results to disk");
+   * }</pre>
+   *
+   * @param description Expected accessible description.
+   * @since v1.44
+   */
+  void hasAccessibleDescription(Pattern description, HasAccessibleDescriptionOptions options);
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-name">accessible name</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleName("Save to disk");
+   * }</pre>
+   *
+   * @param name Expected accessible name.
+   * @since v1.44
+   */
+  default void hasAccessibleName(String name) {
+    hasAccessibleName(name, null);
+  }
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-name">accessible name</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleName("Save to disk");
+   * }</pre>
+   *
+   * @param name Expected accessible name.
+   * @since v1.44
+   */
+  void hasAccessibleName(String name, HasAccessibleNameOptions options);
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-name">accessible name</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleName("Save to disk");
+   * }</pre>
+   *
+   * @param name Expected accessible name.
+   * @since v1.44
+   */
+  default void hasAccessibleName(Pattern name) {
+    hasAccessibleName(name, null);
+  }
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a
+   * href="https://w3c.github.io/accname/#dfn-accessible-name">accessible name</a>.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasAccessibleName("Save to disk");
+   * }</pre>
+   *
+   * @param name Expected accessible name.
+   * @since v1.44
+   */
+  void hasAccessibleName(Pattern name, HasAccessibleNameOptions options);
  /**
   * Ensures the {@code Locator} points to an element with given attribute.
   *
@@ -1456,6 +1645,42 @@ public interface LocatorAssertions {
   * @since v1.20
   */
  void hasJSProperty(String name, Object value, HasJSPropertyOptions options);
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a href="https://www.w3.org/TR/wai-aria-1.2/#roles">ARIA
+   * role</a>.
+   *
+   * <p> Note that role is matched as a string, disregarding the ARIA role hierarchy. For example, asserting  a superclass role
+   * {@code "checkbox"} on an element with a subclass role {@code "switch"} will fail.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasRole(AriaRole.BUTTON);
+   * }</pre>
+   *
+   * @param role Required aria role.
+   * @since v1.44
+   */
+  default void hasRole(AriaRole role) {
+    hasRole(role, null);
+  }
+  /**
+   * Ensures the {@code Locator} points to an element with a given <a href="https://www.w3.org/TR/wai-aria-1.2/#roles">ARIA
+   * role</a>.
+   *
+   * <p> Note that role is matched as a string, disregarding the ARIA role hierarchy. For example, asserting  a superclass role
+   * {@code "checkbox"} on an element with a subclass role {@code "switch"} will fail.
+   *
+   * <p> <strong>Usage</strong>
+   * <pre>{@code
+   * Locator locator = page.getByTestId("save-button");
+   * assertThat(locator).hasRole(AriaRole.BUTTON);
+   * }</pre>
+   *
+   * @param role Required aria role.
+   * @since v1.44
+   */
+  void hasRole(AriaRole role, HasRoleOptions options);
  /**
   * Ensures the {@code Locator} points to an element with the given text. All nested elements will be considered when
   * computing the text content of the element. You can use regular expressions for the value as well.
@@ -52,11 +52,24 @@ public interface PageAssertions {
    }
  }
  class HasURLOptions {
+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public Boolean ignoreCase;
    /**
     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
     */
    public Double timeout;

+    /**
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public HasURLOptions setIgnoreCase(boolean ignoreCase) {
+      this.ignoreCase = ignoreCase;
+      return this;
+    }
    /**
     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
     */
@@ -29,6 +29,7 @@ import java.nio.charset.StandardCharsets;
 import java.nio.file.Path;
 import java.util.Base64;
 import java.util.LinkedHashMap;
+import java.util.List;
 import java.util.Map;

 import static com.microsoft.playwright.impl.Serialization.*;
@@ -86,7 +87,7 @@ class APIRequestContextImpl extends ChannelOwner implements APIRequestContext {
      for (Map.Entry<String, ?> e : options.params.entrySet()) {
        queryParams.put(e.getKey(), "" + e.getValue());
      }
-      params.add("params", toNameValueArray(queryParams));
+      params.add("params", toNameValueArray(queryParams.entrySet()));
    }
    if (options.method != null) {
      params.addProperty("method", options.method);
@@ -149,9 +150,9 @@ class APIRequestContextImpl extends ChannelOwner implements APIRequestContext {
    return false;
  }

-  private static JsonArray serializeMultipartData(Map<String, Object> data) {
+  private static JsonArray serializeMultipartData(List<? extends Map.Entry<String, Object>> data) {
    JsonArray result = new JsonArray();
-    for (Map.Entry<String, Object> e : data.entrySet()) {
+    for (Map.Entry<String, ?> e : data) {
      FilePayload filePayload = null;
      if (e.getValue() instanceof FilePayload) {
        filePayload = (FilePayload) e.getValue();
@@ -20,6 +20,7 @@ import com.microsoft.playwright.PlaywrightException;
 import org.opentest4j.AssertionFailedError;
 import org.opentest4j.ValueWrapper;

+import java.lang.reflect.Field;
 import java.util.Collection;
 import java.util.List;
 import java.util.regex.Pattern;
@@ -91,4 +92,17 @@ class AssertionsBase {
    }
    return expected;
  }
+
+  static Boolean shouldIgnoreCase(Object options) {
+    if (options == null) {
+      return null;
+    }
+    try {
+      Field fromField = options.getClass().getDeclaredField("ignoreCase");
+      Object value = fromField.get(options);
+      return (Boolean) value;
+    } catch (NoSuchFieldException | IllegalAccessException e) {
+      return null;
+    }
+  }
 }
@@ -47,6 +47,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
  private final TracingImpl tracing;
  private final APIRequestContextImpl request;
  final List<PageImpl> pages = new ArrayList<>();
+  final List<PageImpl> backgroundPages = new ArrayList<>();

  final Router routes = new Router();
  private boolean closeWasCalled;
@@ -82,6 +83,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
  }

  enum EventType {
+    BACKGROUNDPAGE,
    CLOSE,
    CONSOLE,
    DIALOG,
@@ -129,6 +131,16 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
    return null;
  }

+  @Override
+  public void onBackgroundPage(Consumer<Page> handler) {
+    listeners.add(EventType.BACKGROUNDPAGE, handler);
+  }
+
+  @Override
+  public void offBackgroundPage(Consumer<Page> handler) {
+    listeners.remove(EventType.BACKGROUNDPAGE, handler);
+  }
+
  @Override
  public void onClose(Consumer<BrowserContext> handler) {
    listeners.add(EventType.CLOSE, handler);
@@ -325,6 +337,11 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
    });
  }

+  @Override
+  public List<Page> backgroundPages() {
+    return new ArrayList<>(backgroundPages);
+  }
+
  private void addInitScriptImpl(String script) {
    JsonObject params = new JsonObject();
    params.addProperty("source", script);
@@ -713,6 +730,10 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
      if (page.opener() != null && !page.opener().isClosed()) {
        page.opener().notifyPopup(page);
      }
+    } else if ("backgroundPage".equals(event)) {
+      PageImpl page = connection.getExistingObject(params.getAsJsonObject("page").get("guid").getAsString());
+      backgroundPages.add(page);
+      listeners.notify(EventType.BACKGROUNDPAGE, page);
    } else if ("bindingCall".equals(event)) {
      BindingCall bindingCall = connection.getExistingObject(params.getAsJsonObject("binding").get("guid").getAsString());
      BindingCallback binding = bindings.get(bindingCall.name());
@@ -35,7 +35,10 @@ public class CDPSessionImpl extends ChannelOwner implements CDPSession {
    super.handleEvent(event, parameters);
    if ("event".equals(event)) {
      String method = parameters.get("method").getAsString();
-      JsonObject params = parameters.get("params").getAsJsonObject();
+      JsonObject params = null;
+      if (parameters.has("params")) {
+        params = parameters.get("params").getAsJsonObject();
+      }
      listeners.notify(method, params);
    }
  }
@@ -20,39 +20,93 @@ import com.microsoft.playwright.options.FilePayload;
 import com.microsoft.playwright.options.FormData;

 import java.nio.file.Path;
-import java.util.LinkedHashMap;
-import java.util.Map;
+import java.util.*;
+import java.util.stream.Collectors;

 public class FormDataImpl implements FormData {
-  Map<String, Object> fields = new LinkedHashMap<>();
+  static class Field implements Map.Entry<String, Object> {
+    final String name;
+    final Object value;
+
+    private Field(String name, Object value) {
+        this.name = name;
+        this.value = value;
+    }
+
+    @Override
+    public String getKey() {
+      return name;
+    }
+
+    @Override
+    public Object getValue() {
+      return value;
+    }
+
+    @Override
+    public Object setValue(Object value) {
+      throw new UnsupportedOperationException();
+    }
+  }
+  List<Field> fields = new ArrayList();
+
+  @Override
+  public FormData append(String name, String value) {
+    return appendImpl(name, value);
+  }
+
+  @Override
+  public FormData append(String name, boolean value) {
+    return appendImpl(name, value);
+  }
+
+  @Override
+  public FormData append(String name, int value) {
+    return appendImpl(name, value);
+  }
+
+  @Override
+  public FormData append(String name, Path value) {
+    return appendImpl(name, value);
+  }
+
+  @Override
+  public FormData append(String name, FilePayload value) {
+    return appendImpl(name, value);
+  }

  @Override
  public FormData set(String name, String value) {
-    fields.put(name, value);
-    return this;
+    return setImpl(name, value);
  }

  @Override
  public FormData set(String name, boolean value) {
-    fields.put(name, value);
-    return this;
+    return setImpl(name, value);
  }

  @Override
  public FormData set(String name, int value) {
-    fields.put(name, value);
-    return this;
+    return setImpl(name, value);
  }

  @Override
  public FormData set(String name, Path value) {
-    fields.put(name, value);
-    return this;
+    return setImpl(name, value);
  }

  @Override
  public FormData set(String name, FilePayload value) {
-    fields.put(name, value);
+    return setImpl(name, value);
+  }
+
+  private FormData setImpl(String name, Object value) {
+    fields = fields.stream().filter(f -> !name.equals(f.name)).collect(Collectors.toList());
+    return appendImpl(name, value);
+  }
+
+  private FormData appendImpl(String name, Object value) {
+    fields.add(new Field(name, value));
    return this;
  }
 }
@@ -33,6 +33,7 @@ class JsonPipe extends ChannelOwner implements Transport {
  private ListenerCollection<EventType> listeners = new ListenerCollection<>();
  private enum EventType { CLOSE }
  private boolean isClosed;
+  private String closeReason = "Browser has been closed";

  JsonPipe(ChannelOwner parent, String type, String guid, JsonObject initializer) {
    super(parent, type, guid, initializer);
@@ -97,13 +98,19 @@ class JsonPipe extends ChannelOwner implements Transport {
      incoming.add(params.get("message").getAsJsonObject());
    } else if ("closed".equals(event)) {
      isClosed = true;
+      if (params.has("reason")) {
+        String reason = params.get("reason").getAsString();
+        if (reason.trim().length() > 0) {
+          closeReason = reason;
+        }
+      }
      listeners.notify(EventType.CLOSE, this);
    }
  }

  private void checkIfClosed() {
    if (isClosed) {
-      throw new PlaywrightException("Browser has been closed");
+      throw new PlaywrightException(closeReason);
    }
  }
 }
@@ -18,6 +18,7 @@ package com.microsoft.playwright.impl;

 import com.microsoft.playwright.Locator;
 import com.microsoft.playwright.assertions.LocatorAssertions;
+import com.microsoft.playwright.options.AriaRole;

 import java.lang.reflect.Field;
 import java.util.ArrayList;
@@ -82,6 +83,36 @@ public class LocatorAssertionsImpl extends AssertionsBase implements LocatorAsse
    expectImpl("to.contain.text.array", list, patterns, "Locator expected to contain text", convertType(options, FrameExpectOptions.class));
  }

+  @Override
+  public void hasAccessibleDescription(String description, HasAccessibleDescriptionOptions options) {
+    ExpectedTextValue expected = new ExpectedTextValue();
+    expected.string = description;
+    expected.ignoreCase = shouldIgnoreCase(options);
+    expectImpl("to.have.accessible.description", expected, description, "Locator expected to have accessible description", convertType(options, FrameExpectOptions.class));
+  }
+
+  @Override
+  public void hasAccessibleDescription(Pattern pattern, HasAccessibleDescriptionOptions options) {
+    ExpectedTextValue expected = expectedRegex(pattern);
+    expected.ignoreCase = shouldIgnoreCase(options);
+    expectImpl("to.have.accessible.description", expected, pattern, "Locator expected to have accessible description", convertType(options, FrameExpectOptions.class));
+  }
+
+  @Override
+  public void hasAccessibleName(String name, HasAccessibleNameOptions options) {
+    ExpectedTextValue expected = new ExpectedTextValue();
+    expected.string = name;
+    expected.ignoreCase = shouldIgnoreCase(options);
+    expectImpl("to.have.accessible.name", expected, name, "Locator expected to have accessible name", convertType(options, FrameExpectOptions.class));
+  }
+
+  @Override
+  public void hasAccessibleName(Pattern pattern, HasAccessibleNameOptions options) {
+    ExpectedTextValue expected = expectedRegex(pattern);
+    expected.ignoreCase = shouldIgnoreCase(options);
+    expectImpl("to.have.accessible.name", expected, pattern, "Locator expected to have accessible name", convertType(options, FrameExpectOptions.class));
+  }
+
  @Override
  public void hasAttribute(String name, String text, HasAttributeOptions options) {
    ExpectedTextValue expected = new ExpectedTextValue();
@@ -206,6 +237,13 @@ public class LocatorAssertionsImpl extends AssertionsBase implements LocatorAsse
    expectImpl("to.have.property", list, value, "Locator expected to have JavaScript property '" + name + "'", commonOptions);
  }

+  @Override
+  public void hasRole(AriaRole role, HasRoleOptions options) {
+    ExpectedTextValue expected = new ExpectedTextValue();
+    expected.string = role.toString().toLowerCase();
+    expectImpl("to.have.role", expected, expected.string, "Locator expected to have role", convertType(options, FrameExpectOptions.class));
+  }
+
  @Override
  public void hasText(String text, HasTextOptions options) {
    ExpectedTextValue expected = new ExpectedTextValue();
@@ -366,17 +404,4 @@ public class LocatorAssertionsImpl extends AssertionsBase implements LocatorAsse
    String message = "Locator expected to be " + (attached ? "attached" : "detached");
    expectTrue(attached ? "to.be.attached" : "to.be.detached", message, frameOptions);
  }
-
-  private static Boolean shouldIgnoreCase(Object options) {
-    if (options == null) {
-      return null;
-    }
-    try {
-      Field fromField = options.getClass().getDeclaredField("ignoreCase");
-      Object value = fromField.get(options);
-      return (Boolean) value;
-    } catch (NoSuchFieldException | IllegalAccessException e) {
-      return null;
-    }
-  }
 }
@@ -624,6 +624,20 @@ class LocatorImpl implements Locator {
    return "Locator@" + selector;
  }

+  @Override
+  public boolean equals(Object obj) {
+    if (!(obj instanceof LocatorImpl)) {
+      return false;
+    }
+    LocatorImpl locator = (LocatorImpl) obj;
+    return  frame.equals(locator.frame) && selector.equals(locator.selector);
+  }
+
+  @Override
+  public int hashCode() {
+    return frame.hashCode() ^ selector.hashCode();
+  }
+
  FrameExpectResult expect(String expression, FrameExpectOptions options) {
    return frame.withLogging("Locator.expect", () -> expectImpl(expression, options));
  }
@@ -21,6 +21,7 @@ import com.microsoft.playwright.assertions.PageAssertions;

 import java.util.regex.Pattern;

+import static com.microsoft.playwright.impl.LocatorAssertionsImpl.shouldIgnoreCase;
 import static com.microsoft.playwright.impl.UrlMatcher.resolveUrl;
 import static com.microsoft.playwright.impl.Utils.convertType;

@@ -57,6 +58,7 @@ public class PageAssertionsImpl extends AssertionsBase implements PageAssertions
      url = resolveUrl(actualPage.context().baseUrl, url);
    }
    expected.string = url;
+    expected.ignoreCase = shouldIgnoreCase(options);
    expectImpl("to.have.url", expected, url, "Page URL expected to be", convertType(options, FrameExpectOptions.class));
  }

@@ -49,7 +49,34 @@ public class PageImpl extends ChannelOwner implements Page {
  private ViewportSize viewport;
  private final Router routes = new Router();
  private final Set<FrameImpl> frames = new LinkedHashSet<>();
-  private final Map<Integer, Runnable> locatorHandlers = new HashMap<>();
+  private final Map<Integer, LocatorHandler> locatorHandlers = new HashMap<>();
+
+  private static class LocatorHandler {
+    private final Locator locator;
+    private final Consumer<Locator> handler;
+    private Integer times;
+
+    LocatorHandler(Locator locator, Consumer<Locator> handler, Integer times) {
+      this.locator = locator;
+      this.handler = handler;
+      this.times = times;
+    }
+
+    boolean call() {
+      if (shouldRemove()) {
+        return true;
+      }
+      if (times != null) {
+        --times;
+      }
+      handler.accept(locator);
+      return shouldRemove();
+    }
+
+    private boolean shouldRemove() {
+      return times != null && times == 0;
+    }
+  }

  private static final Map<EventType, String> eventSubscriptions() {
    Map<EventType, String> result = new HashMap<>();
@@ -203,6 +230,7 @@ public class PageImpl extends ChannelOwner implements Page {
  void didClose() {
    isClosed = true;
    browserContext.pages.remove(this);
+    browserContext.backgroundPages.remove(this);
    listeners.notify(EventType.CLOSE, this);
  }

@@ -529,29 +557,58 @@ public class PageImpl extends ChannelOwner implements Page {
  }

  @Override
-  public void addLocatorHandler(Locator locator, Runnable handler) {
+  public void addLocatorHandler(Locator locator, Consumer<Locator> handler, AddLocatorHandlerOptions options) {
    LocatorImpl locatorImpl = (LocatorImpl) locator;
    if (locatorImpl.frame != mainFrame) {
      throw new PlaywrightException("Locator must belong to the main frame of this page");
    }
+    if (options == null) {
+      options = new AddLocatorHandlerOptions();
+    }
+    if (options.times != null && options.times == 0) {
+      return;
+    }
+    AddLocatorHandlerOptions finalOptions = options;
    withLogging("Page.addLocatorHandler", () -> {
      JsonObject params = new JsonObject();
      params.addProperty("selector", locatorImpl.selector);
+      if (finalOptions.noWaitAfter != null && finalOptions.noWaitAfter) {
+        params.addProperty("noWaitAfter", true);
+      }
+      params.addProperty("selector", locatorImpl.selector);
      JsonObject json = (JsonObject) sendMessage("registerLocatorHandler", params);
      int uid = json.get("uid").getAsInt();
-      locatorHandlers.put(uid, handler);
+      locatorHandlers.put(uid, new LocatorHandler(locator, handler, finalOptions.times));
    });
  }

-  private void onLocatorHandlerTriggered(int uid) {
-    try {
-      Runnable handler = locatorHandlers.get(uid);
-      if (handler != null) {
-        handler.run();
+  @Override
+  public void removeLocatorHandler(Locator locator) {
+    for (Map.Entry<Integer, LocatorHandler> entry: locatorHandlers.entrySet()) {
+      if (entry.getValue().locator.equals(locator)) {
+        locatorHandlers.remove(locator);
+        JsonObject params = new JsonObject();
+        params.addProperty("uid", entry.getKey());
+        try {
+          sendMessage("unregisterLocatorHandler", params);
+        } catch (PlaywrightException e) {
+        }
      }
+    }
+  }
+
+  private void onLocatorHandlerTriggered(int uid) {
+    boolean remove = false;
+    try {
+      LocatorHandler handler = locatorHandlers.get(uid);
+      remove = handler != null && handler.call();
    } finally {
+      if (remove) {
+        locatorHandlers.remove(uid);
+      }
      JsonObject params = new JsonObject();
      params.addProperty("uid", uid);
+      params.addProperty("remove", remove);
      sendMessageAsync("resolveLocatorHandlerNoReply", params);
    }
  }
@@ -351,7 +351,7 @@ class Serialization {
        throw new PlaywrightException("Value cannot be null");
      }
    }
-    return toNameValueArray(map);
+    return toNameValueArray(map.entrySet());
  }

  static void addHarUrlFilter(JsonObject options, Object urlFilter) {
@@ -364,9 +364,9 @@ class Serialization {
      }
  }

-  static JsonArray toNameValueArray(Map<String, ?> map) {
+  static JsonArray toNameValueArray(Iterable<? extends Map.Entry<String, ?>> collection) {
    JsonArray array = new JsonArray();
-    for (Map.Entry<String, ?> e : map.entrySet()) {
+    for (Map.Entry<String, ?> e : collection) {
      JsonObject item = new JsonObject();
      item.addProperty("name", e.getKey());
      if (e.getValue() instanceof FilePayload) {
@@ -62,7 +62,7 @@ public class BrowserExtension implements ParameterResolver, AfterAllCallback {

    Options options = OptionsExtension.getOptions(extensionContext);
    Playwright playwright = PlaywrightExtension.getOrCreatePlaywright(extensionContext);
-    BrowserType.LaunchOptions launchOptions = getLaunchOptions(options);
+

    BrowserType browserType = playwright.chromium();
    if (options.browserName != null) {
@@ -73,12 +73,27 @@ public class BrowserExtension implements ParameterResolver, AfterAllCallback {
          browserType = getBrowserTypeForName(playwright, deviceDescriptor.defaultBrowserType);
      }
    }
-    browser = browserType.launch(launchOptions);
+
+    if(options.wsEndpoint != null && !options.wsEndpoint.isEmpty()) {
+      BrowserType.ConnectOptions connectOptions = getConnectOptions(options);
+      browser = browserType.connect(options.wsEndpoint, connectOptions);
+    } else {
+      BrowserType.LaunchOptions launchOptions = getLaunchOptions(options);
+      browser = browserType.launch(launchOptions);
+    }

    threadLocalBrowser.set(browser);
    return browser;
  }

+  private static BrowserType.ConnectOptions getConnectOptions(Options options) {
+    BrowserType.ConnectOptions connectOptions = options.connectOptions;
+    if(connectOptions == null) {
+      connectOptions = new BrowserType.ConnectOptions();
+    }
+    return connectOptions;
+  }
+
  private static BrowserType getBrowserTypeForName(Playwright playwright, String name) {
    switch (name) {
      case "webkit":
@@ -43,6 +43,20 @@ public class Options {
  public Browser.NewContextOptions contextOptions;
  public APIRequest.NewContextOptions apiRequestOptions;
  public Playwright.CreateOptions playwrightCreateOptions;
+  // WebSocket endpoint to be used when connecting to a remote browser.
+  // If this is set, BrowserType.connect will be used.  Otherwise, BrowserType.launch will be used.
+  public String wsEndpoint;
+  public BrowserType.ConnectOptions connectOptions;
+
+  public Options setWsEndpoint(String wsEndpoint) {
+    this.wsEndpoint = wsEndpoint;
+    return this;
+  }
+
+  public Options setConnectOptions(BrowserType.ConnectOptions connectOptions) {
+    this.connectOptions = connectOptions;
+    return this;
+  }

  public Options setPlaywrightCreateOptions(Playwright.CreateOptions playwrightCreateOptions) {
    this.playwrightCreateOptions = playwrightCreateOptions;
@@ -32,6 +32,141 @@ import java.nio.file.Path;
 * }</pre>
 */
 public interface FormData {
+  /**
+   * Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist. File
+   * values can be passed either as {@code Path} or as {@code FilePayload}. Multiple fields with the same name can be added.
+   *
+   * <p> The difference between {@link com.microsoft.playwright.FormData#set FormData.set()} and {@link
+   * com.microsoft.playwright.FormData#append FormData.append()} is that if the specified key already exists, {@link
+   * com.microsoft.playwright.FormData#set FormData.set()} will overwrite all existing values with the new one, whereas
+   * {@link com.microsoft.playwright.FormData#append FormData.append()} will append the new value onto the end of the
+   * existing set of values.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .append("firstName", "John")
+   *     // Name and value are set, filename and Content-Type are inferred from the file path.
+   *     .append("attachment", Paths.get("pic.jpg"))
+   *     // Name, value, filename and Content-Type are set.
+   *     .append("attachment", new FilePayload("table.csv", "text/csv", Files.readAllBytes(Paths.get("my-tble.csv"))));
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
+   *
+   * @param name Field name.
+   * @param value Field value.
+   * @since v1.44
+   */
+  FormData append(String name, String value);
+  /**
+   * Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist. File
+   * values can be passed either as {@code Path} or as {@code FilePayload}. Multiple fields with the same name can be added.
+   *
+   * <p> The difference between {@link com.microsoft.playwright.FormData#set FormData.set()} and {@link
+   * com.microsoft.playwright.FormData#append FormData.append()} is that if the specified key already exists, {@link
+   * com.microsoft.playwright.FormData#set FormData.set()} will overwrite all existing values with the new one, whereas
+   * {@link com.microsoft.playwright.FormData#append FormData.append()} will append the new value onto the end of the
+   * existing set of values.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .append("firstName", "John")
+   *     // Name and value are set, filename and Content-Type are inferred from the file path.
+   *     .append("attachment", Paths.get("pic.jpg"))
+   *     // Name, value, filename and Content-Type are set.
+   *     .append("attachment", new FilePayload("table.csv", "text/csv", Files.readAllBytes(Paths.get("my-tble.csv"))));
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
+   *
+   * @param name Field name.
+   * @param value Field value.
+   * @since v1.44
+   */
+  FormData append(String name, boolean value);
+  /**
+   * Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist. File
+   * values can be passed either as {@code Path} or as {@code FilePayload}. Multiple fields with the same name can be added.
+   *
+   * <p> The difference between {@link com.microsoft.playwright.FormData#set FormData.set()} and {@link
+   * com.microsoft.playwright.FormData#append FormData.append()} is that if the specified key already exists, {@link
+   * com.microsoft.playwright.FormData#set FormData.set()} will overwrite all existing values with the new one, whereas
+   * {@link com.microsoft.playwright.FormData#append FormData.append()} will append the new value onto the end of the
+   * existing set of values.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .append("firstName", "John")
+   *     // Name and value are set, filename and Content-Type are inferred from the file path.
+   *     .append("attachment", Paths.get("pic.jpg"))
+   *     // Name, value, filename and Content-Type are set.
+   *     .append("attachment", new FilePayload("table.csv", "text/csv", Files.readAllBytes(Paths.get("my-tble.csv"))));
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
+   *
+   * @param name Field name.
+   * @param value Field value.
+   * @since v1.44
+   */
+  FormData append(String name, int value);
+  /**
+   * Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist. File
+   * values can be passed either as {@code Path} or as {@code FilePayload}. Multiple fields with the same name can be added.
+   *
+   * <p> The difference between {@link com.microsoft.playwright.FormData#set FormData.set()} and {@link
+   * com.microsoft.playwright.FormData#append FormData.append()} is that if the specified key already exists, {@link
+   * com.microsoft.playwright.FormData#set FormData.set()} will overwrite all existing values with the new one, whereas
+   * {@link com.microsoft.playwright.FormData#append FormData.append()} will append the new value onto the end of the
+   * existing set of values.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .append("firstName", "John")
+   *     // Name and value are set, filename and Content-Type are inferred from the file path.
+   *     .append("attachment", Paths.get("pic.jpg"))
+   *     // Name, value, filename and Content-Type are set.
+   *     .append("attachment", new FilePayload("table.csv", "text/csv", Files.readAllBytes(Paths.get("my-tble.csv"))));
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
+   *
+   * @param name Field name.
+   * @param value Field value.
+   * @since v1.44
+   */
+  FormData append(String name, Path value);
+  /**
+   * Appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist. File
+   * values can be passed either as {@code Path} or as {@code FilePayload}. Multiple fields with the same name can be added.
+   *
+   * <p> The difference between {@link com.microsoft.playwright.FormData#set FormData.set()} and {@link
+   * com.microsoft.playwright.FormData#append FormData.append()} is that if the specified key already exists, {@link
+   * com.microsoft.playwright.FormData#set FormData.set()} will overwrite all existing values with the new one, whereas
+   * {@link com.microsoft.playwright.FormData#append FormData.append()} will append the new value onto the end of the
+   * existing set of values.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .append("firstName", "John")
+   *     // Name and value are set, filename and Content-Type are inferred from the file path.
+   *     .append("attachment", Paths.get("pic.jpg"))
+   *     // Name, value, filename and Content-Type are set.
+   *     .append("attachment", new FilePayload("table.csv", "text/csv", Files.readAllBytes(Paths.get("my-tble.csv"))));
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
+   *
+   * @param name Field name.
+   * @param value Field value.
+   * @since v1.44
+   */
+  FormData append(String name, FilePayload value);
  /**
   * Creates new instance of {@code FormData}.
   *
@@ -51,7 +186,7 @@ public interface FormData {
   *     // Name and value are set, filename and Content-Type are inferred from the file path.
   *     .set("profilePicture1", Paths.get("john.jpg"))
   *     // Name, value, filename and Content-Type are set.
-   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))));
+   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))))
   *     .set("age", 30);
   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
   * }</pre>
@@ -72,7 +207,7 @@ public interface FormData {
   *     // Name and value are set, filename and Content-Type are inferred from the file path.
   *     .set("profilePicture1", Paths.get("john.jpg"))
   *     // Name, value, filename and Content-Type are set.
-   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))));
+   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))))
   *     .set("age", 30);
   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
   * }</pre>
@@ -93,7 +228,7 @@ public interface FormData {
   *     // Name and value are set, filename and Content-Type are inferred from the file path.
   *     .set("profilePicture1", Paths.get("john.jpg"))
   *     // Name, value, filename and Content-Type are set.
-   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))));
+   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))))
   *     .set("age", 30);
   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
   * }</pre>
@@ -114,7 +249,7 @@ public interface FormData {
   *     // Name and value are set, filename and Content-Type are inferred from the file path.
   *     .set("profilePicture1", Paths.get("john.jpg"))
   *     // Name, value, filename and Content-Type are set.
-   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))));
+   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))))
   *     .set("age", 30);
   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
   * }</pre>
@@ -135,7 +270,7 @@ public interface FormData {
   *     // Name and value are set, filename and Content-Type are inferred from the file path.
   *     .set("profilePicture1", Paths.get("john.jpg"))
   *     // Name, value, filename and Content-Type are set.
-   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))));
+   *     .set("profilePicture2", new FilePayload("john.jpg", "image/jpeg", Files.readAllBytes(Paths.get("john.jpg"))))
   *     .set("age", 30);
   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
   * }</pre>
@@ -19,6 +19,7 @@ package com.microsoft.playwright.options;
 public enum KeyboardModifier {
  ALT,
  CONTROL,
+  CONTROLORMETA,
  META,
  SHIFT
 }
@@ -18,6 +18,7 @@ package com.microsoft.playwright;

 import com.google.gson.JsonElement;
 import com.google.gson.JsonObject;
+import com.microsoft.playwright.junit.FixtureTest;
 import com.microsoft.playwright.junit.UsePlaywright;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.EnabledIf;
@@ -25,9 +26,9 @@ import org.junit.jupiter.api.condition.EnabledIf;
 import java.util.concurrent.atomic.AtomicReference;
 import java.util.regex.Pattern;

-import static com.microsoft.playwright.Utils.getBrowserTypeFromEnv;
 import static org.junit.jupiter.api.Assertions.*;

+@FixtureTest
@UsePlaywright(TestOptionsFactories.BasicOptionsFactory.class)
 public class TestBrowser1 {

@@ -73,8 +74,8 @@ public class TestBrowser1 {
  }

  @Test
-  void shouldReturnBrowserType(Playwright playwright, Browser browser) {
-    assertEquals(getBrowserTypeFromEnv(playwright), browser.browserType());
+  void shouldReturnBrowserType(BrowserType browserType, Browser browser) {
+    assertEquals(browserType, browser.browserType());
  }

  @Test
@@ -16,6 +16,7 @@

 package com.microsoft.playwright;

+import com.microsoft.playwright.junit.FixtureTest;
 import com.microsoft.playwright.junit.Options;
 import com.microsoft.playwright.junit.OptionsFactory;
 import com.microsoft.playwright.junit.UsePlaywright;
@@ -28,6 +29,7 @@ import static com.microsoft.playwright.TestOptionsFactories.createLaunchOptions;
 import static com.microsoft.playwright.TestOptionsFactories.getBrowserChannelFromEnv;
 import static org.junit.jupiter.api.Assertions.assertNotNull;

+@FixtureTest
@UsePlaywright(TestBrowser2.ChannelOptionsFactory.class)
 public class TestBrowser2 {

@@ -70,12 +72,11 @@ public class TestBrowser2 {
  }

  @Test
-  void shouldSupportDeprecatedChannelEnum(Playwright playwright) {
+  void shouldSupportDeprecatedChannelEnum(BrowserType browserType) {
    BrowserChannel channel = getBrowserChannelEnumFromEnv();
    Assumptions.assumeTrue(channel != null);
    BrowserType.LaunchOptions options = createLaunchOptions();
    options.setChannel(channel);
-    BrowserType browserType = Utils.getBrowserTypeFromEnv(playwright);
    Browser browser = browserType.launch(options);
    assertNotNull(browser);
    browser.close();
@@ -591,6 +591,46 @@ public class TestBrowserContextFetch extends TestBase {
    assertEquals(200, response.status());
  }

+  @Test
+  public void shouldSupportRepeatingNamesInMultipartFormData() throws InterruptedException, ExecutionException {
+    Future<Server.Request> serverRequest = server.futureRequest("/empty.html");
+
+    FilePayload file1 = new FilePayload("f.js", "text/javascript",
+      "var x = 10;\r\n;console.log(x);".getBytes(StandardCharsets.UTF_8));
+    FilePayload file2 = new FilePayload("f2.txt", "text/plain",
+      "hello".getBytes(StandardCharsets.UTF_8));
+    APIResponse response = context.request().post(server.EMPTY_PAGE, RequestOptions.create().setMultipart(
+      FormData.create()
+        .set("name", "John")
+        .append("name", "Doe")
+        .append("file", file1)
+        .append("file", file2)));
+
+    assertEquals("POST", serverRequest.get().method);
+    List<String> contentType = serverRequest.get().headers.get("content-type");
+    assertNotNull(contentType);
+    assertEquals(1, contentType.size());
+    assertTrue(contentType.get(0).contains("multipart/form-data"), contentType.get(0));
+
+    String body = new String(serverRequest.get().postBody);
+    assertTrue(body.contains("content-disposition: form-data; name=\"name\"\r\n" +
+      "\r\n" +
+      "John"), body);
+    assertTrue(body.contains("content-disposition: form-data; name=\"name\"\r\n" +
+      "\r\n" +
+      "Doe"), body);
+    assertTrue(body.contains("content-disposition: form-data; name=\"file\"; filename=\"f.js\"\r\n" +
+      "content-type: text/javascript\r\n" +
+      "\r\n" +
+      "var x = 10;\r\n" +
+      ";console.log(x);"), body);
+    assertTrue(body.contains("content-disposition: form-data; name=\"file\"; filename=\"f2.txt\"\r\n" +
+      "content-type: text/plain\r\n" +
+      "\r\n" +
+      "hello"), body);
+    assertEquals(200, response.status());
+  }
+
  @Test
  void shouldSupportMultipartFormDataWithPathValues(@TempDir Path tmp) throws ExecutionException, InterruptedException, IOException {
    Future<Server.Request> serverRequest = server.futureRequest("/empty.html");
@@ -238,7 +238,7 @@ public class TestBrowserTypeConnect extends TestBase {
    }
    assertFalse(remote.isConnected());
    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.evaluate("1 + 1"));
-    assertTrue(e.getMessage().contains("Browser has been closed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Browser has been closed") || e.getMessage().contains("Browser closed"), e.getMessage());
    assertFalse(remote.isConnected());
  }

@@ -259,7 +259,7 @@ public class TestBrowserTypeConnect extends TestBase {
    }
    assertFalse(browser.isConnected());
    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.waitForNavigation(() -> {}));
-    assertTrue(e.getMessage().contains("Page closed") || e.getMessage().contains("Browser has been closed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Browser closed") || e.getMessage().contains("Page closed") || e.getMessage().contains("Browser has been closed"), e.getMessage());
  }

  @Test
@@ -59,4 +59,30 @@ public class TestLaunch extends TestBase {
  public static boolean canRunExtensionTest() {
    return canRunHeaded() && isChromium();
  }
+
+  @Test
+  @EnabledIf(value="com.microsoft.playwright.TestLaunch#canRunExtensionTest", disabledReason="Only Chromium Headed")
+  void shouldReturnBackgroundPages(@TempDir Path tmpDir) throws IOException {
+    Path profileDir = tmpDir.resolve("profile");
+    Files.createDirectories(profileDir);
+    String extensionPath = Paths.get("src/test/resources/simple-extension").toAbsolutePath().toString();
+    initBrowserType();
+    BrowserContext context = browserType.launchPersistentContext(profileDir, new BrowserType.LaunchPersistentContextOptions()
+      .setHeadless(false)
+      .setArgs(asList(
+        "--disable-extensions-except=" + extensionPath,
+        "--load-extension=" + extensionPath
+      )));
+    List<Page> backgroundPages = context.backgroundPages();
+    context.onBackgroundPage(page1 -> backgroundPages.add(page1));
+    context.waitForCondition(() -> !backgroundPages.isEmpty(),
+      new BrowserContext.WaitForConditionOptions().setTimeout(10_000));
+    Page backgroundPage = backgroundPages.get(0);
+    assertNotNull(backgroundPage);
+    assertTrue(context.backgroundPages().contains(backgroundPage));
+    assertFalse(context.pages().contains(backgroundPage));
+    context.close();
+    assertEquals(0, context.pages().size());
+    assertEquals(0, context.backgroundPages().size());
+  }
 }
@@ -17,9 +17,12 @@
 package com.microsoft.playwright;

 import com.microsoft.playwright.assertions.LocatorAssertions;
+import com.microsoft.playwright.options.AriaRole;
 import org.junit.jupiter.api.Test;
 import org.opentest4j.AssertionFailedError;

+import java.util.regex.Pattern;
+
 import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
 import static org.junit.jupiter.api.Assertions.*;

@@ -115,4 +118,36 @@ public class TestLocatorAssertions2 extends TestBase {
    page.setContent("<div id=node>Text content</div>");
    assertThat(page.locator("no-such-thing")).not().isAttached(new LocatorAssertions.IsAttachedOptions().setTimeout(1));
  }
+
+  @Test
+  public void toHaveAccessibleName() {
+    page.setContent("<div role=\"button\" aria-label=\"Hello\"></div>");
+
+    assertThat(page.locator("div")).hasAccessibleName("Hello");
+    assertThat(page.locator("div")).not().hasAccessibleName("hello");
+    assertThat(page.locator("div")).hasAccessibleName("hello", new LocatorAssertions.HasAccessibleNameOptions().setIgnoreCase(true));
+    assertThat(page.locator("div")).hasAccessibleName(Pattern.compile("ell\\w"));
+    assertThat(page.locator("div")).not().hasAccessibleName(Pattern.compile("hello"));
+    assertThat(page.locator("div")).hasAccessibleName(Pattern.compile("hello"), new LocatorAssertions.HasAccessibleNameOptions().setIgnoreCase(true));
+  }
+
+  @Test
+  public void toHaveAccessibleDescription() {
+    page.setContent("<div role=\"button\" aria-description=\"Hello\"></div>");
+
+    assertThat(page.locator("div")).hasAccessibleDescription("Hello");
+    assertThat(page.locator("div")).not().hasAccessibleDescription("hello");
+    assertThat(page.locator("div")).hasAccessibleDescription("hello", new LocatorAssertions.HasAccessibleDescriptionOptions().setIgnoreCase(true));
+    assertThat(page.locator("div")).hasAccessibleDescription(Pattern.compile("ell\\w"));
+    assertThat(page.locator("div")).not().hasAccessibleDescription(Pattern.compile("hello"));
+    assertThat(page.locator("div")).hasAccessibleDescription(Pattern.compile("hello"), new LocatorAssertions.HasAccessibleDescriptionOptions().setIgnoreCase(true));
+  }
+
+  @Test
+  public void toHaveRole() {
+    page.setContent("<div role=\"button\">Button!</div>");
+
+    assertThat(page.locator("div")).hasRole(AriaRole.BUTTON);
+    assertThat(page.locator("div")).not().hasRole(AriaRole.CHECKBOX);
+  }
 }
@@ -63,4 +63,7 @@ public class TestOptionsFactories {
  public static boolean isWebKit() {
    return getBrowserName().equals("webkit");
  }
+
+  static final boolean isMac = Utils.getOS() == Utils.OS.MAC;
+  static final boolean isWindows = Utils.getOS() == Utils.OS.WINDOWS;
 }
@@ -16,6 +16,8 @@

 package com.microsoft.playwright;

+import com.microsoft.playwright.options.AriaRole;
+import com.microsoft.playwright.options.WaitForSelectorState;
 import org.junit.jupiter.api.Test;

 import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
@@ -29,11 +31,13 @@ public class TestPageAddLocatorHandler extends TestBase {
    int[] beforeCount = {0};
    int[] afterCount = {0};

-    page.addLocatorHandler(page.getByText("This interstitial covers the button"), () -> {
+    Locator originalLocator = page.getByText("This interstitial covers the button");
+    page.addLocatorHandler(originalLocator, locator -> {
+      assertEquals(originalLocator, locator);
      ++beforeCount[0];
      page.locator("#close").click();
      ++afterCount[0];
-    });
+    }, new Page.AddLocatorHandlerOptions().setNoWaitAfter(true));

    String[][] argsList = {
      {"mouseover", "1"},
@@ -73,10 +77,10 @@ public class TestPageAddLocatorHandler extends TestBase {
  void shouldWorkWithCustomCheck() {
    page.navigate(server.PREFIX + "/input/handle-locator.html");

-    page.addLocatorHandler(page.locator("body"), () -> {
+    page.addLocatorHandler(page.locator("body"), locator -> {
      if (page.getByText("This interstitial covers the button").isVisible())
        page.locator("#close").click();
-    });
+    }, new Page.AddLocatorHandlerOptions().setNoWaitAfter(true));

    String[][] argsList = {
      {"mouseover", "2"},
@@ -103,7 +107,7 @@ public class TestPageAddLocatorHandler extends TestBase {
  void shouldWorkWithLocatorHover() {
    page.navigate(server.PREFIX + "/input/handle-locator.html");

-    page.addLocatorHandler(page.getByText("This interstitial covers the button"), () -> {
+    page.addLocatorHandler(page.getByText("This interstitial covers the button"), locator -> {
      page.locator("#close").click();
    });

@@ -120,7 +124,7 @@ public class TestPageAddLocatorHandler extends TestBase {
  void shouldNotWorkWithForceTrue() {
    page.navigate(server.PREFIX + "/input/handle-locator.html");

-    page.addLocatorHandler(page.getByText("This interstitial covers the button"), () -> {
+    page.addLocatorHandler(page.getByText("This interstitial covers the button"), locator -> {
      page.locator("#close").click();
    });

@@ -138,7 +142,7 @@ public class TestPageAddLocatorHandler extends TestBase {
  void shouldThrowWhenPageCloses() {
    page.navigate(server.PREFIX + "/input/handle-locator.html");

-    page.addLocatorHandler(page.getByText("This interstitial covers the button"), () -> {
+    page.addLocatorHandler(page.getByText("This interstitial covers the button"), locator -> {
      page.close();
    });

@@ -156,7 +160,7 @@ public class TestPageAddLocatorHandler extends TestBase {
    page.navigate(server.PREFIX + "/input/handle-locator.html");

    int[] called = {0};
-    page.addLocatorHandler(page.getByText("This interstitial covers the button"), () -> {
+    page.addLocatorHandler(page.getByText("This interstitial covers the button"), locator -> {
      ++called[0];
      page.locator("#close").click();
    });
@@ -169,4 +173,168 @@ public class TestPageAddLocatorHandler extends TestBase {
    assertThat(page.locator("#interstitial")).not().isVisible();
    assertEquals(1, called[0]);
 }
+
+  @Test
+  public void shouldWorkWhenOwnerFrameDetaches() {
+    Page page = browser.newPage();
+    page.navigate(server.EMPTY_PAGE);
+
+    page.evaluate("() => {\n" +
+      "    const iframe = document.createElement('iframe');\n" +
+      "    iframe.src = 'data:text/html,<body>hello from iframe</body>';\n" +
+      "    document.body.append(iframe);\n" +
+      "\n" +
+      "    const target = document.createElement('button');\n" +
+      "    target.textContent = 'Click me';\n" +
+      "    target.id = 'target';\n" +
+      "    target.addEventListener('click', () => window._clicked = true);\n" +
+      "    document.body.appendChild(target);\n" +
+      "\n" +
+      "    const closeButton = document.createElement('button');\n" +
+      "    closeButton.textContent = 'close';\n" +
+      "    closeButton.id = 'close';\n" +
+      "    closeButton.addEventListener('click', () => iframe.remove());\n" +
+      "    document.body.appendChild(closeButton);\n" +
+      "  }");
+
+    page.addLocatorHandler(page.frameLocator("iframe").locator("body"), locator -> {
+      page.locator("#close").click();
+    });
+
+    page.locator("#target").click();
+    assertNull(page.querySelector("iframe"));
+    assertTrue((Boolean) page.evaluate("window._clicked"));
+  }
+
+  @Test
+  public void shouldWorkWithTimesOption() {
+    Page page = browser.newPage();
+    page.navigate(server.PREFIX + "/input/handle-locator.html");
+
+    int[] called = {0};
+    page.addLocatorHandler(page.locator("body"), locator -> {
+      ++called[0];
+    }, new Page.AddLocatorHandlerOptions().setNoWaitAfter(true).setTimes(2));
+
+    page.locator("#aside").hover();
+    page.evaluate("() => {\n" +
+      "    window.clicked = 0;\n" +
+      "    window.setupAnnoyingInterstitial('mouseover', 4);\n" +
+      "  }");
+
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.locator("#target").click(new Locator.ClickOptions().setTimeout(3_000)));
+    assertEquals(2, called[0]);
+    assertEquals(0, (int) page.evaluate("window.clicked"));
+    assertTrue(page.locator("#interstitial").isVisible());
+    assertTrue(e.getMessage().contains("Timeout 3000ms exceeded"), e.getMessage());
+    assertTrue(e.getMessage().contains("<div>This interstitial covers the button</div> from <div class=\"visible\" id=\"interstitial\">…</div> subtree intercepts pointer events"), e.getMessage());
+  }
+
+  @Test
+  public void shouldWaitForHiddenByDefault() {
+    Page page = browser.newPage();
+    page.navigate(server.PREFIX + "/input/handle-locator.html");
+
+    int[] called = {0};
+    page.addLocatorHandler(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("close")), button -> {
+      ++called[0];
+      button.click();
+    });
+
+    page.locator("#aside").hover();
+    page.evaluate("() => {" +
+      "window.clicked = 0;" +
+      "window.setupAnnoyingInterstitial('timeout', 1);" +
+      "}");
+
+    page.locator("#target").click();
+    assertEquals(1, (int) page.evaluate("window.clicked"));
+    assertFalse(page.locator("#interstitial").isVisible());
+    assertEquals(1, called[0]);
+  }
+
+  @Test
+  public void shouldWaitForHiddenByDefault2() {
+    Page page = browser.newPage();
+    page.navigate(server.PREFIX + "/input/handle-locator.html");
+
+    int[] called = {0};
+    page.addLocatorHandler(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("close")), button -> {
+      ++called[0];
+    });
+
+    page.locator("#aside").hover();
+    page.evaluate("() => {" +
+      "window.clicked = 0;" +
+      "window.setupAnnoyingInterstitial('hide', 1);" +
+      "}");
+
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.locator("#target").click(new Locator.ClickOptions().setTimeout(3_000)));
+    assertEquals(0, (int) page.evaluate("window.clicked"));
+    assertThat(page.locator("#interstitial")).isVisible();
+    assertEquals(1, called[0]);
+    assertTrue(e.getMessage().contains("locator handler has finished, waiting for getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName(\"close\")) to be hidden"), e.getMessage());
+  }
+
+  @Test
+  public void shouldWorkWithNoWaitAfter() {
+    Page page = browser.newPage();
+    page.navigate(server.PREFIX + "/input/handle-locator.html");
+
+    int[] called = {0};
+    page.addLocatorHandler(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("close")), button -> {
+      ++called[0];
+      if (called[0] == 1) {
+        button.click();
+      } else {
+        page.locator("#interstitial").waitFor(new Locator.WaitForOptions().setState(WaitForSelectorState.HIDDEN));
+      }
+    }, new Page.AddLocatorHandlerOptions().setNoWaitAfter(true));
+
+    page.locator("#aside").hover();
+    page.evaluate("() => {" +
+      "window.clicked = 0;" +
+      "window.setupAnnoyingInterstitial('timeout', 1);" +
+      "}");
+
+    page.locator("#target").click();
+    assertEquals(1, (int) page.evaluate("window.clicked"));
+    assertThat(page.locator("#interstitial")).not().isVisible();
+    assertEquals(2, called[0]);
+  }
+
+  @Test
+  public void shouldRemoveLocatorHandler() {
+    Page page = browser.newPage();
+    page.navigate(server.PREFIX + "/input/handle-locator.html");
+
+    int[] called = {0};
+    page.addLocatorHandler(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("close")), button -> {
+      ++called[0];
+      button.click();
+    });
+
+    page.evaluate("() => {" +
+      "window.clicked = 0;" +
+      "window.setupAnnoyingInterstitial('hide', 1);" +
+      "}");
+
+    page.locator("#target").click();
+    assertEquals(1, called[0]);
+    assertEquals(1, (int) page.evaluate("window.clicked"));
+    assertThat(page.locator("#interstitial")).not().isVisible();
+
+    page.evaluate("() => {" +
+      "window.clicked = 0;" +
+      "window.setupAnnoyingInterstitial('hide', 1);" +
+      "}");
+
+    page.removeLocatorHandler(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("close")));
+
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.locator("#target").click(new Locator.ClickOptions().setTimeout(3_000)));
+    assertEquals(1, called[0]);
+    assertEquals(0, (int) page.evaluate("window.clicked"));
+    assertThat(page.locator("#interstitial")).isVisible();
+    assertTrue(e.getMessage().contains("Timeout 3000ms exceeded"));
+  }
 }
@@ -58,6 +58,12 @@ public class TestPageAssertions extends TestBase {
    assertThat(page).not().hasURL("about:blank", new PageAssertions.HasURLOptions().setTimeout(1000));
  }

+  @Test
+  public void hasUrlSupportIgnoreCase() {
+    page.navigate("data:text/html,<div>A</div>");
+    assertThat(page).hasURL("DATA:teXT/HTml,<div>a</div>", new PageAssertions.HasURLOptions().setIgnoreCase(true));
+  }
+
  @Test
  void hasURLRegexPass() {
    page.navigate("data:text/html,<div>A</div>");
@@ -343,10 +343,9 @@ public class TestPageKeyboard extends TestBase {
    page.navigate(server.PREFIX + "/input/textarea.html");
    ElementHandle textarea = page.querySelector("textarea");
    textarea.type("some text");
-    String modifier = isMac ? "Meta" : "Control";
-    page.keyboard().down(modifier);
+    page.keyboard().down("ControlOrMeta");
    page.keyboard().press("a");
-    page.keyboard().up(modifier);
+    page.keyboard().up("ControlOrMeta");
    page.keyboard().press("Backspace");
    assertTrue(((String)page.evalOnSelector("textarea", "textarea => textarea.value")).isEmpty());
  }
@@ -362,10 +361,9 @@ public class TestPageKeyboard extends TestBase {
      "      event.preventDefault();\n" +
      "  }, false);\n" +
      "}");
-    String modifier = isMac ? "Meta" : "Control";
-    page.keyboard().down(modifier);
+    page.keyboard().down("ControlOrMeta");
    page.keyboard().press("a");
-    page.keyboard().up(modifier);
+    page.keyboard().up("ControlOrMeta");
    page.keyboard().press("Backspace");
    assertEquals("some tex", page.evalOnSelector("textarea", "textarea => textarea.value"));
  }
@@ -252,8 +252,20 @@ public class TestPageScreenshot extends TestBase {
    assertThrows(AssertionError.class, () -> assertArrayEquals(screenshot1, screenshot2));
  }

+  static boolean isScreenshotTestDisabled() {
+    if (isWebKit()) {
+      // Array lengths differ.
+      return true;
+    }
+    if (getBrowserChannelFromEnv() != null) {
+      // Stable builds may have different expectations.
+      return true;
+    }
+    return false;
+  }
+
  @Test
-  @DisabledIf(value="com.microsoft.playwright.TestBase#isWebKit", disabledReason="array lengths differ")
+  @DisabledIf(value="com.microsoft.playwright.TestPageScreenshot#isScreenshotTestDisabled", disabledReason="array lengths differ")
  void shouldHideElementsBasedOnAttr() throws IOException {
    page.setViewportSize(500, 500);
    page.navigate(server.PREFIX + "/grid.html");
@@ -269,7 +281,7 @@ public class TestPageScreenshot extends TestBase {
  }

  @Test
-  @DisabledIf(value="com.microsoft.playwright.TestBase#isWebKit", disabledReason="array lengths differ")
+  @DisabledIf(value="com.microsoft.playwright.TestPageScreenshot#isScreenshotTestDisabled", disabledReason="array lengths differ")
  void shouldRemoveElementsBasedOnAttr() throws IOException {
    page.setViewportSize(500, 500);
    page.navigate(server.PREFIX + "/grid.html");
@@ -182,7 +182,7 @@ public class Utils {
    return browserName;
  }

-  static BrowserType getBrowserTypeFromEnv(Playwright playwright) {
+  public static BrowserType getBrowserTypeFromEnv(Playwright playwright) {
    String browserName = getBrowserNameFromEnv();
    switch (browserName) {
      case "webkit":
@@ -0,0 +1,9 @@
+package com.microsoft.playwright.impl;
+
+import com.microsoft.playwright.Browser;
+
+public class ImplUtils {
+  public static boolean isRemoteBrowser(Browser browser) {
+    return ((BrowserImpl) browser).isConnectedOverWebSocket;
+  }
+}
@@ -0,0 +1,24 @@
+package com.microsoft.playwright.junit;
+
+import com.microsoft.playwright.BrowserType;
+import com.microsoft.playwright.Playwright;
+import com.microsoft.playwright.impl.junit.PlaywrightExtension;
+import org.junit.jupiter.api.extension.ExtensionContext;
+import org.junit.jupiter.api.extension.ParameterContext;
+import org.junit.jupiter.api.extension.ParameterResolutionException;
+import org.junit.jupiter.api.extension.ParameterResolver;
+
+import static com.microsoft.playwright.Utils.getBrowserTypeFromEnv;
+
+public class BrowserTypeParameterResolver implements ParameterResolver {
+  @Override
+  public boolean supportsParameter(ParameterContext parameterContext, ExtensionContext extensionContext) throws ParameterResolutionException {
+    return BrowserType.class.equals(parameterContext.getParameter().getType());
+  }
+
+  @Override
+  public Object resolveParameter(ParameterContext parameterContext, ExtensionContext extensionContext) throws ParameterResolutionException {
+    Playwright playwright = PlaywrightExtension.getOrCreatePlaywright(extensionContext);
+    return getBrowserTypeFromEnv(playwright);
+  }
+}
@@ -24,7 +24,7 @@ import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;

-@ExtendWith(ServerLifecycle.class)
+@ExtendWith({ServerLifecycle.class, BrowserTypeParameterResolver.class})
@Tag("fixtures")
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@@ -50,9 +50,16 @@
      }, false);

      close.addEventListener('click', () => {
-        interstitial.classList.remove('visible');
-        target.classList.remove('hidden');
-        target.classList.remove('removed');
+        const closeInterstitial = () => {
+          interstitial.classList.remove('visible');
+          target.classList.remove('hidden');
+          target.classList.remove('removed');
+        };
+
+        if (interstitial.classList.contains('timeout'))
+          setTimeout(closeInterstitial, 3000);
+        else
+          closeInterstitial();
      });

      let timesToShow = 0;
@@ -65,9 +72,11 @@
          if (!timesToShow && event !== 'none')
            target.removeEventListener(event, listener, capture === 'capture');
        };
-        if (event === 'hide') {
+        if (event === 'hide' || event === 'timeout') {
          target.classList.add('hidden');
          listener();
+          if (event === 'timeout')
+            interstitial.classList.add('timeout');
        } else if (event === 'remove') {
          target.classList.add('removed');
          listener();
@@ -6,7 +6,7 @@

  <groupId>com.microsoft.playwright</groupId>
  <artifactId>parent-pom</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <packaging>pom</packaging>
  <name>Playwright Parent Project</name>
  <description>Java library to automate Chromium, Firefox and WebKit with a single API.
@@ -40,7 +40,6 @@
    <module>driver-bundle</module>
    <module>playwright</module>
  </modules>
-
  <properties>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
@@ -116,17 +115,17 @@
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-install-plugin</artifactId>
-          <version>3.1.1</version>
+          <version>3.1.2</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-deploy-plugin</artifactId>
-          <version>3.1.1</version>
+          <version>3.1.2</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-source-plugin</artifactId>
-          <version>3.3.0</version>
+          <version>3.3.1</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
@@ -162,12 +161,12 @@
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-gpg-plugin</artifactId>
-          <version>3.2.2</version>
+          <version>3.2.4</version>
        </plugin>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-jar-plugin</artifactId>
-          <version>3.3.0</version>
+          <version>3.4.1</version>
          <configuration>
            <archive>
              <manifest>
@@ -1 +1 @@
-1.43.0
+1.44.0
@@ -6,7 +6,7 @@

  <groupId>com.microsoft.playwright</groupId>
  <artifactId>api-generator</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Playwright - API Generator</name>
  <description>
    This is an internal module used to generate Java API from the upstream Playwright
@@ -294,6 +294,7 @@ class TypeRef extends Element {
    customTypeNames.put("Frame.setInputFiles.files", "FilePayload");
    customTypeNames.put("Page.setInputFiles.files", "FilePayload");
    customTypeNames.put("Page.setInputFiles.files", "FilePayload");
+    customTypeNames.put("FormData.append.value", "FilePayload");
    customTypeNames.put("FormData.set.value", "FilePayload");

    customTypeNames.put("Locator.dragTo.options.sourcePosition", "Position");
@@ -996,6 +997,9 @@ class Interface extends TypeDefinition {
    if ("CDPSession".equals(jsonName)) {
      output.add("import com.google.gson.JsonObject;");
    }
+    if ("LocatorAssertions".equals(jsonName)) {
+      output.add("import com.microsoft.playwright.options.AriaRole;");
+    }
    if ("PlaywrightAssertions".equals(jsonName)) {
      output.add("import com.microsoft.playwright.APIResponse;");
      output.add("import com.microsoft.playwright.Locator;");
@@ -1215,6 +1219,11 @@ public class ApiGenerator {
      }
    }

+    // No options under assertions.
+    if (packageName.contains(".assertions")) {
+      return;
+    }
+
    dir = new File(dir, "options");
    for (TypeDefinition e : topLevelTypes.values()) {
      List<String> lines = new ArrayList<>();
@@ -4,7 +4,7 @@
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>test-cli-fatjar</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Test Playwright Command Line FatJar</name>
  <properties>
    <compiler.version>1.8</compiler.version>
@@ -4,7 +4,7 @@
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>test-cli-version</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Test Playwright Command Line Version</name>
  <properties>
    <compiler.version>1.8</compiler.version>
@@ -4,7 +4,7 @@
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>test-local-installation</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Test local installation</name>
  <description>Runs Playwright test suite (copied from playwright module) against locally cached Playwright</description>
  <properties>
@@ -9,7 +9,7 @@
  </parent>
  <groupId>com.microsoft.playwright</groupId>
  <artifactId>test-spring-boot-starter</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Test Playwright With Spring Boot</name>
  <properties>
    <spring.version>2.4.3</spring.version>
@@ -6,7 +6,7 @@

  <groupId>com.microsoft.playwright</groupId>
  <artifactId>update-version</artifactId>
-  <version>1.43.0</version>
+  <version>1.44.0</version>
  <name>Playwright - Update Version in Documentation</name>
  <description>
    This is an internal module used to update versions in the documentation based on
Author	SHA1	Message	Date
Yury Semikhatsky	af2dd24147	chore: set version 1.44.0 (#1578 )	2024-05-17 09:10:14 -07:00
Yury Semikhatsky	75062c4024	chore: roll 1.44.0 (#1575 )	2024-05-08 12:10:05 -07:00
Yury Semikhatsky	c9ea56a640	devops: stop producing .sha256 files, they are not required anymore (#1570 )	2024-05-03 11:03:45 -07:00
Max Schmitt	e4c427aa75	devops: fix ESRP publishing (#1569 )	2024-05-03 10:55:40 -07:00
Max Schmitt	0471c5e86c	devops: update to EsrpRelease@7 (#1566 )	2024-05-03 09:03:41 -07:00
Yury Semikhatsky	5636edf69a	test: ControlOrMeta modifier (#1564 )	2024-05-02 16:30:27 -07:00
dependabot[bot]	abfe50ce59	chore(deps): bump org.apache.maven.plugins:maven-jar-plugin from 3.3.0 to 3.4.1 (#1556 )	2024-05-01 15:15:23 -07:00
Yury Semikhatsky	d72364627b	chore: roll driver to 1.44.0-beta-1714435420000 (#1563 )	2024-04-30 08:57:03 -07:00
dependabot[bot]	fe51fb4cf6	chore(deps): bump org.apache.maven.plugins:maven-install-plugin from 3.1.1 to 3.1.2 (#1562 )	2024-04-29 17:02:12 -07:00
dependabot[bot]	764cc8cc8a	chore(deps): bump org.apache.maven.plugins:maven-deploy-plugin from 3.1.1 to 3.1.2 (#1561 )	2024-04-29 17:01:59 -07:00
Yury Semikhatsky	7b8efadc57	chore: roll driver, implement new features (#1559 )	2024-04-27 08:46:04 -07:00
uchagani	a654a4234e	feat(junit): add ability to connect to remote browsers via fixtures (#1541 )	2024-04-22 13:09:33 -07:00
dependabot[bot]	102d337b4a	chore(deps): bump org.apache.maven.plugins:maven-gpg-plugin from 3.2.3 to 3.2.4 (#1555 )	2024-04-22 11:29:53 -07:00
Max Schmitt	f5f9b8a12d	devops: migrate to OIDC for Docker publishing (#1554 )	2024-04-19 00:13:33 +02:00
Max Schmitt	2f264eab76	fix(cdpSession): events without payload (#1553 )	2024-04-17 09:10:55 -07:00
dependabot[bot]	5c17cc49ed	chore(deps): bump org.apache.maven.plugins:maven-gpg-plugin from 3.2.2 to 3.2.3 (#1550 )	2024-04-16 10:57:00 -07:00
Max Schmitt	8652942482	fix(driver): consider PLAYWRIGHT_NODEJS_PATH from host env (#1552 )	2024-04-16 19:54:15 +02:00
dependabot[bot]	2829a37d58	chore(deps): bump org.apache.maven.plugins:maven-source-plugin from 3.3.0 to 3.3.1 (#1543 )	2024-04-10 09:19:51 -07:00
@@ -1 +1 @@
 .43.0
 .44.0