chore: roll 1.41.2 driver, mark 1.41.2 (#1471)

Reference https://github.com/microsoft/playwright-java/issues/1468

.azure-pipelines/publish.yml

@@ -46,15 +46,17 @@ steps:
     done
   displayName: 'Create .sha256 files'
 
-- task: EsrpRelease@2
+- task: EsrpRelease@4
   inputs:
-    ConnectedServiceName: 'Playwright-Java-ESRP'
+    ConnectedServiceName: 'Playwright-ESRP'
     Intent: 'PackageDistribution'
     ContentType: 'Maven'
-    PackageLocation: './local-build'
+    ContentSource: 'Folder'
+    FolderLocation: './local-build'
+    WaitForReleaseCompletion: true
     Owners: 'yurys@microsoft.com'
     Approvers: 'maxschmitt@microsoft.com'
     ServiceEndpointUrl: 'https://api.esrp.microsoft.com'
-    MainPublisher: 'PlaywrightJava'
+    MainPublisher: 'Playwright'
     DomainTenantId: '72f988bf-86f1-41af-91ab-2d7cd011db47'
   displayName: 'ESRP Release to Maven'

README.md

@@ -11,11 +11,11 @@ Playwright is a Java library to automate [Chromium](https://www.chromium.org/Hom
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->114.0.5735.35<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
-| WebKit <!-- GEN:webkit-version -->16.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->113.0<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| Chromium <!-- GEN:chromium-version -->121.0.6167.57<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
+| WebKit <!-- GEN:webkit-version -->17.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->121.0<!-- 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/next/intro/#system-requirements) for details.
+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.
 
 * [Usage](#usage)
   - [Add Maven dependency](#add-maven-dependency)

ROLLING.md

@@ -6,8 +6,15 @@
 * regenerate API: `./scripts/download_driver_for_all_platforms.sh -f && ./scripts/generate_api.sh && ./scripts/update_readme.sh`
 * commit & send PR with the roll
 
+### Finding driver version
+
+For development versions of Playwright, you can find the latest version by looking at [publish_canary](https://github.com/microsoft/playwright/actions/workflows/publish_canary.yml) workflow -> `publish canary NPM & Publish canary Docker` -> `build & publish driver` step -> `PACKAGE_VERSION`
+<img width="960" alt="image" src="https://github.com/microsoft/playwright-java/assets/9798949/4f33a7f1-b39a-4179-8ae7-fb1d84094c75">
+
+
 # Updating Version
 
 ```bash
 ./scripts/set_maven_version.sh 1.15.0
 ```
+

driver-bundle/pom.xml

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

driver/pom.xml

@@ -6,7 +6,7 @@
   <parent>
     <groupId>com.microsoft.playwright</groupId>
     <artifactId>parent-pom</artifactId>
-    <version>1.34.0-SNAPSHOT</version>
+    <version>1.41.2</version>
   </parent>
 
   <artifactId>driver</artifactId>

examples/pom.xml

@@ -6,7 +6,7 @@
 
   <groupId>org.example</groupId>
   <artifactId>examples</artifactId>
-  <version>1.34.0-SNAPSHOT</version>
+  <version>1.41.2</version>
   <name>Playwright Client Examples</name>
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

playwright/pom.xml

@@ -7,7 +7,7 @@
   <parent>
     <groupId>com.microsoft.playwright</groupId>
     <artifactId>parent-pom</artifactId>
-    <version>1.34.0-SNAPSHOT</version>
+    <version>1.41.2</version>
   </parent>
 
   <artifactId>playwright</artifactId>

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

@@ -42,7 +42,7 @@ public interface APIRequest {
      */
     public String baseURL;
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public Map<String, String> extraHTTPHeaders;
     /**
@@ -100,7 +100,7 @@ public interface APIRequest {
       return this;
     }
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public NewContextOptions setExtraHTTPHeaders(Map<String, String> extraHTTPHeaders) {
       this.extraHTTPHeaders = extraHTTPHeaders;

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

@@ -80,8 +80,8 @@ public interface APIRequestContext {
   APIResponse delete(String url, RequestOptions params);
   /**
    * All responses returned by {@link APIRequestContext#get APIRequestContext.get()} and similar methods are stored in the
-   * memory, so that you can later call {@link APIResponse#body APIResponse.body()}. This method discards all stored
-   * responses, and makes {@link APIResponse#body APIResponse.body()} throw "Response disposed" error.
+   * memory, so that you can later call {@link APIResponse#body APIResponse.body()}.This method discards all its resources,
+   * calling any method on disposed {@code APIRequestContext} will throw an exception.
    *
    * @since v1.16
    */

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

@@ -56,6 +56,20 @@ public interface Browser extends AutoCloseable {
    */
   void offDisconnected(Consumer<Browser> handler);
 
+  class CloseOptions {
+    /**
+     * The reason to be reported to the operations interrupted by the browser closure.
+     */
+    public String reason;
+
+    /**
+     * The reason to be reported to the operations interrupted by the browser closure.
+     */
+    public CloseOptions setReason(String reason) {
+      this.reason = reason;
+      return this;
+    }
+  }
   class NewContextOptions {
     /**
      * Whether to automatically download all the attachments. Defaults to {@code true} where all the downloads are accepted.
@@ -66,7 +80,7 @@ public interface Browser extends AutoCloseable {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -78,7 +92,7 @@ public interface Browser extends AutoCloseable {
      */
     public String baseURL;
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public Boolean bypassCSP;
     /**
@@ -93,7 +107,7 @@ public interface Browser extends AutoCloseable {
      */
     public Double deviceScaleFactor;
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public Map<String, String> extraHTTPHeaders;
     /**
@@ -120,7 +134,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public Boolean isMobile;
     /**
@@ -130,8 +144,9 @@ public interface Browser extends AutoCloseable {
     public Boolean javaScriptEnabled;
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public String locale;
     /**
@@ -141,11 +156,11 @@ public interface Browser extends AutoCloseable {
     public Boolean offline;
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public List<String> permissions;
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -220,13 +235,14 @@ public interface Browser extends AutoCloseable {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public Boolean strictSelectors;
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public String timezoneId;
     /**
@@ -234,8 +250,8 @@ public interface Browser extends AutoCloseable {
      */
     public String userAgent;
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -255,7 +271,7 @@ public interface Browser extends AutoCloseable {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -270,7 +286,7 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public NewContextOptions setBypassCSP(boolean bypassCSP) {
       this.bypassCSP = bypassCSP;
@@ -294,7 +310,7 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public NewContextOptions setExtraHTTPHeaders(Map<String, String> extraHTTPHeaders) {
       this.extraHTTPHeaders = extraHTTPHeaders;
@@ -349,7 +365,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public NewContextOptions setIsMobile(boolean isMobile) {
       this.isMobile = isMobile;
@@ -365,8 +381,9 @@ public interface Browser extends AutoCloseable {
     }
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public NewContextOptions setLocale(String locale) {
       this.locale = locale;
@@ -382,14 +399,14 @@ public interface Browser extends AutoCloseable {
     }
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public NewContextOptions setPermissions(List<String> permissions) {
       this.permissions = permissions;
       return this;
     }
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -399,7 +416,7 @@ public interface Browser extends AutoCloseable {
       return setProxy(new Proxy(server));
     }
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -532,7 +549,8 @@ public interface Browser extends AutoCloseable {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public NewContextOptions setStrictSelectors(boolean strictSelectors) {
       this.strictSelectors = strictSelectors;
@@ -541,7 +559,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public NewContextOptions setTimezoneId(String timezoneId) {
       this.timezoneId = timezoneId;
@@ -555,8 +573,8 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -566,8 +584,8 @@ public interface Browser extends AutoCloseable {
       return setViewportSize(new ViewportSize(width, height));
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -588,7 +606,7 @@ public interface Browser extends AutoCloseable {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -600,7 +618,7 @@ public interface Browser extends AutoCloseable {
      */
     public String baseURL;
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public Boolean bypassCSP;
     /**
@@ -615,7 +633,7 @@ public interface Browser extends AutoCloseable {
      */
     public Double deviceScaleFactor;
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public Map<String, String> extraHTTPHeaders;
     /**
@@ -642,7 +660,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public Boolean isMobile;
     /**
@@ -652,8 +670,9 @@ public interface Browser extends AutoCloseable {
     public Boolean javaScriptEnabled;
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public String locale;
     /**
@@ -663,11 +682,11 @@ public interface Browser extends AutoCloseable {
     public Boolean offline;
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public List<String> permissions;
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -742,13 +761,14 @@ public interface Browser extends AutoCloseable {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public Boolean strictSelectors;
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public String timezoneId;
     /**
@@ -756,8 +776,8 @@ public interface Browser extends AutoCloseable {
      */
     public String userAgent;
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -777,7 +797,7 @@ public interface Browser extends AutoCloseable {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -792,7 +812,7 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public NewPageOptions setBypassCSP(boolean bypassCSP) {
       this.bypassCSP = bypassCSP;
@@ -816,7 +836,7 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public NewPageOptions setExtraHTTPHeaders(Map<String, String> extraHTTPHeaders) {
       this.extraHTTPHeaders = extraHTTPHeaders;
@@ -871,7 +891,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public NewPageOptions setIsMobile(boolean isMobile) {
       this.isMobile = isMobile;
@@ -887,8 +907,9 @@ public interface Browser extends AutoCloseable {
     }
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public NewPageOptions setLocale(String locale) {
       this.locale = locale;
@@ -904,14 +925,14 @@ public interface Browser extends AutoCloseable {
     }
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public NewPageOptions setPermissions(List<String> permissions) {
       this.permissions = permissions;
       return this;
     }
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -921,7 +942,7 @@ public interface Browser extends AutoCloseable {
       return setProxy(new Proxy(server));
     }
     /**
-     * Network proxy settings to use with this context.
+     * Network proxy settings to use with this context. Defaults to none.
      *
      * <p> <strong>NOTE:</strong> For Chromium on Windows the browser needs to be launched with the global proxy for this option to work. If all contexts
      * override the proxy, global proxy will be never used and can be any string, for example {@code launch({ proxy: { server:
@@ -1054,7 +1075,8 @@ public interface Browser extends AutoCloseable {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public NewPageOptions setStrictSelectors(boolean strictSelectors) {
       this.strictSelectors = strictSelectors;
@@ -1063,7 +1085,7 @@ public interface Browser extends AutoCloseable {
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public NewPageOptions setTimezoneId(String timezoneId) {
       this.timezoneId = timezoneId;
@@ -1077,8 +1099,8 @@ public interface Browser extends AutoCloseable {
       return this;
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -1088,8 +1110,8 @@ public interface Browser extends AutoCloseable {
       return setViewportSize(new ViewportSize(width, height));
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -1157,7 +1179,25 @@ public interface Browser extends AutoCloseable {
    *
    * @since v1.8
    */
-  void close();
+  default void close() {
+    close(null);
+  }
+  /**
+   * In case this browser is obtained using {@link BrowserType#launch BrowserType.launch()}, closes the browser and all of
+   * its pages (if any were opened).
+   *
+   * <p> In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the
+   * browser server.
+   *
+   * <p> <strong>NOTE:</strong> This is similar to force quitting the browser. Therefore, you should call {@link BrowserContext#close
+   * BrowserContext.close()} on any {@code BrowserContext}'s you explicitly created earlier with {@link Browser#newContext
+   * Browser.newContext()} **before** calling {@link Browser#close Browser.close()}.
+   *
+   * <p> The {@code Browser} object itself is considered to be disposed and cannot be used anymore.
+   *
+   * @since v1.8
+   */
+  void close(CloseOptions options);
   /**
    * Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
    *
@@ -1178,6 +1218,14 @@ public interface Browser extends AutoCloseable {
    * @since v1.8
    */
   boolean isConnected();
+  /**
+   * <strong>NOTE:</strong> CDP Sessions are only supported on Chromium-based browsers.
+   *
+   * <p> Returns the newly created browser session.
+   *
+   * @since v1.11
+   */
+  CDPSession newBrowserCDPSession();
   /**
    * Creates a new browser context. It won't share cookies/cache with other browser contexts.
    *

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

@@ -127,6 +127,16 @@ public interface BrowserContext extends AutoCloseable {
    */
   void offPage(Consumer<Page> handler);
 
+  /**
+   * Emitted when exception is unhandled in any of the pages in this context. To listen for errors from a particular page,
+   * use {@link Page#onPageError Page.onPageError()} instead.
+   */
+  void onWebError(Consumer<WebError> handler);
+  /**
+   * Removes handler that was previously added with {@link #onWebError onWebError(handler)}.
+   */
+  void offWebError(Consumer<WebError> handler);
+
   /**
    * Emitted when a request is issued from any pages created through this context. The [request] object is read-only. To only
    * listen for requests from a particular page, use {@link Page#onRequest Page.onRequest()}.
@@ -176,6 +186,20 @@ public interface BrowserContext extends AutoCloseable {
    */
   void offResponse(Consumer<Response> handler);
 
+  class CloseOptions {
+    /**
+     * The reason to be reported to the operations interrupted by the context closure.
+     */
+    public String reason;
+
+    /**
+     * The reason to be reported to the operations interrupted by the context closure.
+     */
+    public CloseOptions setReason(String reason) {
+      this.reason = reason;
+      return this;
+    }
+  }
   class ExposeBindingOptions {
     /**
      * Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
@@ -494,7 +518,17 @@ public interface BrowserContext extends AutoCloseable {
    *
    * @since v1.8
    */
-  void close();
+  default void close() {
+    close(null);
+  }
+  /**
+   * Closes the browser context. All the pages that belong to the browser context will be closed.
+   *
+   * <p> <strong>NOTE:</strong> The default browser context cannot be closed.
+   *
+   * @since v1.8
+   */
+  void close(CloseOptions options);
   /**
    * If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs
    * are returned.
@@ -752,6 +786,26 @@ public interface BrowserContext extends AutoCloseable {
    * @since v1.8
    */
   void grantPermissions(List<String> permissions, GrantPermissionsOptions options);
+  /**
+   * <strong>NOTE:</strong> CDP sessions are only supported on Chromium-based browsers.
+   *
+   * <p> Returns the newly created session.
+   *
+   * @param page Target to create new session for. For backwards-compatibility, this parameter is named {@code page}, but it can be a
+   * {@code Page} or {@code Frame} type.
+   * @since v1.11
+   */
+  CDPSession newCDPSession(Page page);
+  /**
+   * <strong>NOTE:</strong> CDP sessions are only supported on Chromium-based browsers.
+   *
+   * <p> Returns the newly created session.
+   *
+   * @param page Target to create new session for. For backwards-compatibility, this parameter is named {@code page}, but it can be a
+   * {@code Page} or {@code Frame} type.
+   * @since v1.11
+   */
+  CDPSession newCDPSession(Frame page);
   /**
    * Creates a new page in the browser context.
    *
@@ -1096,7 +1150,7 @@ public interface BrowserContext extends AutoCloseable {
   void route(Predicate<String> url, Consumer<Route> handler, RouteOptions options);
   /**
    * If specified the network requests that are made in the context will be served from the HAR file. Read more about <a
-   * href="https://playwright.dev/java/docs/network#replaying-from-har">Replaying from HAR</a>.
+   * href="https://playwright.dev/java/docs/mock#replaying-from-har">Replaying from HAR</a>.
    *
    * <p> Playwright will not serve requests intercepted by Service Worker from the HAR file. See <a
    * href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers when
@@ -1111,7 +1165,7 @@ public interface BrowserContext extends AutoCloseable {
   }
   /**
    * If specified the network requests that are made in the context will be served from the HAR file. Read more about <a
-   * href="https://playwright.dev/java/docs/network#replaying-from-har">Replaying from HAR</a>.
+   * href="https://playwright.dev/java/docs/mock#replaying-from-har">Replaying from HAR</a>.
    *
    * <p> Playwright will not serve requests intercepted by Service Worker from the HAR file. See <a
    * href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers when
@@ -1206,6 +1260,13 @@ public interface BrowserContext extends AutoCloseable {
    * @since v1.12
    */
   Tracing tracing();
+  /**
+   * Removes all routes created with {@link BrowserContext#route BrowserContext.route()} and {@link
+   * BrowserContext#routeFromHAR BrowserContext.routeFromHAR()}.
+   *
+   * @since v1.41
+   */
+  void unrouteAll();
   /**
    * Removes a route created with {@link BrowserContext#route BrowserContext.route()}. When {@code handler} is not specified,
    * removes all routes for the {@code url}.

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

@@ -43,6 +43,26 @@ import java.util.regex.Pattern;
  */
 public interface BrowserType {
   class ConnectOptions {
+    /**
+     * This option exposes network available on the connecting client to the browser being connected to. Consists of a list of
+     * rules separated by comma.
+     *
+     * <p> Available rules:
+     * <ol>
+     * <li> Hostname pattern, for example: {@code example.com}, {@code *.org:99}, {@code x.*.y.com}, {@code *foo.org}.</li>
+     * <li> IP literal, for example: {@code 127.0.0.1}, {@code 0.0.0.0:99}, {@code [::1]}, {@code [0:0::1]:99}.</li>
+     * <li> {@code <loopback>} that matches local loopback interfaces: {@code localhost}, {@code *.localhost}, {@code 127.0.0.1},
+     * {@code [::1]}.</li>
+     * </ol>
+     *
+     * <p> Some common examples:
+     * <ol>
+     * <li> {@code "*"} to expose all network.</li>
+     * <li> {@code "<loopback>"} to expose localhost network.</li>
+     * <li> {@code "*.test.internal-domain,*.staging.internal-domain,<loopback>"} to expose test/staging deployments and localhost.</li>
+     * </ol>
+     */
+    public String exposeNetwork;
     /**
      * Additional HTTP headers to be sent with web socket connect request. Optional.
      */
@@ -57,6 +77,29 @@ public interface BrowserType {
      */
     public Double timeout;
 
+    /**
+     * This option exposes network available on the connecting client to the browser being connected to. Consists of a list of
+     * rules separated by comma.
+     *
+     * <p> Available rules:
+     * <ol>
+     * <li> Hostname pattern, for example: {@code example.com}, {@code *.org:99}, {@code x.*.y.com}, {@code *foo.org}.</li>
+     * <li> IP literal, for example: {@code 127.0.0.1}, {@code 0.0.0.0:99}, {@code [::1]}, {@code [0:0::1]:99}.</li>
+     * <li> {@code <loopback>} that matches local loopback interfaces: {@code localhost}, {@code *.localhost}, {@code 127.0.0.1},
+     * {@code [::1]}.</li>
+     * </ol>
+     *
+     * <p> Some common examples:
+     * <ol>
+     * <li> {@code "*"} to expose all network.</li>
+     * <li> {@code "<loopback>"} to expose localhost network.</li>
+     * <li> {@code "*.test.internal-domain,*.staging.internal-domain,<loopback>"} to expose test/staging deployments and localhost.</li>
+     * </ol>
+     */
+    public ConnectOptions setExposeNetwork(String exposeNetwork) {
+      this.exposeNetwork = exposeNetwork;
+      return this;
+    }
     /**
      * Additional HTTP headers to be sent with web socket connect request. Optional.
      */
@@ -122,8 +165,10 @@ public interface BrowserType {
   }
   class LaunchOptions {
     /**
-     * Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
-     * href="http://peter.sh/experiments/chromium-command-line-switches/">here</a>.
+     * <strong>NOTE:</strong> Use custom browser args at your own risk, as some of them may break Playwright functionality.
+     *
+     * <p> Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
+     * href="https://peter.sh/experiments/chromium-command-line-switches/">here</a>.
      */
     public List<String> args;
     /**
@@ -210,8 +255,10 @@ public interface BrowserType {
     public Path tracesDir;
 
     /**
-     * Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
-     * href="http://peter.sh/experiments/chromium-command-line-switches/">here</a>.
+     * <strong>NOTE:</strong> Use custom browser args at your own risk, as some of them may break Playwright functionality.
+     *
+     * <p> Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
+     * href="https://peter.sh/experiments/chromium-command-line-switches/">here</a>.
      */
     public LaunchOptions setArgs(List<String> args) {
       this.args = args;
@@ -373,8 +420,10 @@ public interface BrowserType {
      */
     public Boolean acceptDownloads;
     /**
-     * Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
-     * href="http://peter.sh/experiments/chromium-command-line-switches/">here</a>.
+     * <strong>NOTE:</strong> Use custom browser args at your own risk, as some of them may break Playwright functionality.
+     *
+     * <p> Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
+     * href="https://peter.sh/experiments/chromium-command-line-switches/">here</a>.
      */
     public List<String> args;
     /**
@@ -382,7 +431,7 @@ public interface BrowserType {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -394,7 +443,7 @@ public interface BrowserType {
      */
     public String baseURL;
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public Boolean bypassCSP;
     /**
@@ -440,9 +489,14 @@ public interface BrowserType {
      */
     public Path executablePath;
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public Map<String, String> extraHTTPHeaders;
+    /**
+     * Firefox user preferences. Learn more about the Firefox user preferences at <a
+     * href="https://support.mozilla.org/en-US/kb/about-config-editor-firefox">{@code about:config}</a>.
+     */
+    public Map<String, Object> firefoxUserPrefs;
     /**
      * Emulates {@code "forced-colors"} media feature, supported values are {@code "active"}, {@code "none"}. See {@link
      * Page#emulateMedia Page.emulateMedia()} for more details. Passing {@code null} resets emulation to system defaults.
@@ -496,7 +550,7 @@ public interface BrowserType {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public Boolean isMobile;
     /**
@@ -506,8 +560,9 @@ public interface BrowserType {
     public Boolean javaScriptEnabled;
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public String locale;
     /**
@@ -517,7 +572,7 @@ public interface BrowserType {
     public Boolean offline;
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public List<String> permissions;
     /**
@@ -585,7 +640,8 @@ public interface BrowserType {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public Boolean strictSelectors;
     /**
@@ -596,7 +652,7 @@ public interface BrowserType {
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public String timezoneId;
     /**
@@ -608,8 +664,8 @@ public interface BrowserType {
      */
     public String userAgent;
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -625,8 +681,10 @@ public interface BrowserType {
       return this;
     }
     /**
-     * Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
-     * href="http://peter.sh/experiments/chromium-command-line-switches/">here</a>.
+     * <strong>NOTE:</strong> Use custom browser args at your own risk, as some of them may break Playwright functionality.
+     *
+     * <p> Additional arguments to pass to the browser instance. The list of Chromium flags can be found <a
+     * href="https://peter.sh/experiments/chromium-command-line-switches/">here</a>.
      */
     public LaunchPersistentContextOptions setArgs(List<String> args) {
       this.args = args;
@@ -637,7 +695,7 @@ public interface BrowserType {
      * Page.waitForURL()}, {@link Page#waitForRequest Page.waitForRequest()}, or {@link Page#waitForResponse
      * Page.waitForResponse()} it takes the base URL in consideration by using the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/API/URL/URL">{@code URL()}</a> constructor for building the
-     * corresponding URL. Examples:
+     * corresponding URL. Unset by default. Examples:
      * <ul>
      * <li> baseURL: {@code http://localhost:3000} and navigating to {@code /bar.html} results in {@code
      * http://localhost:3000/bar.html}</li>
@@ -652,7 +710,7 @@ public interface BrowserType {
       return this;
     }
     /**
-     * Toggles bypassing page's Content-Security-Policy.
+     * Toggles bypassing page's Content-Security-Policy. Defaults to {@code false}.
      */
     public LaunchPersistentContextOptions setBypassCSP(boolean bypassCSP) {
       this.bypassCSP = bypassCSP;
@@ -735,12 +793,20 @@ public interface BrowserType {
       return this;
     }
     /**
-     * An object containing additional HTTP headers to be sent with every request.
+     * An object containing additional HTTP headers to be sent with every request. Defaults to none.
      */
     public LaunchPersistentContextOptions setExtraHTTPHeaders(Map<String, String> extraHTTPHeaders) {
       this.extraHTTPHeaders = extraHTTPHeaders;
       return this;
     }
+    /**
+     * Firefox user preferences. Learn more about the Firefox user preferences at <a
+     * href="https://support.mozilla.org/en-US/kb/about-config-editor-firefox">{@code about:config}</a>.
+     */
+    public LaunchPersistentContextOptions setFirefoxUserPrefs(Map<String, Object> firefoxUserPrefs) {
+      this.firefoxUserPrefs = firefoxUserPrefs;
+      return this;
+    }
     /**
      * Emulates {@code "forced-colors"} media feature, supported values are {@code "active"}, {@code "none"}. See {@link
      * Page#emulateMedia Page.emulateMedia()} for more details. Passing {@code null} resets emulation to system defaults.
@@ -837,7 +903,7 @@ public interface BrowserType {
     /**
      * Whether the {@code meta viewport} tag is taken into account and touch events are enabled. isMobile is a part of device,
      * so you don't actually need to set it manually. Defaults to {@code false} and is not supported in Firefox. Learn more
-     * about <a href="https://playwright.dev/java/docs/emulation#isMobile">mobile emulation</a>.
+     * about <a href="https://playwright.dev/java/docs/emulation#ismobile">mobile emulation</a>.
      */
     public LaunchPersistentContextOptions setIsMobile(boolean isMobile) {
       this.isMobile = isMobile;
@@ -853,8 +919,9 @@ public interface BrowserType {
     }
     /**
      * Specify user locale, for example {@code en-GB}, {@code de-DE}, etc. Locale will affect {@code navigator.language} value,
-     * {@code Accept-Language} request header value as well as number and date formatting rules. Learn more about emulation in
-     * our <a href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
+     * {@code Accept-Language} request header value as well as number and date formatting rules. Defaults to the system default
+     * locale. Learn more about emulation in our <a
+     * href="https://playwright.dev/java/docs/emulation#locale--timezone">emulation guide</a>.
      */
     public LaunchPersistentContextOptions setLocale(String locale) {
       this.locale = locale;
@@ -870,7 +937,7 @@ public interface BrowserType {
     }
     /**
      * A list of permissions to grant to all pages in this context. See {@link BrowserContext#grantPermissions
-     * BrowserContext.grantPermissions()} for more details.
+     * BrowserContext.grantPermissions()} for more details. Defaults to none.
      */
     public LaunchPersistentContextOptions setPermissions(List<String> permissions) {
       this.permissions = permissions;
@@ -1002,7 +1069,8 @@ public interface BrowserType {
     /**
      * If set to true, enables strict selectors mode for this context. In the strict selectors mode all operations on selectors
      * that imply single target DOM element will throw when more than one element matches the selector. This option does not
-     * affect any Locator APIs (Locators are always strict). See {@code Locator} to learn more about the strict mode.
+     * affect any Locator APIs (Locators are always strict). Defaults to {@code false}. See {@code Locator} to learn more about
+     * the strict mode.
      */
     public LaunchPersistentContextOptions setStrictSelectors(boolean strictSelectors) {
       this.strictSelectors = strictSelectors;
@@ -1019,7 +1087,7 @@ public interface BrowserType {
     /**
      * Changes the timezone of the context. See <a
      * href="https://cs.chromium.org/chromium/src/third_party/icu/source/data/misc/metaZones.txt?rcl=faee8bc70570192d82d2978a71e2a615788597d1">ICU's
-     * metaZones.txt</a> for a list of supported timezone IDs.
+     * metaZones.txt</a> for a list of supported timezone IDs. Defaults to the system timezone.
      */
     public LaunchPersistentContextOptions setTimezoneId(String timezoneId) {
       this.timezoneId = timezoneId;
@@ -1040,8 +1108,8 @@ public interface BrowserType {
       return this;
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the
@@ -1051,8 +1119,8 @@ public interface BrowserType {
       return setViewportSize(new ViewportSize(width, height));
     }
     /**
-     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport.  Use {@code null} to disable the
-     * consistent viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
+     * Emulates consistent viewport for each page. Defaults to an 1280x720 viewport. Use {@code null} to disable the consistent
+     * viewport emulation. Learn more about <a href="https://playwright.dev/java/docs/emulation#viewport">viewport
      * emulation</a>.
      *
      * <p> <strong>NOTE:</strong> The {@code null} value opts out from the default presets, makes viewport depend on the host window size defined by the

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

@@ -0,0 +1,94 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.microsoft.playwright;
+
+import java.util.function.Consumer;
+import com.google.gson.JsonObject;
+
+/**
+ * The {@code CDPSession} instances are used to talk raw Chrome Devtools Protocol:
+ * <ul>
+ * <li> protocol methods can be called with {@code session.send} method.</li>
+ * <li> protocol events can be subscribed to with {@code session.on} method.</li>
+ * </ul>
+ *
+ * <p> Useful links:
+ * <ul>
+ * <li> Documentation on DevTools Protocol can be found here: <a
+ * href="https://chromedevtools.github.io/devtools-protocol/">DevTools Protocol Viewer</a>.</li>
+ * <li> Getting Started with DevTools Protocol: https://github.com/aslushnikov/getting-started-with-cdp/blob/master/README.md</li>
+ * <pre>{@code
+ * CDPSession client = page.context().newCDPSession(page);
+ * client.send("Runtime.enable");
+ *
+ * client.on("Animation.animationCreated", (event) -> System.out.println("Animation created!"));
+ *
+ * JsonObject response = client.send("Animation.getPlaybackRate");
+ * double playbackRate = response.get("playbackRate").getAsDouble();
+ * System.out.println("playback rate is " + playbackRate);
+ *
+ * JsonObject params = new JsonObject();
+ * params.addProperty("playbackRate", playbackRate / 2);
+ * client.send("Animation.setPlaybackRate", params);
+ * }</pre>
+ * </ul>
+ */
+public interface CDPSession {
+  /**
+   * Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be used to
+   * send messages.
+   *
+   * @since v1.8
+   */
+  void detach();
+  /**
+   *
+   *
+   * @param method Protocol method name.
+   * @since v1.8
+   */
+  default JsonObject send(String method) {
+    return send(method, null);
+  }
+  /**
+   *
+   *
+   * @param method Protocol method name.
+   * @param args Optional method parameters.
+   * @since v1.8
+   */
+  JsonObject send(String method, JsonObject args);
+  /**
+   * Register an event handler for events with the specified event name. The given handler will be called for every event
+   * with the given name.
+   *
+   * @param eventName CDP event name.
+   * @param handler Event handler.
+   * @since v1.37
+   */
+  void on(String eventName, Consumer<JsonObject> handler);
+  /**
+   * Unregister an event handler for events with the specified event name. The given handler will not be called anymore for
+   * events with the given name.
+   *
+   * @param eventName CDP event name.
+   * @param handler Event handler.
+   * @since v1.37
+   */
+  void off(String eventName, Consumer<JsonObject> handler);
+}
+

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

@@ -59,7 +59,7 @@ public interface ConsoleMessage {
   /**
    * The page that produced this console message, if any.
    *
-   * @since v1.33
+   * @since v1.34
    */
   Page page();
   /**

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

@@ -84,7 +84,7 @@ public interface Dialog {
   /**
    * The page that initiated this dialog, if available.
    *
-   * @since v1.33
+   * @since v1.34
    */
   Page page();
   /**

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

@@ -24,14 +24,16 @@ import java.nio.file.Path;
  *
  * <p> All the downloaded files belonging to the browser context are deleted when the browser context is closed.
  *
- * <p> Download event is emitted once the download starts. Download path becomes available once download completes:
+ * <p> Download event is emitted once the download starts. Download path becomes available once download completes.
  * <pre>{@code
- * // wait for download to start
+ * // Wait for the download to start
  * Download download = page.waitForDownload(() -> {
- *   page.getByText("Download file").click();
+ *     // Perform the action that initiates download
+ *     page.getByText("Download file").click();
  * });
- * // wait for download to complete
- * Path path = download.path();
+ *
+ * // Wait for the download process to complete and save the downloaded file somewhere
+ * download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));
  * }</pre>
  */
 public interface Download {
@@ -43,7 +45,7 @@ public interface Download {
    */
   void cancel();
   /**
-   * Returns readable stream for current download or {@code null} if download failed.
+   * Returns a readable stream for a successful download, or throws for a failed/canceled download.
    *
    * @since v1.8
    */
@@ -67,8 +69,8 @@ public interface Download {
    */
   Page page();
   /**
-   * Returns path to the downloaded file in case of successful download. The method will wait for the download to finish if
-   * necessary. The method throws when connected remotely.
+   * Returns path to the downloaded file for a successful download, or throws for a failed/canceled download. The method will
+   * wait for the download to finish if necessary. The method throws when connected remotely.
    *
    * <p> Note that the download's file name is a random GUID, use {@link Download#suggestedFilename Download.suggestedFilename()}
    * to get suggested file name.
@@ -80,6 +82,11 @@ public interface Download {
    * Copy the download to a user-specified path. It is safe to call this method while the download is still in progress. Will
    * wait for the download to finish if necessary.
    *
+   * <p> **Usage**
+   * <pre>{@code
+   * download.saveAs(Paths.get("/path/to/save/at/", download.suggestedFilename()));
+   * }</pre>
+   *
    * @param path Path where the download should be copied.
    * @since v1.8
    */

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

@@ -602,9 +602,15 @@ public interface ElementHandle extends JSHandle {
     public ScreenshotCaret caret;
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public List<Locator> mask;
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public String maskColor;
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -628,6 +634,12 @@ public interface ElementHandle extends JSHandle {
      * <p> Defaults to {@code "device"}.
      */
     public ScreenshotScale scale;
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public String style;
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -663,12 +675,21 @@ public interface ElementHandle extends JSHandle {
     }
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public ScreenshotOptions setMask(List<Locator> mask) {
       this.mask = mask;
       return this;
     }
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public ScreenshotOptions setMaskColor(String maskColor) {
+      this.maskColor = maskColor;
+      return this;
+    }
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -704,6 +725,15 @@ public interface ElementHandle extends JSHandle {
       this.scale = scale;
       return this;
     }
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public ScreenshotOptions setStyle(String style) {
+      this.style = style;
+      return this;
+    }
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -1396,13 +1426,17 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -1436,13 +1470,17 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -1567,7 +1605,7 @@ public interface ElementHandle extends JSHandle {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link ElementHandle#type ElementHandle.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param value Value to set for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
    * @since v1.8
@@ -1585,7 +1623,7 @@ public interface ElementHandle extends JSHandle {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link ElementHandle#type ElementHandle.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param value Value to set for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
    * @since v1.8
@@ -1863,7 +1901,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -1894,7 +1932,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -1923,7 +1961,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -1954,7 +1992,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -1983,7 +2021,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2014,7 +2052,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2043,7 +2081,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2074,7 +2112,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2103,7 +2141,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2134,7 +2172,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2163,7 +2201,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2194,7 +2232,7 @@ public interface ElementHandle extends JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * handle.selectOption("blue");
    * // single selection matching the label
    * handle.selectOption(new SelectOption().setLabel("Blue"));
@@ -2435,24 +2473,9 @@ public interface ElementHandle extends JSHandle {
    */
   String textContent();
   /**
-   * Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
-   * character in the text.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link ElementHandle#press
-   * ElementHandle.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * elementHandle.type("Hello"); // Types instantly
-   * elementHandle.type("World", new ElementHandle.TypeOptions().setDelay(100)); // Types slower, like a user
-   * }</pre>
-   *
-   * <p> An example of typing into a text field and then submitting the form:
-   * <pre>{@code
-   * ElementHandle elementHandle = page.querySelector("input");
-   * elementHandle.type("some text");
-   * elementHandle.press("Enter");
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param text A text to type into a focused element.
    * @since v1.8
@@ -2461,24 +2484,9 @@ public interface ElementHandle extends JSHandle {
     type(text, null);
   }
   /**
-   * Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
-   * character in the text.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link ElementHandle#press
-   * ElementHandle.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * elementHandle.type("Hello"); // Types instantly
-   * elementHandle.type("World", new ElementHandle.TypeOptions().setDelay(100)); // Types slower, like a user
-   * }</pre>
-   *
-   * <p> An example of typing into a text field and then submitting the form:
-   * <pre>{@code
-   * ElementHandle elementHandle = page.querySelector("input");
-   * elementHandle.type("some text");
-   * elementHandle.press("Enter");
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param text A text to type into a focused element.
    * @since v1.8
@@ -2538,8 +2546,7 @@ public interface ElementHandle extends JSHandle {
    * <li> {@code "visible"} Wait until the element is <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a>.</li>
    * <li> {@code "hidden"} Wait until the element is <a href="https://playwright.dev/java/docs/actionability#visible">not
-   * visible</a> or <a href="https://playwright.dev/java/docs/actionability#attached">not attached</a>. Note that waiting for
-   * hidden does not throw when the element detaches.</li>
+   * visible</a> or not attached. Note that waiting for hidden does not throw when the element detaches.</li>
    * <li> {@code "stable"} Wait until the element is both <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a> and <a
    * href="https://playwright.dev/java/docs/actionability#stable">stable</a>.</li>
@@ -2569,8 +2576,7 @@ public interface ElementHandle extends JSHandle {
    * <li> {@code "visible"} Wait until the element is <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a>.</li>
    * <li> {@code "hidden"} Wait until the element is <a href="https://playwright.dev/java/docs/actionability#visible">not
-   * visible</a> or <a href="https://playwright.dev/java/docs/actionability#attached">not attached</a>. Note that waiting for
-   * hidden does not throw when the element detaches.</li>
+   * visible</a> or not attached. Note that waiting for hidden does not throw when the element detaches.</li>
    * <li> {@code "stable"} Wait until the element is both <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a> and <a
    * href="https://playwright.dev/java/docs/actionability#stable">stable</a>.</li>

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

@@ -1470,8 +1470,14 @@ public interface Frame {
   }
   class LocatorOptions {
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -1497,8 +1503,14 @@ public interface Frame {
     public Object hasText;
 
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -2582,13 +2594,17 @@ public interface Frame {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2624,13 +2640,17 @@ public interface Frame {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2665,13 +2685,17 @@ public interface Frame {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2987,7 +3011,7 @@ public interface Frame {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Frame#type Frame.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param value Value to fill for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
@@ -3006,7 +3030,7 @@ public interface Frame {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Frame#type Frame.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param value Value to fill for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
@@ -4058,7 +4082,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4091,7 +4115,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4122,7 +4146,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4155,7 +4179,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4186,7 +4210,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4219,7 +4243,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4250,7 +4274,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4283,7 +4307,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4314,7 +4338,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4347,7 +4371,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4378,7 +4402,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4411,7 +4435,7 @@ public interface Frame {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * frame.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * frame.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -4473,7 +4497,9 @@ public interface Frame {
    */
   void setChecked(String selector, boolean checked, SetCheckedOptions options);
   /**
-   *
+   * This method internally calls <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Document/write">document.write()</a>, inheriting all its specific
+   * characteristics and behaviors.
    *
    * @param html HTML markup to assign to the page.
    * @since v1.8
@@ -4482,7 +4508,9 @@ public interface Frame {
     setContent(html, null);
   }
   /**
-   *
+   * This method internally calls <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Document/write">document.write()</a>, inheriting all its specific
+   * characteristics and behaviors.
    *
    * @param html HTML markup to assign to the page.
    * @since v1.8
@@ -4673,19 +4701,9 @@ public interface Frame {
    */
   String title();
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text. {@code
-   * frame.type} can be used to send fine-grained keyboard events. To fill values in form fields, use {@link Frame#fill
-   * Frame.fill()}.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * // Types instantly
-   * frame.type("#mytextarea", "Hello");
-   * // Types slower, like a user
-   * frame.type("#mytextarea", "World", new Frame.TypeOptions().setDelay(100));
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param text A text to type into a focused element.
@@ -4695,19 +4713,9 @@ public interface Frame {
     type(selector, text, null);
   }
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text. {@code
-   * frame.type} can be used to send fine-grained keyboard events. To fill values in form fields, use {@link Frame#fill
-   * Frame.fill()}.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * // Types instantly
-   * frame.type("#mytextarea", "Hello");
-   * // Types slower, like a user
-   * frame.type("#mytextarea", "World", new Frame.TypeOptions().setDelay(100));
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param text A text to type into a focused element.

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

@@ -285,8 +285,14 @@ public interface FrameLocator {
   }
   class LocatorOptions {
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -312,8 +318,14 @@ public interface FrameLocator {
     public Object hasText;
 
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */

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

@@ -135,7 +135,7 @@ public interface JSHandle {
    *
    * <p> **Usage**
    * <pre>{@code
-   * JSHandle handle = page.evaluateHandle("() => ({window, document})");
+   * JSHandle handle = page.evaluateHandle("() => ({ window, document })");
    * Map<String, JSHandle> properties = handle.getProperties();
    * JSHandle windowHandle = properties.get("window");
    * JSHandle documentHandle = properties.get("document");

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

@@ -132,7 +132,9 @@ public interface Keyboard {
    */
   void insertText(String text);
   /**
-   * {@code key} can specify the intended <a
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#press Locator.press()} instead.
+   *
+   * <p> {@code key} can specify the intended <a
    * href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key">keyboardEvent.key</a> value or a single
    * character to generate the text for. A superset of the {@code key} values can be found <a
    * href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values">here</a>. Examples of the keys are:
@@ -175,7 +177,9 @@ public interface Keyboard {
     press(key, null);
   }
   /**
-   * {@code key} can specify the intended <a
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#press Locator.press()} instead.
+   *
+   * <p> {@code key} can specify the intended <a
    * href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key">keyboardEvent.key</a> value or a single
    * character to generate the text for. A superset of the {@code key} values can be found <a
    * href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key/Key_Values">here</a>. Examples of the keys are:
@@ -216,7 +220,11 @@ public interface Keyboard {
    */
   void press(String key, PressOptions options);
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text.
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
+   *
+   * <p> Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text.
    *
    * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
    *
@@ -239,7 +247,11 @@ public interface Keyboard {
     type(text, null);
   }
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text.
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
+   *
+   * <p> Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text.
    *
    * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
    *

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

@@ -23,7 +23,7 @@ import java.util.regex.Pattern;
 
 /**
  * Locators are the central piece of Playwright's auto-waiting and retry-ability. In a nutshell, locators represent a way
- * to find element(s) on the page at any moment. Locator can be created with the {@link Page#locator Page.locator()}
+ * to find element(s) on the page at any moment. A locator can be created with the {@link Page#locator Page.locator()}
  * method.
  *
  * <p> <a href="https://playwright.dev/java/docs/locators">Learn more about locators</a>.
@@ -656,8 +656,14 @@ public interface Locator {
   }
   class FilterOptions {
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -683,8 +689,14 @@ public interface Locator {
     public Object hasText;
 
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -1262,8 +1274,14 @@ public interface Locator {
   }
   class LocatorOptions {
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -1289,8 +1307,14 @@ public interface Locator {
     public Object hasText;
 
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -1388,6 +1412,50 @@ public interface Locator {
       return this;
     }
   }
+  class PressSequentiallyOptions {
+    /**
+     * Time to wait between key presses in milliseconds. Defaults to 0.
+     */
+    public Double delay;
+    /**
+     * Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+     * opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+     * inaccessible pages. Defaults to {@code false}.
+     */
+    public Boolean noWaitAfter;
+    /**
+     * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
+     * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
+     * Page#setDefaultTimeout Page.setDefaultTimeout()} methods.
+     */
+    public Double timeout;
+
+    /**
+     * Time to wait between key presses in milliseconds. Defaults to 0.
+     */
+    public PressSequentiallyOptions setDelay(double delay) {
+      this.delay = delay;
+      return this;
+    }
+    /**
+     * Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can
+     * opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to
+     * inaccessible pages. Defaults to {@code false}.
+     */
+    public PressSequentiallyOptions setNoWaitAfter(boolean noWaitAfter) {
+      this.noWaitAfter = noWaitAfter;
+      return this;
+    }
+    /**
+     * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
+     * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
+     * Page#setDefaultTimeout Page.setDefaultTimeout()} methods.
+     */
+    public PressSequentiallyOptions setTimeout(double timeout) {
+      this.timeout = timeout;
+      return this;
+    }
+  }
   class ScreenshotOptions {
     /**
      * When set to {@code "disabled"}, stops CSS animations, CSS transitions and Web Animations. Animations get different
@@ -1407,9 +1475,15 @@ public interface Locator {
     public ScreenshotCaret caret;
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public List<Locator> mask;
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public String maskColor;
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -1433,6 +1507,12 @@ public interface Locator {
      * <p> Defaults to {@code "device"}.
      */
     public ScreenshotScale scale;
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public String style;
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -1468,12 +1548,21 @@ public interface Locator {
     }
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public ScreenshotOptions setMask(List<Locator> mask) {
       this.mask = mask;
       return this;
     }
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public ScreenshotOptions setMaskColor(String maskColor) {
+      this.maskColor = maskColor;
+      return this;
+    }
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -1509,6 +1598,15 @@ public interface Locator {
       this.scale = scale;
       return this;
     }
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public ScreenshotOptions setStyle(String style) {
+      this.style = style;
+      return this;
+    }
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -2018,7 +2116,7 @@ public interface Locator {
     }
   }
   /**
-   * When locator points to a list of elements, returns array of locators, pointing to respective elements.
+   * When the locator points to a list of elements, this returns an array of locators, pointing to their respective elements.
    *
    * <p> <strong>NOTE:</strong> {@link Locator#all Locator.all()} does not wait for elements to match the locator, and instead immediately returns
    * whatever is present in the page.  When the list of elements changes dynamically, {@link Locator#all Locator.all()} will
@@ -2037,6 +2135,10 @@ public interface Locator {
   /**
    * Returns an array of {@code node.innerText} values for all matching nodes.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} with {@code
+   * useInnerText} option to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions
+   * guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * String[] texts = page.getByRole(AriaRole.LINK).allInnerTexts();
@@ -2048,6 +2150,9 @@ public interface Locator {
   /**
    * Returns an array of {@code node.textContent} values for all matching nodes.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} to avoid
+   * flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * String[] texts = page.getByRole(AriaRole.LINK).allTextContents();
@@ -2067,7 +2172,7 @@ public interface Locator {
    * }</pre>
    *
    * @param locator Additional locator to match.
-   * @since v1.33
+   * @since v1.34
    */
   Locator and(Locator locator);
   /**
@@ -2321,6 +2426,10 @@ public interface Locator {
   /**
    * Returns the number of elements matching the locator.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert the number of elements on the page, prefer {@link LocatorAssertions#hasCount
+   * LocatorAssertions.hasCount()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * int count = page.getByRole(AriaRole.LISTITEM).count();
@@ -2401,13 +2510,17 @@ public interface Locator {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2446,13 +2559,17 @@ public interface Locator {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2490,13 +2607,17 @@ public interface Locator {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -2817,7 +2938,7 @@ public interface Locator {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Locator#type Locator.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param value Value to set for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
    * @since v1.14
@@ -2844,7 +2965,7 @@ public interface Locator {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Locator#type Locator.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param value Value to set for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
    * @since v1.14
@@ -2927,6 +3048,10 @@ public interface Locator {
   /**
    * Returns the matching element's attribute value.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert an element's attribute, prefer {@link LocatorAssertions#hasAttribute
+   * LocatorAssertions.hasAttribute()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * @param name Attribute name to get the value for.
    * @since v1.14
    */
@@ -2936,6 +3061,10 @@ public interface Locator {
   /**
    * Returns the matching element's attribute value.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert an element's attribute, prefer {@link LocatorAssertions#hasAttribute
+   * LocatorAssertions.hasAttribute()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * @param name Attribute name to get the value for.
    * @since v1.14
    */
@@ -3575,6 +3704,10 @@ public interface Locator {
    * Returns the <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText">{@code
    * element.innerText}</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} with {@code
+   * useInnerText} option to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions
+   * guide</a> for more details.
+   *
    * @since v1.14
    */
   default String innerText() {
@@ -3584,12 +3717,19 @@ public interface Locator {
    * Returns the <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/innerText">{@code
    * element.innerText}</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} with {@code
+   * useInnerText} option to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions
+   * guide</a> for more details.
+   *
    * @since v1.14
    */
   String innerText(InnerTextOptions options);
   /**
    * Returns the value for the matching {@code <input>} or {@code <textarea>} or {@code <select>} element.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert input value, prefer {@link LocatorAssertions#hasValue LocatorAssertions.hasValue()} to avoid
+   * flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * String value = page.getByRole(AriaRole.TEXTBOX).inputValue();
@@ -3610,6 +3750,9 @@ public interface Locator {
   /**
    * Returns the value for the matching {@code <input>} or {@code <textarea>} or {@code <select>} element.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert input value, prefer {@link LocatorAssertions#hasValue LocatorAssertions.hasValue()} to avoid
+   * flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * String value = page.getByRole(AriaRole.TEXTBOX).inputValue();
@@ -3628,6 +3771,10 @@ public interface Locator {
   /**
    * Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that checkbox is checked, prefer {@link LocatorAssertions#isChecked LocatorAssertions.isChecked()}
+   * to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more
+   * details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean checked = page.getByRole(AriaRole.CHECKBOX).isChecked();
@@ -3641,6 +3788,10 @@ public interface Locator {
   /**
    * Returns whether the element is checked. Throws if the element is not a checkbox or radio input.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that checkbox is checked, prefer {@link LocatorAssertions#isChecked LocatorAssertions.isChecked()}
+   * to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more
+   * details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean checked = page.getByRole(AriaRole.CHECKBOX).isChecked();
@@ -3653,6 +3804,10 @@ public interface Locator {
    * Returns whether the element is disabled, the opposite of <a
    * href="https://playwright.dev/java/docs/actionability#enabled">enabled</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is disabled, prefer {@link LocatorAssertions#isDisabled
+   * LocatorAssertions.isDisabled()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean disabled = page.getByRole(AriaRole.BUTTON).isDisabled();
@@ -3667,6 +3822,10 @@ public interface Locator {
    * Returns whether the element is disabled, the opposite of <a
    * href="https://playwright.dev/java/docs/actionability#enabled">enabled</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is disabled, prefer {@link LocatorAssertions#isDisabled
+   * LocatorAssertions.isDisabled()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean disabled = page.getByRole(AriaRole.BUTTON).isDisabled();
@@ -3678,6 +3837,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#editable">editable</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is editable, prefer {@link LocatorAssertions#isEditable
+   * LocatorAssertions.isEditable()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean editable = page.getByRole(AriaRole.TEXTBOX).isEditable();
@@ -3691,6 +3854,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#editable">editable</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is editable, prefer {@link LocatorAssertions#isEditable
+   * LocatorAssertions.isEditable()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean editable = page.getByRole(AriaRole.TEXTBOX).isEditable();
@@ -3702,6 +3869,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#enabled">enabled</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is enabled, prefer {@link LocatorAssertions#isEnabled
+   * LocatorAssertions.isEnabled()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean enabled = page.getByRole(AriaRole.BUTTON).isEnabled();
@@ -3715,6 +3886,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#enabled">enabled</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that an element is enabled, prefer {@link LocatorAssertions#isEnabled
+   * LocatorAssertions.isEnabled()} to avoid flakiness. See <a
+   * href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean enabled = page.getByRole(AriaRole.BUTTON).isEnabled();
@@ -3727,6 +3902,9 @@ public interface Locator {
    * Returns whether the element is hidden, the opposite of <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that element is hidden, prefer {@link LocatorAssertions#isHidden LocatorAssertions.isHidden()} to
+   * avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean hidden = page.getByRole(AriaRole.BUTTON).isHidden();
@@ -3741,6 +3919,9 @@ public interface Locator {
    * Returns whether the element is hidden, the opposite of <a
    * href="https://playwright.dev/java/docs/actionability#visible">visible</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that element is hidden, prefer {@link LocatorAssertions#isHidden LocatorAssertions.isHidden()} to
+   * avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean hidden = page.getByRole(AriaRole.BUTTON).isHidden();
@@ -3752,6 +3933,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#visible">visible</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that element is visible, prefer {@link LocatorAssertions#isVisible LocatorAssertions.isVisible()}
+   * to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more
+   * details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean visible = page.getByRole(AriaRole.BUTTON).isVisible();
@@ -3765,6 +3950,10 @@ public interface Locator {
   /**
    * Returns whether the element is <a href="https://playwright.dev/java/docs/actionability#visible">visible</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert that element is visible, prefer {@link LocatorAssertions#isVisible LocatorAssertions.isVisible()}
+   * to avoid flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more
+   * details.
+   *
    * <p> **Usage**
    * <pre>{@code
    * boolean visible = page.getByRole(AriaRole.BUTTON).isVisible();
@@ -3941,6 +4130,60 @@ public interface Locator {
    * @since v1.14
    */
   void press(String key, PressOptions options);
+  /**
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page.
+   *
+   * <p> Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
+   * character in the text.
+   *
+   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Locator#press Locator.press()}.
+   *
+   * <p> **Usage**
+   * <pre>{@code
+   * locator.pressSequentially("Hello"); // Types instantly
+   * locator.pressSequentially("World", new Locator.pressSequentiallyOptions().setDelay(100)); // Types slower, like a user
+   * }</pre>
+   *
+   * <p> An example of typing into a text field and then submitting the form:
+   * <pre>{@code
+   * Locator locator = page.getByLabel("Password");
+   * locator.pressSequentially("my password");
+   * locator.press("Enter");
+   * }</pre>
+   *
+   * @param text String of characters to sequentially press into a focused element.
+   * @since v1.38
+   */
+  default void pressSequentially(String text) {
+    pressSequentially(text, null);
+  }
+  /**
+   * <strong>NOTE:</strong> In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page.
+   *
+   * <p> Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
+   * character in the text.
+   *
+   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Locator#press Locator.press()}.
+   *
+   * <p> **Usage**
+   * <pre>{@code
+   * locator.pressSequentially("Hello"); // Types instantly
+   * locator.pressSequentially("World", new Locator.pressSequentiallyOptions().setDelay(100)); // Types slower, like a user
+   * }</pre>
+   *
+   * <p> An example of typing into a text field and then submitting the form:
+   * <pre>{@code
+   * Locator locator = page.getByLabel("Password");
+   * locator.pressSequentially("my password");
+   * locator.press("Enter");
+   * }</pre>
+   *
+   * @param text String of characters to sequentially press into a focused element.
+   * @since v1.38
+   */
+  void pressSequentially(String text, PressSequentiallyOptions options);
   /**
    * Take a screenshot of the element matching the locator.
    *
@@ -4838,6 +5081,9 @@ public interface Locator {
   /**
    * Returns the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent">{@code node.textContent}</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} to avoid
+   * flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * @since v1.14
    */
   default String textContent() {
@@ -4846,27 +5092,16 @@ public interface Locator {
   /**
    * Returns the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent">{@code node.textContent}</a>.
    *
+   * <p> <strong>NOTE:</strong> If you need to assert text on the page, prefer {@link LocatorAssertions#hasText LocatorAssertions.hasText()} to avoid
+   * flakiness. See <a href="https://playwright.dev/java/docs/test-assertions">assertions guide</a> for more details.
+   *
    * @since v1.14
    */
   String textContent(TextContentOptions options);
   /**
-   * Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
-   * character in the text.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Locator#press Locator.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * element.type("Hello"); // Types instantly
-   * element.type("World", new Locator.TypeOptions().setDelay(100)); // Types slower, like a user
-   * }</pre>
-   *
-   * <p> An example of typing into a text field and then submitting the form:
-   * <pre>{@code
-   * Locator element = page.getByLabel("Password");
-   * element.type("my password");
-   * element.press("Enter");
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param text A text to type into a focused element.
    * @since v1.14
@@ -4875,23 +5110,9 @@ public interface Locator {
     type(text, null);
   }
   /**
-   * Focuses the element, and then sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each
-   * character in the text.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Locator#press Locator.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * element.type("Hello"); // Types instantly
-   * element.type("World", new Locator.TypeOptions().setDelay(100)); // Types slower, like a user
-   * }</pre>
-   *
-   * <p> An example of typing into a text field and then submitting the form:
-   * <pre>{@code
-   * Locator element = page.getByLabel("Password");
-   * element.type("my password");
-   * element.press("Enter");
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param text A text to type into a focused element.
    * @since v1.14

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

@@ -650,12 +650,23 @@ public interface Page extends AutoCloseable {
     }
   }
   class CloseOptions {
+    /**
+     * The reason to be reported to the operations interrupted by the page closure.
+     */
+    public String reason;
     /**
      * Defaults to {@code false}. Whether to run the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload">before unload</a> page handlers.
      */
     public Boolean runBeforeUnload;
 
+    /**
+     * The reason to be reported to the operations interrupted by the page closure.
+     */
+    public CloseOptions setReason(String reason) {
+      this.reason = reason;
+      return this;
+    }
     /**
      * Defaults to {@code false}. Whether to run the <a
      * href="https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload">before unload</a> page handlers.
@@ -1913,8 +1924,14 @@ public interface Page extends AutoCloseable {
   }
   class LocatorOptions {
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -1940,8 +1957,14 @@ public interface Page extends AutoCloseable {
     public Object hasText;
 
     /**
-     * Matches elements containing an element that matches an inner locator. Inner locator is queried against the outer one.
-     * For example, {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     * Narrows down the results of the method to those which contain elements matching this relative locator. For example,
+     * {@code article} that has {@code text=Playwright} matches {@code <article><div>Playwright</div></article>}.
+     *
+     * <p> Inner locator **must be relative** to the outer locator and is queried starting with the outer locator match, not the
+     * document root. For example, you can find {@code content} that has {@code div} in {@code
+     * <article><content><div>Playwright</div></content></article>}. However, looking for {@code content} that has {@code
+     * article div} will fail, because the inner locator must be relative and should not use any elements outside the {@code
+     * content}.
      *
      * <p> Note that outer and inner locators must belong to the same frame. Inner locator must not contain {@code FrameLocator}s.
      */
@@ -2407,9 +2430,15 @@ public interface Page extends AutoCloseable {
     public Boolean fullPage;
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public List<Locator> mask;
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public String maskColor;
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -2433,6 +2462,12 @@ public interface Page extends AutoCloseable {
      * <p> Defaults to {@code "device"}.
      */
     public ScreenshotScale scale;
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public String style;
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -2489,12 +2524,21 @@ public interface Page extends AutoCloseable {
     }
     /**
      * Specify locators that should be masked when the screenshot is taken. Masked elements will be overlaid with a pink box
-     * {@code #FF00FF} that completely covers its bounding box.
+     * {@code #FF00FF} (customized by {@code maskColor}) that completely covers its bounding box.
      */
     public ScreenshotOptions setMask(List<Locator> mask) {
       this.mask = mask;
       return this;
     }
+    /**
+     * Specify the color of the overlay box for masked elements, in <a
+     * href="https://developer.mozilla.org/en-US/docs/Web/CSS/color_value">CSS color format</a>. Default color is pink {@code
+     * #FF00FF}.
+     */
+    public ScreenshotOptions setMaskColor(String maskColor) {
+      this.maskColor = maskColor;
+      return this;
+    }
     /**
      * Hides default white background and allows capturing screenshots with transparency. Not applicable to {@code jpeg}
      * images. Defaults to {@code false}.
@@ -2530,6 +2574,15 @@ public interface Page extends AutoCloseable {
       this.scale = scale;
       return this;
     }
+    /**
+     * Text of the stylesheet to apply while making the screenshot. This is where you can hide dynamic elements, make elements
+     * invisible or change their properties to help you creating repeatable screenshots. This stylesheet pierces the Shadow DOM
+     * and applies to the inner frames.
+     */
+    public ScreenshotOptions setStyle(String style) {
+      this.style = style;
+      return this;
+    }
     /**
      * Maximum time in milliseconds. Defaults to {@code 30000} (30 seconds). Pass {@code 0} to disable timeout. The default
      * value can be changed by using the {@link BrowserContext#setDefaultTimeout BrowserContext.setDefaultTimeout()} or {@link
@@ -3843,13 +3896,17 @@ public interface Page extends AutoCloseable {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -3885,13 +3942,17 @@ public interface Page extends AutoCloseable {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -3926,13 +3987,17 @@ public interface Page extends AutoCloseable {
    *
    * <p> Since {@code eventInit} is event-specific, please refer to the events documentation for the lists of initial properties:
    * <ul>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceMotionEvent/DeviceMotionEvent">DeviceMotionEvent</a></li>
+   * <li> <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/DeviceOrientationEvent/DeviceOrientationEvent">DeviceOrientationEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/DragEvent/DragEvent">DragEvent</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/FocusEvent/FocusEvent">FocusEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/KeyboardEvent">KeyboardEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/MouseEvent">MouseEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/PointerEvent/PointerEvent">PointerEvent</a></li>
    * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/TouchEvent/TouchEvent">TouchEvent</a></li>
-   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Event/Event">Event</a></li>
+   * <li> <a href="https://developer.mozilla.org/en-US/docs/Web/API/WheelEvent/WheelEvent">WheelEvent</a></li>
    * </ul>
    *
    * <p> You can also specify {@code JSHandle} as the property value if you want live objects to be passed into the event:
@@ -4520,7 +4585,7 @@ public interface Page extends AutoCloseable {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Page#type Page.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param value Value to fill for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
@@ -4539,7 +4604,7 @@ public interface Page extends AutoCloseable {
    * href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement/control">control</a>, the control will be filled
    * instead.
    *
-   * <p> To send fine-grained keyboard events, use {@link Page#type Page.type()}.
+   * <p> To send fine-grained keyboard events, use {@link Locator#pressSequentially Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param value Value to fill for the {@code <input>}, {@code <textarea>} or {@code [contenteditable]} element.
@@ -6186,7 +6251,7 @@ public interface Page extends AutoCloseable {
   void route(Predicate<String> url, Consumer<Route> handler, RouteOptions options);
   /**
    * If specified the network requests that are made in the page will be served from the HAR file. Read more about <a
-   * href="https://playwright.dev/java/docs/network#replaying-from-har">Replaying from HAR</a>.
+   * href="https://playwright.dev/java/docs/mock#replaying-from-har">Replaying from HAR</a>.
    *
    * <p> Playwright will not serve requests intercepted by Service Worker from the HAR file. See <a
    * href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers when
@@ -6201,7 +6266,7 @@ public interface Page extends AutoCloseable {
   }
   /**
    * If specified the network requests that are made in the page will be served from the HAR file. Read more about <a
-   * href="https://playwright.dev/java/docs/network#replaying-from-har">Replaying from HAR</a>.
+   * href="https://playwright.dev/java/docs/mock#replaying-from-har">Replaying from HAR</a>.
    *
    * <p> Playwright will not serve requests intercepted by Service Worker from the HAR file. See <a
    * href="https://github.com/microsoft/playwright/issues/1090">this</a> issue. We recommend disabling Service Workers when
@@ -6242,7 +6307,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6275,7 +6340,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6306,7 +6371,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6339,7 +6404,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6370,7 +6435,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6403,7 +6468,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6434,7 +6499,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6467,7 +6532,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6498,7 +6563,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6531,7 +6596,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6562,7 +6627,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6595,7 +6660,7 @@ public interface Page extends AutoCloseable {
    *
    * <p> **Usage**
    * <pre>{@code
-   * // single selection matching the value
+   * // Single selection matching the value or label
    * page.selectOption("select#colors", "blue");
    * // single selection matching both the value and the label
    * page.selectOption("select#colors", new SelectOption().setLabel("Blue"));
@@ -6657,7 +6722,9 @@ public interface Page extends AutoCloseable {
    */
   void setChecked(String selector, boolean checked, SetCheckedOptions options);
   /**
-   *
+   * This method internally calls <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Document/write">document.write()</a>, inheriting all its specific
+   * characteristics and behaviors.
    *
    * @param html HTML markup to assign to the page.
    * @since v1.8
@@ -6666,7 +6733,9 @@ public interface Page extends AutoCloseable {
     setContent(html, null);
   }
   /**
-   *
+   * This method internally calls <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Document/write">document.write()</a>, inheriting all its specific
+   * characteristics and behaviors.
    *
    * @param html HTML markup to assign to the page.
    * @since v1.8
@@ -6923,19 +6992,9 @@ public interface Page extends AutoCloseable {
    */
   Touchscreen touchscreen();
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text. {@code
-   * page.type} can be used to send fine-grained keyboard events. To fill values in form fields, use {@link Page#fill
-   * Page.fill()}.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * // Types instantly
-   * page.type("#mytextarea", "Hello");
-   * // Types slower, like a user
-   * page.type("#mytextarea", "World", new Page.TypeOptions().setDelay(100));
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param text A text to type into a focused element.
@@ -6945,19 +7004,9 @@ public interface Page extends AutoCloseable {
     type(selector, text, null);
   }
   /**
-   * Sends a {@code keydown}, {@code keypress}/{@code input}, and {@code keyup} event for each character in the text. {@code
-   * page.type} can be used to send fine-grained keyboard events. To fill values in form fields, use {@link Page#fill
-   * Page.fill()}.
-   *
-   * <p> To press a special key, like {@code Control} or {@code ArrowDown}, use {@link Keyboard#press Keyboard.press()}.
-   *
-   * <p> **Usage**
-   * <pre>{@code
-   * // Types instantly
-   * page.type("#mytextarea", "Hello");
-   * // Types slower, like a user
-   * page.type("#mytextarea", "World", new Page.TypeOptions().setDelay(100));
-   * }</pre>
+   * @deprecated In most cases, you should use {@link Locator#fill Locator.fill()} instead. You only need to press keys one by one if
+   * there is special keyboard handling on the page - in this case use {@link Locator#pressSequentially
+   * Locator.pressSequentially()}.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @param text A text to type into a focused element.
@@ -7008,6 +7057,12 @@ public interface Page extends AutoCloseable {
    * @since v1.8
    */
   void uncheck(String selector, UncheckOptions options);
+  /**
+   * Removes all routes created with {@link Page#route Page.route()} and {@link Page#routeFromHAR Page.routeFromHAR()}.
+   *
+   * @since v1.41
+   */
+  void unrouteAll();
   /**
    * Removes a route created with {@link Page#route Page.route()}. When {@code handler} is not specified, removes all routes
    * for the {@code url}.
@@ -7819,8 +7874,8 @@ public interface Page extends AutoCloseable {
    */
   ElementHandle waitForSelector(String selector, WaitForSelectorOptions options);
   /**
-   * The method will block until the codition returns true. All Playwright events will be dispatched while the method is
-   * waiting for the codition.
+   * The method will block until the condition returns true. All Playwright events will be dispatched while the method is
+   * waiting for the condition.
    *
    * <p> **Usage**
    *
@@ -7832,15 +7887,15 @@ public interface Page extends AutoCloseable {
    * page.waitForCondition(() -> messages.size() > 3);
    * }</pre>
    *
-   * @param condition Codition to wait for.
+   * @param condition Condition to wait for.
    * @since v1.32
    */
   default void waitForCondition(BooleanSupplier condition) {
     waitForCondition(condition, null);
   }
   /**
-   * The method will block until the codition returns true. All Playwright events will be dispatched while the method is
-   * waiting for the codition.
+   * The method will block until the condition returns true. All Playwright events will be dispatched while the method is
+   * waiting for the condition.
    *
    * <p> **Usage**
    *
@@ -7852,7 +7907,7 @@ public interface Page extends AutoCloseable {
    * page.waitForCondition(() -> messages.size() > 3);
    * }</pre>
    *
-   * @param condition Codition to wait for.
+   * @param condition Condition to wait for.
    * @since v1.32
    */
   void waitForCondition(BooleanSupplier condition, WaitForConditionOptions options);

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

@@ -62,6 +62,22 @@ public interface Request {
   /**
    * Returns the {@code Frame} that initiated this request.
    *
+   * <p> **Usage**
+   * <pre>{@code
+   * String frameUrl = request.frame().url();
+   * }</pre>
+   *
+   * <p> **Details**
+   *
+   * <p> Note that in some cases the frame is not available, and this method will throw.
+   * <ul>
+   * <li> When request originates in the Service Worker. You can use {@code request.serviceWorker()} to check that.</li>
+   * <li> When navigation request is issued before the corresponding frame is created. You can use {@link
+   * Request#isNavigationRequest Request.isNavigationRequest()} to check that.</li>
+   * </ul>
+   *
+   * <p> Here is an example that handles all the cases:
+   *
    * @since v1.8
    */
   Frame frame();
@@ -91,6 +107,9 @@ public interface Request {
   /**
    * Whether this request is driving frame's navigation.
    *
+   * <p> Some navigation requests are issued before the corresponding frame is created, and therefore do not have {@link
+   * Request#frame Request.frame()} available.
+   *
    * @since v1.8
    */
   boolean isNavigationRequest();

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

@@ -38,8 +38,9 @@ import java.nio.file.Path;
 public interface Tracing {
   class StartOptions {
     /**
-     * If specified, the trace is going to be saved into the file with the given name inside the {@code tracesDir} folder
-     * specified in {@link BrowserType#launch BrowserType.launch()}.
+     * If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the {@code
+     * tracesDir} folder specified in {@link BrowserType#launch BrowserType.launch()}. To specify the final trace zip file
+     * name, you need to pass {@code path} option to {@link Tracing#stop Tracing.stop()} instead.
      */
     public String name;
     /**
@@ -66,8 +67,9 @@ public interface Tracing {
     public String title;
 
     /**
-     * If specified, the trace is going to be saved into the file with the given name inside the {@code tracesDir} folder
-     * specified in {@link BrowserType#launch BrowserType.launch()}.
+     * If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the {@code
+     * tracesDir} folder specified in {@link BrowserType#launch BrowserType.launch()}. To specify the final trace zip file
+     * name, you need to pass {@code path} option to {@link Tracing#stop Tracing.stop()} instead.
      */
     public StartOptions setName(String name) {
       this.name = name;
@@ -110,8 +112,9 @@ public interface Tracing {
   }
   class StartChunkOptions {
     /**
-     * If specified, the trace is going to be saved into the file with the given name inside the {@code tracesDir} folder
-     * specified in {@link BrowserType#launch BrowserType.launch()}.
+     * If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the {@code
+     * tracesDir} folder specified in {@link BrowserType#launch BrowserType.launch()}. To specify the final trace zip file
+     * name, you need to pass {@code path} option to {@link Tracing#stopChunk Tracing.stopChunk()} instead.
      */
     public String name;
     /**
@@ -120,8 +123,9 @@ public interface Tracing {
     public String title;
 
     /**
-     * If specified, the trace is going to be saved into the file with the given name inside the {@code tracesDir} folder
-     * specified in {@link BrowserType#launch BrowserType.launch()}.
+     * If specified, intermediate trace files are going to be saved into the files with the given name prefix inside the {@code
+     * tracesDir} folder specified in {@link BrowserType#launch BrowserType.launch()}. To specify the final trace zip file
+     * name, you need to pass {@code path} option to {@link Tracing#stopChunk Tracing.stopChunk()} instead.
      */
     public StartChunkOptions setName(String name) {
       this.name = name;

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

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.microsoft.playwright;
+
+
+/**
+ * {@code WebError} class represents an unhandled exception thrown in the page. It is dispatched via the {@link
+ * BrowserContext#onWebError BrowserContext.onWebError()} event.
+ * <pre>{@code
+ * // Log all uncaught errors to the terminal
+ * context.onWebError(webError -> {
+ *   System.out.println("Uncaught exception: " + webError.error());
+ * });
+ *
+ * // Navigate to a page with an exception.
+ * page.navigate("data:text/html,<script>throw new Error('Test')</script>");
+ * }</pre>
+ */
+public interface WebError {
+  /**
+   * The page that produced this unhandled exception, if any.
+   *
+   * @since v1.38
+   */
+  Page page();
+  /**
+   * Unhandled error that was thrown.
+   *
+   * @since v1.38
+   */
+  String error();
+}
+

playwright/src/main/java/com/microsoft/playwright/assertions/LocatorAssertions.java

@@ -40,7 +40,7 @@ public interface LocatorAssertions {
   class IsAttachedOptions {
     public Boolean attached;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
@@ -49,7 +49,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsAttachedOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -59,7 +59,7 @@ public interface LocatorAssertions {
   class IsCheckedOptions {
     public Boolean checked;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
@@ -68,7 +68,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsCheckedOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -77,12 +77,12 @@ public interface LocatorAssertions {
   }
   class IsDisabledOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsDisabledOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -92,7 +92,7 @@ public interface LocatorAssertions {
   class IsEditableOptions {
     public Boolean editable;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
@@ -101,7 +101,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsEditableOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -110,12 +110,12 @@ public interface LocatorAssertions {
   }
   class IsEmptyOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsEmptyOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -125,7 +125,7 @@ public interface LocatorAssertions {
   class IsEnabledOptions {
     public Boolean enabled;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
@@ -134,7 +134,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsEnabledOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -143,12 +143,12 @@ public interface LocatorAssertions {
   }
   class IsFocusedOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsFocusedOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -157,12 +157,12 @@ public interface LocatorAssertions {
   }
   class IsHiddenOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsHiddenOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -176,7 +176,7 @@ public interface LocatorAssertions {
      */
     public Double ratio;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
@@ -189,7 +189,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsInViewportOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -198,13 +198,13 @@ public interface LocatorAssertions {
   }
   class IsVisibleOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
     public Boolean visible;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public IsVisibleOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -222,7 +222,7 @@ public interface LocatorAssertions {
      */
     public Boolean ignoreCase;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
     /**
@@ -239,7 +239,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public ContainsTextOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -255,12 +255,25 @@ public interface LocatorAssertions {
   }
   class HasAttributeOptions {
     /**
-     * Time to retry the assertion for.
+     * 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;
 
     /**
-     * Time to retry the assertion for.
+     * Whether to perform case-insensitive match. {@code ignoreCase} option takes precedence over the corresponding regular
+     * expression flag if specified.
+     */
+    public HasAttributeOptions setIgnoreCase(boolean ignoreCase) {
+      this.ignoreCase = ignoreCase;
+      return this;
+    }
+    /**
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasAttributeOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -269,12 +282,12 @@ public interface LocatorAssertions {
   }
   class HasClassOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasClassOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -283,12 +296,12 @@ public interface LocatorAssertions {
   }
   class HasCountOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasCountOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -297,12 +310,12 @@ public interface LocatorAssertions {
   }
   class HasCSSOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasCSSOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -311,12 +324,12 @@ public interface LocatorAssertions {
   }
   class HasIdOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasIdOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -325,12 +338,12 @@ public interface LocatorAssertions {
   }
   class HasJSPropertyOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasJSPropertyOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -344,7 +357,7 @@ public interface LocatorAssertions {
      */
     public Boolean ignoreCase;
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
     /**
@@ -361,7 +374,7 @@ public interface LocatorAssertions {
       return this;
     }
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasTextOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -377,12 +390,12 @@ public interface LocatorAssertions {
   }
   class HasValueOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasValueOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -391,12 +404,12 @@ public interface LocatorAssertions {
   }
   class HasValuesOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasValuesOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -414,8 +427,8 @@ public interface LocatorAssertions {
    */
   LocatorAssertions not();
   /**
-   * Ensures that {@code Locator} points to an <a href="https://playwright.dev/java/docs/actionability#attached">attached</a>
-   * DOM node.
+   * Ensures that {@code Locator} points to an element that is <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected">connected</a> to a Document or a ShadowRoot.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -428,8 +441,8 @@ public interface LocatorAssertions {
     isAttached(null);
   }
   /**
-   * Ensures that {@code Locator} points to an <a href="https://playwright.dev/java/docs/actionability#attached">attached</a>
-   * DOM node.
+   * Ensures that {@code Locator} points to an element that is <a
+   * href="https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected">connected</a> to a Document or a ShadowRoot.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -658,12 +671,25 @@ public interface LocatorAssertions {
    */
   void isInViewport(IsInViewportOptions options);
   /**
-   * Ensures that {@code Locator} points to an <a href="https://playwright.dev/java/docs/actionability#attached">attached</a>
-   * and <a href="https://playwright.dev/java/docs/actionability#visible">visible</a> DOM node.
+   * Ensures that {@code Locator} points to an attached and <a
+   * href="https://playwright.dev/java/docs/actionability#visible">visible</a> DOM node.
+   *
+   * <p> To check that at least one element from the list is visible, use {@link Locator#first Locator.first()}.
    *
    * <p> **Usage**
    * <pre>{@code
+   * // A specific element is visible.
    * assertThat(page.getByText("Welcome")).isVisible();
+   *
+   * // At least one item in the list is visible.
+   * asserThat(page.getByTestId("todo-item").first()).isVisible();
+   *
+   * // At least one of the two elements is visible, possibly both.
+   * asserThat(
+   *   page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign in"))
+   *     .or(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign up")))
+   *     .first()
+   * ).isVisible();
    * }</pre>
    *
    * @since v1.20
@@ -672,20 +698,38 @@ public interface LocatorAssertions {
     isVisible(null);
   }
   /**
-   * Ensures that {@code Locator} points to an <a href="https://playwright.dev/java/docs/actionability#attached">attached</a>
-   * and <a href="https://playwright.dev/java/docs/actionability#visible">visible</a> DOM node.
+   * Ensures that {@code Locator} points to an attached and <a
+   * href="https://playwright.dev/java/docs/actionability#visible">visible</a> DOM node.
+   *
+   * <p> To check that at least one element from the list is visible, use {@link Locator#first Locator.first()}.
    *
    * <p> **Usage**
    * <pre>{@code
+   * // A specific element is visible.
    * assertThat(page.getByText("Welcome")).isVisible();
+   *
+   * // At least one item in the list is visible.
+   * asserThat(page.getByTestId("todo-item").first()).isVisible();
+   *
+   * // At least one of the two elements is visible, possibly both.
+   * asserThat(
+   *   page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign in"))
+   *     .or(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign up")))
+   *     .first()
+   * ).isVisible();
    * }</pre>
    *
    * @since v1.20
    */
   void isVisible(IsVisibleOptions options);
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -724,8 +768,13 @@ public interface LocatorAssertions {
     containsText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -762,8 +811,13 @@ public interface LocatorAssertions {
    */
   void containsText(String expected, ContainsTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -802,8 +856,13 @@ public interface LocatorAssertions {
     containsText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -840,8 +899,13 @@ public interface LocatorAssertions {
    */
   void containsText(Pattern expected, ContainsTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -880,8 +944,13 @@ public interface LocatorAssertions {
     containsText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -918,8 +987,13 @@ public interface LocatorAssertions {
    */
   void containsText(String[] expected, ContainsTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -958,8 +1032,13 @@ public interface LocatorAssertions {
     containsText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element that contains the given text. You can use regular expressions for the
-   * value as well.
+   * Ensures the {@code Locator} points to an element that contains 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1376,8 +1455,13 @@ public interface LocatorAssertions {
    */
   void hasJSProperty(String name, Object value, HasJSPropertyOptions options);
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1416,8 +1500,13 @@ public interface LocatorAssertions {
     hasText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1454,8 +1543,13 @@ public interface LocatorAssertions {
    */
   void hasText(String expected, HasTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1494,8 +1588,13 @@ public interface LocatorAssertions {
     hasText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1532,8 +1631,13 @@ public interface LocatorAssertions {
    */
   void hasText(Pattern expected, HasTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1572,8 +1676,13 @@ public interface LocatorAssertions {
     hasText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1610,8 +1719,13 @@ public interface LocatorAssertions {
    */
   void hasText(String[] expected, HasTextOptions options);
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code
@@ -1650,8 +1764,13 @@ public interface LocatorAssertions {
     hasText(expected, null);
   }
   /**
-   * Ensures the {@code Locator} points to an element with the given text. You can use regular expressions for the value as
-   * well.
+   * 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.
+   *
+   * <p> **Details**
+   *
+   * <p> When {@code expected} parameter is a string, Playwright will normalize whitespaces and line breaks both in the actual
+   * text and in the expected string before matching. When regular expression is used, the actual text is matched as is.
    *
    * <p> **Usage**
    * <pre>{@code

playwright/src/main/java/com/microsoft/playwright/assertions/PageAssertions.java

@@ -39,12 +39,12 @@ import java.util.regex.Pattern;
 public interface PageAssertions {
   class HasTitleOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasTitleOptions setTimeout(double timeout) {
       this.timeout = timeout;
@@ -53,12 +53,12 @@ public interface PageAssertions {
   }
   class HasURLOptions {
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public Double timeout;
 
     /**
-     * Time to retry the assertion for.
+     * Time to retry the assertion for in milliseconds. Defaults to {@code 5000}.
      */
     public HasURLOptions setTimeout(double timeout) {
       this.timeout = timeout;

playwright/src/main/java/com/microsoft/playwright/impl/APIRequestContextImpl.java

@@ -1,8 +1,7 @@
 package com.microsoft.playwright.impl;
 
-import com.google.gson.JsonArray;
-import com.google.gson.JsonElement;
-import com.google.gson.JsonObject;
+import com.google.gson.*;
+import com.google.gson.stream.JsonReader;
 import com.microsoft.playwright.APIRequestContext;
 import com.microsoft.playwright.APIResponse;
 import com.microsoft.playwright.PlaywrightException;
@@ -11,6 +10,7 @@ import com.microsoft.playwright.options.FilePayload;
 import com.microsoft.playwright.options.RequestOptions;
 
 import java.io.File;
+import java.io.StringReader;
 import java.nio.charset.StandardCharsets;
 import java.nio.file.Path;
 import java.util.Base64;
@@ -85,11 +85,14 @@ class APIRequestContextImpl extends ChannelOwner implements APIRequestContext {
       byte[] bytes = null;
       if (options.data instanceof byte[]) {
         bytes = (byte[]) options.data;
-      } else if (options.data instanceof String && !isJsonContentType(options.headers)) {
-        bytes = ((String) options.data).getBytes(StandardCharsets.UTF_8);
+      } else if (options.data instanceof String) {
+        String stringData = (String) options.data;
+        if (!isJsonContentType(options.headers) || isJsonParsable(stringData)) {
+          bytes = (stringData).getBytes(StandardCharsets.UTF_8);
+        }
       }
       if (bytes == null) {
-        params.add("jsonData", gson().toJsonTree(options.data));
+        params.addProperty("jsonData", gson().toJson(options.data));
       } else {
         String base64 = Base64.getEncoder().encodeToString(bytes);
         params.addProperty("postData", base64);
@@ -202,4 +205,21 @@ class APIRequestContextImpl extends ChannelOwner implements APIRequestContext {
     }
     return impl;
   }
+
+  private static boolean isJsonParsable(String value) {
+    try {
+      JsonElement result = JsonParser.parseString(value);
+      if (result != null && result.isJsonPrimitive()) {
+        JsonPrimitive primitive = result.getAsJsonPrimitive();
+        if (primitive.isString() && value.equals(primitive.getAsString())) {
+          // Gson parses unquoted strings too, but we don't want to treat them
+          // as valid JSON.
+          return false;
+        }
+      }
+      return true;
+    } catch (JsonSyntaxException error) {
+      return false;
+    }
+  }
 }

playwright/src/main/java/com/microsoft/playwright/impl/ArtifactImpl.java

@@ -19,6 +19,8 @@ package com.microsoft.playwright.impl;
 import com.google.gson.JsonObject;
 import com.microsoft.playwright.PlaywrightException;
 
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
 import java.io.InputStream;
 import java.nio.file.FileSystems;
 import java.nio.file.Path;
@@ -32,13 +34,24 @@ class ArtifactImpl extends ChannelOwner {
 
   public InputStream createReadStream() {
     JsonObject result = sendMessage("stream").getAsJsonObject();
-    if (!result.has("stream")) {
-      return null;
-    }
     Stream stream = connection.getExistingObject(result.getAsJsonObject("stream").get("guid").getAsString());
     return stream.stream();
   }
 
+  byte[] readAllBytes() {
+    final int bufLen = 1024 * 1024;
+    byte[] buf = new byte[bufLen];
+    int readLen;
+    try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); InputStream stream = createReadStream()) {
+      while ((readLen = stream.read(buf, 0, bufLen)) != -1) {
+        outputStream.write(buf, 0, readLen);
+      }
+      return outputStream.toByteArray();
+    } catch (IOException e) {
+      throw new PlaywrightException("Failed to read artifact",  e);
+    }
+  }
+
   public void cancel() {
     sendMessage("cancel");
   }

playwright/src/main/java/com/microsoft/playwright/impl/BrowserContextImpl.java

@@ -51,6 +51,8 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
   private final WaitableEvent<EventType, ?> closePromise;
   final Map<String, BindingCallback> bindings = new HashMap<>();
   PageImpl ownerPage;
+  private String closeReason;
+
   private static final Map<EventType, String> eventSubscriptions() {
     Map<EventType, String> result = new HashMap<>();
     result.put(EventType.CONSOLE, "console");
@@ -82,6 +84,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     CONSOLE,
     DIALOG,
     PAGE,
+    WEBERROR,
     REQUEST,
     REQUESTFAILED,
     REQUESTFINISHED,
@@ -114,6 +117,16 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     }
   }
 
+  String effectiveCloseReason() {
+    if (closeReason != null) {
+      return closeReason;
+    }
+    if (browser != null) {
+      return browser.closeReason;
+    }
+    return null;
+  }
+
   @Override
   public void onClose(Consumer<BrowserContext> handler) {
     listeners.add(EventType.CLOSE, handler);
@@ -154,6 +167,16 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     listeners.remove(EventType.PAGE, handler);
   }
 
+  @Override
+  public void onWebError(Consumer<WebError> handler) {
+    listeners.add(EventType.WEBERROR, handler);
+  }
+
+  @Override
+  public void offWebError(Consumer<WebError> handler) {
+    listeners.remove(EventType.WEBERROR, handler);
+  }
+
   @Override
   public void onRequest(Consumer<Request> handler) {
     listeners.add(EventType.REQUEST, handler);
@@ -215,8 +238,24 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
   }
 
   @Override
-  public void close() {
-    withLogging("BrowserContext.close", () -> closeImpl());
+  public CDPSession newCDPSession(Page page) {
+    JsonObject params = new JsonObject();
+    params.add("page", ((PageImpl) page).toProtocolRef());
+    JsonObject result = sendMessage("newCDPSession", params).getAsJsonObject();
+    return connection.getExistingObject(result.getAsJsonObject("session").get("guid").getAsString());
+  }
+
+  @Override
+  public CDPSession newCDPSession(Frame frame) {
+    JsonObject params = new JsonObject();
+    params.add("frame", ((FrameImpl) frame).toProtocolRef());
+    JsonObject result = sendMessage("newCDPSession", params).getAsJsonObject();
+    return connection.getExistingObject(result.getAsJsonObject("session").get("guid").getAsString());
+  }
+
+  @Override
+  public void close(CloseOptions options) {
+    withLogging("BrowserContext.close", () -> closeImpl(options));
   }
 
   @Override
@@ -224,9 +263,13 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     return cookies(url == null ? new ArrayList<>() : Collections.singletonList(url));
   }
 
-  private void closeImpl() {
+  private void closeImpl(CloseOptions options) {
     if (!closeWasCalled) {
       closeWasCalled = true;
+      if (options == null) {
+        options = new CloseOptions();
+      }
+      closeReason = options.reason;
       for (Map.Entry<String, HarRecorder> entry : harRecorders.entrySet()) {
         JsonObject params = new JsonObject();
         params.addProperty("harId", entry.getKey());
@@ -248,7 +291,8 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
         }
         artifact.delete();
       }
-      sendMessage("close");
+      JsonObject params = gson().toJsonTree(options).getAsJsonObject();
+      sendMessage("close", params);
     }
     runUntil(() -> {}, closePromise);
   }
@@ -445,6 +489,10 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
 
   @Override
   public void setDefaultNavigationTimeout(double timeout) {
+    setDefaultNavigationTimeoutImpl(timeout);
+  }
+
+  void setDefaultNavigationTimeoutImpl(Double timeout) {
     withLogging("BrowserContext.setDefaultNavigationTimeout", () -> {
       timeoutSettings.setDefaultNavigationTimeout(timeout);
       JsonObject params = new JsonObject();
@@ -455,6 +503,10 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
 
   @Override
   public void setDefaultTimeout(double timeout) {
+    setDefaultTimeoutImpl(timeout);
+  }
+
+  void setDefaultTimeoutImpl(Double timeout) {
     withLogging("BrowserContext.setDefaultTimeout", () -> {
       timeoutSettings.setDefaultTimeout(timeout);
       JsonObject params = new JsonObject();
@@ -516,6 +568,14 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     return tracing;
   }
 
+  @Override
+  public void unrouteAll() {
+    withLogging("BrowserContext.unrouteAll", () -> {
+      routes.removeAll();
+      updateInterceptionPatterns();
+    });
+  }
+
   @Override
   public void unroute(String url, Consumer<Route> handler) {
     unroute(new UrlMatcher(this.baseUrl, url), handler);
@@ -559,7 +619,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
 
     @Override
     public R get() {
-      throw new PlaywrightException("Context closed");
+      throw new TargetClosedError(effectiveCloseReason());
     }
   }
 
@@ -580,7 +640,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
       updateInterceptionPatterns();
     }
     if (handled == Router.HandleResult.NoMatchingHandler || handled == Router.HandleResult.Fallback) {
-      route.resume();
+      route.resume(null, true);
     }
   }
 
@@ -621,6 +681,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
       }
     } else if ("route".equals(event)) {
       RouteImpl route = connection.getExistingObject(params.getAsJsonObject("route").get("guid").getAsString());
+      route.browserContext = this;
       handleRoute(route);
     } else if ("page".equals(event)) {
       PageImpl page = connection.getExistingObject(params.getAsJsonObject("page").get("guid").getAsString());
@@ -636,8 +697,7 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
         bindingCall.call(binding);
       }
     } else if ("console".equals(event)) {
-      String guid = params.getAsJsonObject("message").get("guid").getAsString();
-      ConsoleMessageImpl message = connection.getExistingObject(guid);
+      ConsoleMessageImpl message = new ConsoleMessageImpl(connection, params);
       listeners.notify(BrowserContextImpl.EventType.CONSOLE, message);
       PageImpl page = message.page();
       if (page != null) {
@@ -686,6 +746,25 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
         PageImpl page = connection.getExistingObject(params.getAsJsonObject("page").get("guid").getAsString());
         page.listeners.notify(PageImpl.EventType.RESPONSE, response);
       }
+    } else if ("pageError".equals(event)) {
+      SerializedError error = gson().fromJson(params.getAsJsonObject("error"), SerializedError.class);
+      String errorStr = "";
+      if (error.error != null) {
+        errorStr = error.error.name + ": " + error.error.message;
+        if (error.error.stack != null && !error.error.stack.isEmpty()) {
+          errorStr += "\n" + error.error.stack;
+        }
+      }
+      PageImpl page;
+      try {
+        page = connection.getExistingObject(params.getAsJsonObject("page").get("guid").getAsString());
+      } catch (PlaywrightException e) {
+        page = null;
+      }
+      listeners.notify(BrowserContextImpl.EventType.WEBERROR, new WebErrorImpl(page, errorStr));
+      if (page != null) {
+        page.listeners.notify(PageImpl.EventType.PAGEERROR, errorStr);
+      }
     } else if ("close".equals(event)) {
       didClose();
     }
@@ -698,9 +777,10 @@ class BrowserContextImpl extends ChannelOwner implements BrowserContext {
     listeners.notify(EventType.CLOSE, this);
   }
 
-  WritableStream createTempFile(String name) {
+  WritableStream createTempFile(String name, long lastModifiedMs) {
     JsonObject params = new JsonObject();
     params.addProperty("name", name);
+    params.addProperty("lastModifiedMs", lastModifiedMs);
     JsonObject json = sendMessage("createTempFile", params).getAsJsonObject();
     return connection.getExistingObject(json.getAsJsonObject("writableStream").get("guid").getAsString());
   }

playwright/src/main/java/com/microsoft/playwright/impl/BrowserImpl.java

@@ -28,7 +28,6 @@ import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.*;
 import java.util.function.Consumer;
-import java.util.regex.Pattern;
 
 import static com.microsoft.playwright.impl.Serialization.addHarUrlFilter;
 import static com.microsoft.playwright.impl.Serialization.gson;
@@ -42,6 +41,8 @@ class BrowserImpl extends ChannelOwner implements Browser {
   private boolean isConnected = true;
   BrowserTypeImpl browserType;
   BrowserType.LaunchOptions launchOptions;
+  private Path tracePath;
+  String closeReason;
 
   enum EventType {
     DISCONNECTED,
@@ -67,11 +68,15 @@ class BrowserImpl extends ChannelOwner implements Browser {
   }
 
   @Override
-  public void close() {
-    withLogging("Browser.close", () -> closeImpl());
+  public void close(CloseOptions options) {
+    withLogging("Browser.close", () -> closeImpl(options));
   }
 
-  private void closeImpl() {
+  private void closeImpl(CloseOptions options) {
+    if (options == null) {
+      options = new CloseOptions();
+    }
+    closeReason = options.reason;
     if (isConnectedOverWebSocket) {
       try {
         connection.close();
@@ -183,7 +188,7 @@ class BrowserImpl extends ChannelOwner implements Browser {
     }
     if (options.recordVideoDir != null) {
       JsonObject recordVideo = new JsonObject();
-      recordVideo.addProperty("dir", options.recordVideoDir.toString());
+      recordVideo.addProperty("dir", options.recordVideoDir.toAbsolutePath().toString());
       if (options.recordVideoSize != null) {
         recordVideo.add("size", gson().toJsonTree(options.recordVideoSize));
       }
@@ -203,6 +208,10 @@ class BrowserImpl extends ChannelOwner implements Browser {
         params.addProperty("noDefaultViewport", true);
       }
     }
+    params.remove("acceptDownloads");
+    if (options.acceptDownloads != null) {
+      params.addProperty("acceptDownloads", options.acceptDownloads ? "accept" : "deny");
+    }
     JsonElement result = sendMessage("newContext", params);
     BrowserContextImpl context = connection.getExistingObject(result.getAsJsonObject().getAsJsonObject("context").get("guid").getAsString());
     context.videosDir = options.recordVideoDir;
@@ -231,6 +240,7 @@ class BrowserImpl extends ChannelOwner implements Browser {
     if (options == null) {
       options = new StartTracingOptions();
     }
+    tracePath = options.path;
     JsonObject params = gson().toJsonTree(options).getAsJsonObject();
     if (page != null) {
       params.add("page", ((PageImpl) page).toProtocolRef());
@@ -245,7 +255,20 @@ class BrowserImpl extends ChannelOwner implements Browser {
 
   private byte[] stopTracingImpl() {
     JsonObject json = sendMessage("stopTracing").getAsJsonObject();
-    return Base64.getDecoder().decode(json.get("binary").getAsString());
+    ArtifactImpl artifact = connection.getExistingObject(json.getAsJsonObject().getAsJsonObject("artifact").get("guid").getAsString());
+    byte[] data = artifact.readAllBytes();
+    artifact.delete();
+    if (tracePath != null) {
+      try {
+        Files.createDirectories(tracePath.getParent());
+        Files.write(tracePath, data);
+      } catch (IOException e) {
+        throw new PlaywrightException("Failed to write trace file", e);
+      } finally {
+        tracePath = null;
+      }
+    }
+    return data;
   }
 
   private Page newPageImpl(NewPageOptions options) {
@@ -276,6 +299,13 @@ class BrowserImpl extends ChannelOwner implements Browser {
     }
   }
 
+  @Override
+  public CDPSession newBrowserCDPSession() {
+    JsonObject params = new JsonObject();
+    JsonObject result = sendMessage("newBrowserCDPSession", params).getAsJsonObject();
+    return connection.getExistingObject(result.getAsJsonObject("session").get("guid").getAsString());
+  }
+
   private void didClose() {
     isConnected = false;
     listeners.notify(EventType.DISCONNECTED, this);

playwright/src/main/java/com/microsoft/playwright/impl/BrowserTypeImpl.java

@@ -33,8 +33,6 @@ import static com.microsoft.playwright.impl.Serialization.gson;
 import static com.microsoft.playwright.impl.Utils.convertType;
 
 class BrowserTypeImpl extends ChannelOwner implements BrowserType {
-  LocalUtils localUtils;
-
   BrowserTypeImpl(ChannelOwner parent, String type, String guid, JsonObject initializer) {
     super(parent, type, guid, initializer);
   }
@@ -203,7 +201,7 @@ class BrowserTypeImpl extends ChannelOwner implements BrowserType {
     }
     if (options.recordVideoDir != null) {
       JsonObject recordVideo = new JsonObject();
-      recordVideo.addProperty("dir", options.recordVideoDir.toString());
+      recordVideo.addProperty("dir", options.recordVideoDir.toAbsolutePath().toString());
       if (options.recordVideoSize != null) {
         recordVideo.add("size", gson().toJsonTree(options.recordVideoSize));
       }
@@ -223,6 +221,10 @@ class BrowserTypeImpl extends ChannelOwner implements BrowserType {
         params.addProperty("noDefaultViewport", true);
       }
     }
+    params.remove("acceptDownloads");
+    if (options.acceptDownloads != null) {
+      params.addProperty("acceptDownloads", options.acceptDownloads ? "accept" : "deny");
+    }
     JsonObject json = sendMessage("launchPersistentContext", params).getAsJsonObject();
     BrowserContextImpl context = connection.getExistingObject(json.getAsJsonObject("context").get("guid").getAsString());
     context.videosDir = options.recordVideoDir;

playwright/src/main/java/com/microsoft/playwright/impl/CDPSessionImpl.java

@@ -0,0 +1,56 @@
+package com.microsoft.playwright.impl;
+
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.microsoft.playwright.CDPSession;
+
+import java.util.HashMap;
+import java.util.function.Consumer;
+
+public class CDPSessionImpl extends ChannelOwner implements CDPSession {
+  private final ListenerCollection<String> listeners = new ListenerCollection<>(new HashMap<>(), this);
+
+  protected CDPSessionImpl(ChannelOwner parent, String type, String guid, JsonObject initializer) {
+    super(parent, type, guid, initializer);
+  }
+
+  @Override
+  void handleEvent(String event, JsonObject parameters) {
+    super.handleEvent(event, parameters);
+    if ("event".equals(event)) {
+      String method = parameters.get("method").getAsString();
+      JsonObject params = parameters.get("params").getAsJsonObject();
+      listeners.notify(method, params);
+    }
+  }
+
+  public JsonObject send(String method) {
+    return send(method, null);
+  }
+
+  public JsonObject send(String method, JsonObject params) {
+    JsonObject args = new JsonObject();
+    if (params != null) {
+      args.add("params", params);
+    }
+    args.addProperty("method", method);
+    JsonElement response = connection.sendMessage(guid, "send", args);
+    if (response == null) return null;
+    else return response.getAsJsonObject().get("result").getAsJsonObject();
+  }
+
+  @Override
+  public void on(String event, Consumer<JsonObject> handler) {
+    listeners.add(event, handler);
+  }
+
+  @Override
+  public void off(String event, Consumer<JsonObject> handler) {
+    listeners.remove(event, handler);
+  }
+
+  @Override
+  public void detach() {
+    sendMessage("detach");
+  }
+}

playwright/src/main/java/com/microsoft/playwright/impl/ChannelOwner.java

@@ -18,11 +18,11 @@ package com.microsoft.playwright.impl;
 
 import com.google.gson.JsonElement;
 import com.google.gson.JsonObject;
+import com.microsoft.playwright.PlaywrightException;
 
 import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.Map;
-import java.util.function.BinaryOperator;
 import java.util.function.Function;
 import java.util.function.Supplier;
 
@@ -34,6 +34,7 @@ class ChannelOwner extends LoggingSupport {
   final String type;
   final String guid;
   final JsonObject initializer;
+  private boolean wasCollected;
 
   protected ChannelOwner(ChannelOwner parent, String type, String guid, JsonObject initializer) {
     this(parent.connection, parent, type, guid, initializer);
@@ -57,15 +58,16 @@ class ChannelOwner extends LoggingSupport {
     }
   }
 
-  void disconnect() {
+  void disposeChannelOwner(boolean wasGarbageCollected) {
     // Clean up from parent and connection.
     if (parent != null) {
       parent.objects.remove(guid);
     }
     connection.unregisterObject(guid);
+    wasCollected = wasGarbageCollected;
     // Dispose all children.
     for (ChannelOwner child : new ArrayList<>(objects.values())) {
-      child.disconnect();
+      child.disposeChannelOwner(wasGarbageCollected);
     }
     objects.clear();
   }
@@ -91,6 +93,7 @@ class ChannelOwner extends LoggingSupport {
   }
 
   WaitableResult<JsonElement> sendMessageAsync(String method, JsonObject params) {
+    checkNotCollected();
     return connection.sendMessageAsync(guid, method, params);
   }
 
@@ -99,9 +102,15 @@ class ChannelOwner extends LoggingSupport {
   }
 
   JsonElement sendMessage(String method, JsonObject params) {
+    checkNotCollected();
     return connection.sendMessage(guid, method, params);
   }
 
+  private void checkNotCollected() {
+    if (wasCollected)
+      throw new PlaywrightException("The object has been collected to prevent unbounded heap growth.");
+  }
+
   <T> T runUntil(Runnable code, Waitable<T> waitable) {
     try {
       code.run();

playwright/src/main/java/com/microsoft/playwright/impl/Connection.java

@@ -25,7 +25,9 @@ import com.microsoft.playwright.TimeoutError;
 
 import java.io.IOException;
 import java.time.Duration;
+import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
 import static com.microsoft.playwright.impl.Serialization.gson;
@@ -38,6 +40,7 @@ class Message {
   JsonObject params;
   JsonElement result;
   SerializedError error;
+  JsonArray log;
 
   @Override
   public String toString() {
@@ -206,6 +209,30 @@ public class Connection {
     dispatch(messageObj);
   }
 
+  private static String formatCallLog(JsonArray log) {
+    if (log == null) {
+      return "";
+    }
+    boolean allEmpty = true;
+    for (JsonElement e: log) {
+      if (!e.getAsString().isEmpty()) {
+        allEmpty = false;
+        break;
+      }
+    }
+    if (allEmpty) {
+      return "";
+    }
+    List<String> lines = new ArrayList<>();
+    lines.add("");
+    lines.add("Call log:");
+    for (JsonElement e: log) {
+      lines.add("- " + e.getAsString());
+    }
+    lines.add("");
+    return String.join("\n", lines);
+  }
+
   private void dispatch(Message message) {
 //    System.out.println("Message: " + message.method + " " + message.id);
     if (message.id != 0) {
@@ -218,12 +245,18 @@ public class Connection {
       if (message.error == null) {
         callback.complete(message.result);
       } else {
+        String callLog = formatCallLog(message.log);
         if (message.error.error == null) {
-          callback.completeExceptionally(new PlaywrightException(message.error.toString()));
+          callback.completeExceptionally(new PlaywrightException(message.error + callLog));
+        } else if ("Expect".equals(message.error.error.name)) {
+          callback.complete(message.result);
         } else if ("TimeoutError".equals(message.error.error.name)) {
-          callback.completeExceptionally(new TimeoutError(message.error.error.toString()));
+          callback.completeExceptionally(new TimeoutError(message.error.error + callLog));
+        } else if ("TargetClosedError".equals(message.error.error.name)) {
+          callback.completeExceptionally(new TargetClosedError(message.error.error + callLog));
+
         } else {
-          callback.completeExceptionally(new DriverException(message.error.error));
+          callback.completeExceptionally(new DriverException(message.error.error + callLog));
         }
       }
       return;
@@ -252,7 +285,8 @@ public class Connection {
       return;
     }
     if (message.method.equals("__dispose__")) {
-      object.disconnect();
+      boolean wasCollected = message.params.has("reason") && "gc".equals(message.params.get("reason").getAsString());
+      object.disposeChannelOwner(wasCollected);
       return;
     }
     object.handleEvent(message.method, message.params);
@@ -293,9 +327,6 @@ public class Connection {
       case "BrowserContext":
         result = new BrowserContextImpl(parent, type, guid, initializer);
         break;
-      case "ConsoleMessage":
-        result = new ConsoleMessageImpl(parent, type, guid, initializer);
-        break;
       case "Dialog":
         result = new DialogImpl(parent, type, guid, initializer);
         break;
@@ -359,6 +390,9 @@ public class Connection {
       case "WritableStream":
         result = new WritableStream(parent, type, guid, initializer);
         break;
+      case "CDPSession":
+        result = new CDPSessionImpl(parent, type, guid, initializer);
+        break;
       default:
         throw new PlaywrightException("Unknown type " + type);
     }

playwright/src/main/java/com/microsoft/playwright/impl/ConsoleMessageImpl.java

@@ -27,17 +27,20 @@ import java.util.List;
 
 import static com.microsoft.playwright.impl.Serialization.gson;
 
-public class ConsoleMessageImpl extends ChannelOwner implements ConsoleMessage {
+public class ConsoleMessageImpl implements ConsoleMessage {
+  private final Connection connection;
   private PageImpl page;
+  private final JsonObject initializer;
 
-  public ConsoleMessageImpl(ChannelOwner parent, String type, String guid, JsonObject initializer) {
-    super(parent, type, guid, initializer);
+  public ConsoleMessageImpl(Connection connection, JsonObject initializer) {
+    this.connection = connection;
     // Note: currently, we only report console messages for pages and they always have a page.
     // However, in the future we might report console messages for service workers or something else,
     // where page() would be null.
     if (initializer.has("page")) {
       page = connection.getExistingObject(initializer.getAsJsonObject("page").get("guid").getAsString());
     }
+    this.initializer = initializer;
   }
 
   public String type() {

playwright/src/main/java/com/microsoft/playwright/impl/DriverException.java

@@ -22,7 +22,7 @@ import java.io.PrintStream;
 import java.io.PrintWriter;
 
 class DriverException extends PlaywrightException {
-  DriverException(SerializedError.Error error) {
-    super(error.toString());
+  DriverException(String error) {
+    super(error);
   }
 }

playwright/src/main/java/com/microsoft/playwright/impl/ElementHandleImpl.java

@@ -28,13 +28,12 @@ import com.microsoft.playwright.options.SelectOption;
 
 import java.nio.file.Path;
 import java.util.ArrayList;
-import java.util.Arrays;
 import java.util.Base64;
 import java.util.List;
 
 import static com.microsoft.playwright.impl.Serialization.*;
 import static com.microsoft.playwright.impl.Utils.*;
-import static com.microsoft.playwright.impl.Utils.addLargeFileUploadParams;
+import static com.microsoft.playwright.impl.Utils.addFilePathUploadParams;
 import static com.microsoft.playwright.options.ScreenshotType.JPEG;
 import static com.microsoft.playwright.options.ScreenshotType.PNG;
 
@@ -467,16 +466,12 @@ public class ElementHandleImpl extends JSHandleImpl implements ElementHandle {
     if (frame == null) {
       throw new Error("Cannot set input files to detached element");
     }
-    if (hasLargeFile(files)) {
-      if (options == null) {
-        options = new SetInputFilesOptions();
-      }
-      JsonObject params = gson().toJsonTree(options).getAsJsonObject();
-      addLargeFileUploadParams(files, params, frame.page().context());
-      sendMessage("setInputFilePaths", params);
-    } else {
-      setInputFilesImpl(Utils.toFilePayloads(files), options);
+    if (options == null) {
+      options = new SetInputFilesOptions();
     }
+    JsonObject params = gson().toJsonTree(options).getAsJsonObject();
+    addFilePathUploadParams(files, params, frame.page().context());
+    sendMessage("setInputFiles", params);
   }
 
   @Override
@@ -495,7 +490,7 @@ public class ElementHandleImpl extends JSHandleImpl implements ElementHandle {
       options = new SetInputFilesOptions();
     }
     JsonObject params = gson().toJsonTree(options).getAsJsonObject();
-    params.add("files", Serialization.toJsonArray(files));
+    params.add("payloads", Serialization.toJsonArray(files));
     sendMessage("setInputFiles", params);
   }
 

playwright/src/main/java/com/microsoft/playwright/impl/FrameImpl.java

@@ -761,17 +761,13 @@ public class FrameImpl extends ChannelOwner implements Frame {
   }
 
   void setInputFilesImpl(String selector, Path[] files, SetInputFilesOptions options) {
-    if (hasLargeFile(files)) {
-      if (options == null) {
-        options = new SetInputFilesOptions();
-      }
-      JsonObject params = gson().toJsonTree(options).getAsJsonObject();
-      addLargeFileUploadParams(files, params, page.context());
-      params.addProperty("selector", selector);
-      sendMessage("setInputFilePaths", params);
-    } else {
-      setInputFilesImpl(selector, Utils.toFilePayloads(files), options);
+    if (options == null) {
+      options = new SetInputFilesOptions();
     }
+    JsonObject params = gson().toJsonTree(options).getAsJsonObject();
+    addFilePathUploadParams(files, params, page.context());
+    params.addProperty("selector", selector);
+    sendMessage("setInputFiles", params);
   }
 
   @Override
@@ -791,7 +787,7 @@ public class FrameImpl extends ChannelOwner implements Frame {
     }
     JsonObject params = gson().toJsonTree(options).getAsJsonObject();
     params.addProperty("selector", selector);
-    params.add("files", toJsonArray(files));
+    params.add("payloads", toJsonArray(files));
     sendMessage("setInputFiles", params);
   }
 

playwright/src/main/java/com/microsoft/playwright/impl/LocatorAssertionsImpl.java

@@ -86,12 +86,14 @@ public class LocatorAssertionsImpl extends AssertionsBase implements LocatorAsse
   public void hasAttribute(String name, String text, HasAttributeOptions options) {
     ExpectedTextValue expected = new ExpectedTextValue();
     expected.string = text;
+    expected.ignoreCase = shouldIgnoreCase(options);
     hasAttribute(name, expected, text, options);
   }
 
   @Override
   public void hasAttribute(String name, Pattern pattern, HasAttributeOptions options) {
     ExpectedTextValue expected = expectedRegex(pattern);
+    expected.ignoreCase = shouldIgnoreCase(options);
     hasAttribute(name, expected, pattern, options);
   }
 
@@ -105,7 +107,7 @@ public class LocatorAssertionsImpl extends AssertionsBase implements LocatorAsse
     if (expectedValue instanceof Pattern) {
       message += " matching regex";
     }
-    expectImpl("to.have.attribute", expectedText, expectedValue, message, commonOptions);
+    expectImpl("to.have.attribute.value", expectedText, expectedValue, message, commonOptions);
   }
 
   @Override

playwright/src/main/java/com/microsoft/playwright/impl/LocatorImpl.java

@@ -407,7 +407,7 @@ class LocatorImpl implements Locator {
     if (other.frame != frame) {
       throw new PlaywrightException("Locators must belong to the same frame.");
     }
-    return locator(other.selector, options);
+    return new LocatorImpl(frame, this.selector + " >> internal:chain=" + gson().toJson(other.selector), options);
   }
 
   @Override
@@ -436,6 +436,11 @@ class LocatorImpl implements Locator {
     frame.press(selector, key, convertType(options, Frame.PressOptions.class).setStrict(true));
   }
 
+  @Override
+  public void pressSequentially(String text, PressSequentiallyOptions options) {
+    type(text, convertType(options, TypeOptions.class));
+  }
+
   @Override
   public byte[] screenshot(ScreenshotOptions options) {
     return withElement((h, o) -> h.screenshot(o), convertType(options, ElementHandle.ScreenshotOptions.class));

playwright/src/main/java/com/microsoft/playwright/impl/LocatorUtils.java

@@ -5,6 +5,7 @@ import com.microsoft.playwright.options.AriaRole;
 
 import java.util.regex.Pattern;
 
+import static com.microsoft.playwright.impl.Serialization.gson;
 import static com.microsoft.playwright.impl.Utils.toJsRegexFlags;
 
 public class LocatorUtils {
@@ -25,10 +26,7 @@ public class LocatorUtils {
   }
 
   private static String getByAttributeTextSelector(String attrName, Object value, boolean exact) {
-    if (value instanceof Pattern) {
-      return "internal:attr=[" + attrName + "=" + toJsRegExp((Pattern) value) + "]";
-    }
-    return "internal:attr=[" + attrName + "=" + escapeForAttributeSelector((String) value, exact) + "]";
+    return "internal:attr=[" + attrName + "=" + escapeForAttributeSelector(value, exact) + "]";
   }
 
   static String getByTestIdSelector(Object testId) {
@@ -71,14 +69,7 @@ public class LocatorUtils {
       if (options.level != null)
         addAttr(result, "level", options.level.toString());
       if (options.name != null) {
-        String name;
-        if (options.name instanceof String) {
-          name = escapeForAttributeSelector((String) options.name, options.exact != null && options.exact);
-        } else if (options.name instanceof Pattern) {
-          name = toJsRegExp((Pattern) options.name);
-        } else {
-          throw new IllegalArgumentException("options.name can be String or Pattern, found: " + options.name);
-        }
+        String name = escapeForAttributeSelector(options.name, options.exact != null && options.exact);
         addAttr(result, "name", name);
       }
       if (options.pressed != null)
@@ -87,38 +78,33 @@ public class LocatorUtils {
     return result.toString();
   }
 
-  static String escapeForTextSelector(Object text, boolean exact) {
-    return escapeForTextSelector(text, exact, false);
+  private static String escapeRegexForSelector(Pattern re) {
+    // Even number of backslashes followed by the quote -> insert a backslash.
+    return toJsRegExp(re).replaceAll("(^|[^\\\\])(\\\\\\\\)*([\"'`])", "$1$2\\\\$3").replaceAll(">>", "\\\\>\\\\>");
   }
 
-  private static String escapeForTextSelector(Object param, boolean exact, boolean caseSensitive) {
-    if (param instanceof Pattern) {
-      return toJsRegExp((Pattern) param);
+  static String escapeForTextSelector(Object value, boolean exact) {
+    if (value instanceof Pattern) {
+      return escapeRegexForSelector((Pattern) value);
     }
-    if (!(param instanceof String)) {
-      throw new IllegalArgumentException("text parameter must be Pattern or String: " + param);
+    if (value instanceof String) {
+      return gson().toJson(value) + (exact ? "s" : "i");
     }
-    String text = (String) param;
-    if (exact) {
-      return '"' + text.replace("\"", "\\\"") + '"';
-    }
-
-    if (text.contains("\"") || text.contains(">>") || text.startsWith("/")) {
-      return "/" + escapeForRegex(text).replaceAll("\\s+", "\\\\s+") + "/" + (caseSensitive ? "" : "i");
-    }
-    return text;
+    throw new IllegalArgumentException("text parameter must be Pattern or String: " + value);
   }
 
-  private static String escapeForRegex(String text) {
-    return text.replaceAll("[.*+?^>${}()|\\[\\]\\\\]", "\\\\\\\\$0");
-  }
-
-  private static String escapeForAttributeSelector(String value, boolean exact) {
-    // TODO: this should actually be
-    //   cssEscape(value).replace(/\\ /g, ' ')
-    // However, our attribute selectors do not conform to CSS parsing spec,
-    // so we escape them differently.
-    return '"' + value.replaceAll("\\\\", "\\\\\\\\").replaceAll("\"", "\\\\\"") + '"' + (exact ? "" : "i");
+  private static String escapeForAttributeSelector(Object value, boolean exact) {
+    if (value instanceof Pattern) {
+      return escapeRegexForSelector((Pattern) value);
+    }
+    if (value instanceof String) {
+      // TODO: this should actually be
+      //   cssEscape(value).replace(/\\ /g, ' ')
+      // However, our attribute selectors do not conform to CSS parsing spec,
+      // so we escape them differently.
+      return '"' + ((String) value).replaceAll("\\\\", "\\\\\\\\").replaceAll("\"", "\\\\\"") + '"' + (exact ? "" : "i");
+    }
+    throw new IllegalArgumentException("Attribute can be String or Pattern, found: " + value);
   }
 
   private static String toJsRegExp(Pattern pattern) {

playwright/src/main/java/com/microsoft/playwright/impl/PageImpl.java

@@ -68,6 +68,7 @@ public class PageImpl extends ChannelOwner implements Page {
   private final TimeoutSettings timeoutSettings;
   private VideoImpl video;
   private final PageImpl opener;
+  private String closeReason;
 
   enum EventType {
     CLOSE,
@@ -171,6 +172,7 @@ public class PageImpl extends ChannelOwner implements Page {
       listeners.notify(EventType.FRAMEDETACHED, frame);
     } else if ("route".equals(event)) {
       RouteImpl route = connection.getExistingObject(params.getAsJsonObject("route").get("guid").getAsString());
+      route.browserContext = browserContext;
       Router.HandleResult handled = routes.handle(route);
       if (handled != Router.HandleResult.NoMatchingHandler) {
         updateInterceptionPatterns();
@@ -182,16 +184,6 @@ public class PageImpl extends ChannelOwner implements Page {
       String artifactGuid = params.getAsJsonObject("artifact").get("guid").getAsString();
       ArtifactImpl artifact = connection.getExistingObject(artifactGuid);
       forceVideo().setArtifact(artifact);
-    } else if ("pageError".equals(event)) {
-      SerializedError error = gson().fromJson(params.getAsJsonObject("error"), SerializedError.class);
-      String errorStr = "";
-      if (error.error != null) {
-        errorStr = error.error.name + ": " + error.error.message;
-        if (error.error.stack != null && !error.error.stack.isEmpty()) {
-          errorStr += "\n" + error.error.stack;
-        }
-      }
-      listeners.notify(EventType.PAGEERROR, errorStr);
     } else if ("crash".equals(event)) {
       listeners.notify(EventType.CRASH, this);
     } else if ("close".equals(event)) {
@@ -209,6 +201,13 @@ public class PageImpl extends ChannelOwner implements Page {
     listeners.notify(EventType.CLOSE, this);
   }
 
+  private String effectiveCloseReason() {
+    if (closeReason != null) {
+      return closeReason;
+    }
+    return browserContext.effectiveCloseReason();
+  }
+
   @Override
   public void onClose(Consumer<Page> handler) {
     listeners.add(EventType.CLOSE, handler);
@@ -497,6 +496,7 @@ public class PageImpl extends ChannelOwner implements Page {
     if (options == null) {
       options = new CloseOptions();
     }
+    closeReason = options.reason;
     try {
       if (ownedContext != null) {
         ownedContext.close();
@@ -936,7 +936,16 @@ public class PageImpl extends ChannelOwner implements Page {
   @Override
   public void pause() {
     withLogging("Page.pause", () -> {
-      runUntil(() -> {}, new WaitableRace<>(asList(context().pause(), (Waitable<JsonElement>) waitableClosedOrCrashed)));
+      Double defaultNavigationTimeout = browserContext.timeoutSettings.defaultNavigationTimeout();
+      Double defaultTimeout = browserContext.timeoutSettings.defaultTimeout();
+      browserContext.setDefaultNavigationTimeoutImpl(0.0);
+      browserContext.setDefaultTimeoutImpl(0.0);
+      try {
+        runUntil(() -> {}, new WaitableRace<>(asList(context().pause(), (Waitable<JsonElement>) waitableClosedOrCrashed)));
+      } finally {
+        browserContext.setDefaultNavigationTimeoutImpl(defaultNavigationTimeout);
+        browserContext.setDefaultTimeoutImpl(defaultTimeout);
+      }
     });
   }
 
@@ -946,9 +955,6 @@ public class PageImpl extends ChannelOwner implements Page {
   }
 
   private byte[] pdfImpl(PdfOptions options) {
-    if (!browserContext.browser().isChromium()) {
-      throw new PlaywrightException("Page.pdf only supported in headless Chromium");
-    }
     if (options == null) {
       options = new PdfOptions();
     }
@@ -1220,6 +1226,14 @@ public class PageImpl extends ChannelOwner implements Page {
       () -> mainFrame.uncheckImpl(selector, convertType(options, Frame.UncheckOptions.class)));
   }
 
+  @Override
+  public void unrouteAll() {
+    withLogging("Page.unrouteAll", () -> {
+      routes.removeAll();
+      updateInterceptionPatterns();
+    });
+  }
+
   @Override
   public void unroute(String url, Consumer<Route> handler) {
     unroute(new UrlMatcher(browserContext.baseUrl, url), handler);
@@ -1344,7 +1358,7 @@ public class PageImpl extends ChannelOwner implements Page {
 
     @Override
     public T get() {
-      throw new PlaywrightException("Page closed");
+      throw new TargetClosedError(effectiveCloseReason());
     }
   }
 
@@ -1355,7 +1369,7 @@ public class PageImpl extends ChannelOwner implements Page {
 
     @Override
     public T get() {
-      throw new PlaywrightException("Page crashed");
+      throw new TargetClosedError("Page crashed");
     }
   }
 

playwright/src/main/java/com/microsoft/playwright/impl/PlaywrightImpl.java

@@ -63,7 +63,6 @@ public class PlaywrightImpl extends ChannelOwner implements Playwright {
   private final BrowserTypeImpl webkit;
   private final SelectorsImpl selectors;
   private final APIRequestImpl apiRequest;
-  private final LocalUtils localUtils;
   private SharedSelectors sharedSelectors;
 
   PlaywrightImpl(ChannelOwner parent, String type, String guid, JsonObject initializer) {
@@ -74,10 +73,6 @@ public class PlaywrightImpl extends ChannelOwner implements Playwright {
 
     selectors = connection.getExistingObject(initializer.getAsJsonObject("selectors").get("guid").getAsString());
     apiRequest = new APIRequestImpl(this);
-    localUtils = connection.getExistingObject(initializer.getAsJsonObject("utils").get("guid").getAsString());
-    chromium.localUtils = localUtils;
-    firefox.localUtils = localUtils;
-    webkit.localUtils = localUtils;
   }
 
   void initSharedSelectors(PlaywrightImpl parent) {

playwright/src/main/java/com/microsoft/playwright/impl/Protocol.java

@@ -32,6 +32,7 @@ class SerializedValue{
   String v;
   String d;
   String u;
+  String bi;
   public static class R {
     String p;
     String f;
@@ -46,6 +47,10 @@ class SerializedValue{
   Number h;
   Integer id;
   Integer ref;
+  // JS representation of Map: [[key1, value1], [key2, value2], ...].
+  SerializedValue m;
+  // JS representation of Set: [item1, item2, ...].
+  SerializedValue se;
 }
 
 class SerializedArgument{

playwright/src/main/java/com/microsoft/playwright/impl/RequestImpl.java

@@ -78,7 +78,13 @@ public class RequestImpl extends ChannelOwner implements Request {
 
   @Override
   public FrameImpl frame() {
-    return connection.getExistingObject(initializer.getAsJsonObject("frame").get("guid").getAsString());
+    FrameImpl frame = connection.getExistingObject(initializer.getAsJsonObject("frame").get("guid").getAsString());
+    if (frame.page == null) {
+      throw new PlaywrightException("Frame for this navigation request is not available, because the request\n" +
+        "was issued before the frame is created. You can check whether the request\n" +
+        "is a navigation request by calling isNavigationRequest() method.");
+    }
+    return frame;
   }
 
   @Override

playwright/src/main/java/com/microsoft/playwright/impl/RouteImpl.java

@@ -32,7 +32,7 @@ import static com.microsoft.playwright.impl.Utils.convertType;
 public class RouteImpl extends ChannelOwner implements Route {
   private final RequestImpl request;
   private boolean handled;
-
+  BrowserContextImpl browserContext;
   boolean fallbackCalled;
   boolean shouldResumeIfFallbackIsCalled;
 
@@ -58,9 +58,13 @@ public class RouteImpl extends ChannelOwner implements Route {
 
   @Override
   public void resume(ResumeOptions options) {
+    resume(options, false);
+  }
+
+  void resume(ResumeOptions options, boolean isFallback) {
     startHandling();
     applyOverrides(convertType(options, FallbackOptions.class));
-    withLogging("Route.resume", () -> resumeImpl(request().fallbackOverridesForResume()));
+    withLogging("Route.resume", () -> resumeImpl(request().fallbackOverridesForResume(), isFallback));
   }
 
   @Override
@@ -71,7 +75,7 @@ public class RouteImpl extends ChannelOwner implements Route {
     }
     applyOverrides(options);
     if (shouldResumeIfFallbackIsCalled) {
-      resume();
+      resume(null, true);
     }
   }
 
@@ -95,7 +99,7 @@ public class RouteImpl extends ChannelOwner implements Route {
     if (fetchOptions != null && fetchOptions.timeout != null) {
       options.timeout = fetchOptions.timeout;
     }
-    APIRequestContextImpl apiRequest = request.frame().page().context().request();
+    APIRequestContextImpl apiRequest = browserContext.request();
     String url = (fetchOptions == null || fetchOptions.url == null) ? request().url() : fetchOptions.url;
     return apiRequest.fetch(url, options);
   }
@@ -114,7 +118,7 @@ public class RouteImpl extends ChannelOwner implements Route {
     request().applyFallbackOverrides(overrides);
   }
 
-  private void resumeImpl(RequestImpl.FallbackOverrides options) {
+  private void resumeImpl(RequestImpl.FallbackOverrides options, boolean isFallback) {
     JsonObject params = new JsonObject();
     if (options != null) {
       if (options.url != null) {
@@ -132,6 +136,7 @@ public class RouteImpl extends ChannelOwner implements Route {
       }
     }
     params.addProperty("requestUrl", request.initializer.get("url").getAsString());
+    params.addProperty("isFallback", isFallback);
     sendMessageAsync("continue", params);
   }
 

playwright/src/main/java/com/microsoft/playwright/impl/Router.java

@@ -66,8 +66,8 @@ class Router {
       .collect(Collectors.toList());
   }
 
-  int size() {
-    return routes.size();
+  void removeAll() {
+    routes.clear();
   }
 
   enum HandleResult { NoMatchingHandler, Handled, Fallback, PendingHandler }

playwright/src/main/java/com/microsoft/playwright/impl/Serialization.java

@@ -28,6 +28,7 @@ import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.io.PrintStream;
 import java.lang.reflect.Type;
+import java.math.BigInteger;
 import java.net.MalformedURLException;
 import java.net.URL;
 import java.nio.charset.StandardCharsets;
@@ -162,6 +163,8 @@ class Serialization {
         result.d = ((LocalDateTime)value).atZone(ZoneId.systemDefault()).toInstant().toString();
       } else if (value instanceof URL) {
         result.u = ((URL)value).toString();
+      } else if (value instanceof BigInteger) {
+        result.bi = ((BigInteger)value).toString();
       } else if (value instanceof Pattern) {
         result.r = new SerializedValue.R();
         result.r.p = ((Pattern)value).pattern();
@@ -236,6 +239,9 @@ class Serialization {
         throw new PlaywrightException("Unexpected value: " + value.u, e);
       }
     }
+    if (value.bi != null) {
+      return (T) new BigInteger(value.bi);
+    }
     if (value.d != null)
       return (T)(Date.from(Instant.parse(value.d)));
     if (value.r != null)
@@ -274,6 +280,16 @@ class Serialization {
       }
       return (T) map;
     }
+    if (value.m != null) {
+      Map<?, ?> map = new LinkedHashMap<>();
+      idToValue.put(value.id, map);
+      return (T) map;
+    }
+    if (value.se != null) {
+      Map<?, ?> map = new LinkedHashMap<>();
+      idToValue.put(value.id, map);
+      return (T) map;
+    }
     throw new PlaywrightException("Unexpected result: " + gson().toJson(value));
   }
 
@@ -330,6 +346,11 @@ class Serialization {
   }
 
   static JsonArray toProtocol(Map<String, String> map) {
+    for (String value : map.values()) {
+      if (value == null) {
+        throw new PlaywrightException("Value cannot be null");
+      }
+    }
     return toNameValueArray(map);
   }
 
@@ -348,7 +369,11 @@ class Serialization {
     for (Map.Entry<String, ?> e : map.entrySet()) {
       JsonObject item = new JsonObject();
       item.addProperty("name", e.getKey());
-      item.add("value", gson().toJsonTree(e.getValue()));
+      if (e.getValue() instanceof FilePayload) {
+        item.add("value", gson().toJsonTree(e.getValue()));
+      } else {
+        item.addProperty("value", "" + e.getValue());
+      }
       array.add(item);
     }
     return array;

playwright/src/main/java/com/microsoft/playwright/impl/TargetClosedError.java

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ * <p>
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.microsoft.playwright.impl;
+
+import com.microsoft.playwright.PlaywrightException;
+
+public class TargetClosedError extends PlaywrightException {
+  public TargetClosedError() {
+    super(null);
+  }
+
+  public TargetClosedError(String message) {
+    super(message != null ? message : "Target page, context or browser has been closed");
+  }
+}

playwright/src/main/java/com/microsoft/playwright/impl/TimeoutSettings.java

@@ -30,11 +30,18 @@ class TimeoutSettings {
     this.parent = parent;
   }
 
-  void setDefaultTimeout(double timeout) {
+  Double defaultTimeout() {
+    return defaultTimeout;
+  }
+  Double defaultNavigationTimeout() {
+    return defaultNavigationTimeout;
+  }
+
+  void setDefaultTimeout(Double timeout) {
     defaultTimeout = timeout;
   }
 
-  void setDefaultNavigationTimeout(double timeout) {
+  void setDefaultNavigationTimeout(Double timeout) {
     defaultNavigationTimeout = timeout;
   }
 
@@ -73,5 +80,4 @@ class TimeoutSettings {
     }
     return new WaitableTimeout<>(timeout(timeout));
   }
-
 }

playwright/src/main/java/com/microsoft/playwright/impl/TracingImpl.java

@@ -77,19 +77,8 @@ class TracingImpl extends ChannelOwner implements Tracing {
     connection.localUtils.zip(path, new JsonArray(), stacksId, true, includeSources);
   }
 
-  @Override
-  public void start(StartOptions options) {
-    withLogging("Tracing.start", () -> startImpl(options));
-  }
-
   @Override
   public void startChunk(StartChunkOptions options) {
-    withLogging("Tracing.startChunk", () -> {
-      startChunkImpl(options);
-    });
-  }
-
-  private void startChunkImpl(StartChunkOptions options) {
     if (options == null) {
       options = new StartChunkOptions();
     }
@@ -116,7 +105,8 @@ class TracingImpl extends ChannelOwner implements Tracing {
     stacksId = connection.localUtils().tracingStarted(tracesDir == null ? null : tracesDir.toString(), traceName);
   }
 
-  private void startImpl(StartOptions options) {
+  @Override
+  public void start(StartOptions options) {
     if (options == null) {
       options = new StartOptions();
     }
@@ -131,17 +121,13 @@ class TracingImpl extends ChannelOwner implements Tracing {
 
   @Override
   public void stop(StopOptions options) {
-    withLogging("Tracing.stop", () -> {
-      stopChunkImpl(options == null ? null : options.path);
-      sendMessage("tracingStop");
-    });
+    stopChunkImpl(options == null ? null : options.path);
+    sendMessage("tracingStop");
   }
 
   @Override
   public void stopChunk(StopChunkOptions options) {
-    withLogging("Tracing.stopChunk", () -> {
-      stopChunkImpl(options == null ? null : options.path);
-    });
+    stopChunkImpl(options == null ? null : options.path);
   }
 
   void setTracesDir(Path tracesDir) {

playwright/src/main/java/com/microsoft/playwright/impl/Utils.java

@@ -18,11 +18,9 @@ package com.microsoft.playwright.impl;
 
 import com.google.gson.JsonArray;
 import com.google.gson.JsonObject;
-import com.microsoft.playwright.ElementHandle;
 import com.microsoft.playwright.PlaywrightException;
 import com.microsoft.playwright.options.FilePayload;
 import com.microsoft.playwright.options.HttpHeader;
-import com.microsoft.playwright.options.SelectOption;
 
 import java.io.FileOutputStream;
 import java.io.IOException;
@@ -32,6 +30,7 @@ import java.lang.reflect.Field;
 import java.lang.reflect.Modifier;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.nio.file.attribute.FileTime;
 import java.util.*;
 import java.util.regex.Pattern;
 
@@ -89,7 +88,8 @@ class Utils {
   }
 
 
-  static Set<Character> escapeGlobChars = new HashSet<>(Arrays.asList('/', '$', '^', '+', '.', '(', ')', '=', '!', '|'));
+  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions#escaping
+  static Set<Character> escapeGlobChars = new HashSet<>(Arrays.asList('$', '^', '+', '.', '*', '(', ')', '|', '\\', '?', '{', '}', '[', ']'));
 
   static String globToRegex(String glob) {
     StringBuilder tokens = new StringBuilder();
@@ -97,8 +97,12 @@ class Utils {
     boolean inGroup = false;
     for (int i = 0; i < glob.length(); ++i) {
       char c = glob.charAt(i);
-      if (escapeGlobChars.contains(c)) {
-        tokens.append("\\").append(c);
+      if (c == '\\' && i + 1 < glob.length()) {
+        char nextChar = glob.charAt(++i);
+        if (escapeGlobChars.contains(nextChar)) {
+          tokens.append('\\');
+        }
+        tokens.append(nextChar);
         continue;
       }
       if (c == '*') {
@@ -123,6 +127,12 @@ class Utils {
         case '?':
           tokens.append('.');
           break;
+        case '[':
+          tokens.append('[');
+          break;
+        case ']':
+          tokens.append(']');
+          break;
         case '{':
           inGroup = true;
           tokens.append('(');
@@ -139,7 +149,11 @@ class Utils {
           tokens.append("\\").append(c);
           break;
         default:
+          if (escapeGlobChars.contains(c)) {
+            tokens.append('\\');
+          }
           tokens.append(c);
+          break;
       }
     }
     tokens.append('$');
@@ -159,27 +173,21 @@ class Utils {
     return mimeType;
   }
 
-  static final int maxUplodBufferSize = 50 * 1024 * 1024;
-
-  static boolean hasLargeFile(Path[] files) {
-    for (Path file: files) {
-      try {
-        if (Files.size(file)> maxUplodBufferSize) {
-          return true;
-        }
-      } catch (IOException e) {
-        throw new PlaywrightException("Cannot get file size.", e);
-      }
-    }
-    return false;
-  }
-
-  static void addLargeFileUploadParams(Path[] files, JsonObject params, BrowserContextImpl context) {
-    if (context.connection.isRemote) {
+  static void addFilePathUploadParams(Path[] files, JsonObject params, BrowserContextImpl context) {
+    if (files.length == 0) {
+      // FIXME: shouldBeAbleToResetSelectedFilesWithEmptyFileList tesst hangs in Chromium if we pass empty paths list.
+      params.add("payloads", new JsonArray());
+    } else if (context.connection.isRemote) {
       List<WritableStream> streams = new ArrayList<>();
       JsonArray jsonStreams = new JsonArray();
       for (Path path : files) {
-        WritableStream temp = context.createTempFile(path.getFileName().toString());
+        long lastModifiedMs;
+        try {
+          lastModifiedMs = Files.getLastModifiedTime(path).toMillis();
+        } catch (IOException e) {
+          throw new PlaywrightException("Cannot read file timestamp: " + path, e);
+        }
+        WritableStream temp = context.createTempFile(path.getFileName().toString(), lastModifiedMs);
         streams.add(temp);
         try (OutputStream out = temp.stream()) {
           Files.copy(path, out);
@@ -202,10 +210,12 @@ class Utils {
   }
 
   static void checkFilePayloadSize(FilePayload[] files) {
+    long totalSize = 0;
     for (FilePayload file: files) {
-      if (file.buffer.length > maxUplodBufferSize) {
-        throw new PlaywrightException("Cannot set buffer larger than 50Mb, please write it to a file and pass its path instead.");
-      }
+      totalSize += file.buffer.length;
+    }
+    if (totalSize > 50 * 1024 * 1024) {
+      throw new PlaywrightException("Cannot set buffer larger than 50Mb, please write it to a file and pass its path instead.");
     }
   }
 

playwright/src/main/java/com/microsoft/playwright/impl/WebErrorImpl.java

@@ -0,0 +1,23 @@
+package com.microsoft.playwright.impl;
+
+import com.microsoft.playwright.WebError;
+
+public class WebErrorImpl implements WebError {
+  private final PageImpl page;
+  private final String error;
+
+  WebErrorImpl(PageImpl page, String error) {
+    this.page = page;
+    this.error = error;
+  }
+
+  @Override
+  public PageImpl page() {
+    return page;
+  }
+
+  @Override
+  public String error() {
+    return error;
+  }
+}

playwright/src/main/java/com/microsoft/playwright/impl/WritableStream.java

@@ -28,6 +28,12 @@ class WritableStream extends ChannelOwner {
         params.addProperty("binary", new String(encoded.array(), StandardCharsets.UTF_8));
         sendMessage("write", params);
       }
+
+      @Override
+      public void close() throws IOException {
+        super.close();
+        sendMessage("close");
+      }
     };
   }
 }

playwright/src/main/java/com/microsoft/playwright/options/FormData.java

@@ -42,6 +42,19 @@ public interface FormData {
   }
   /**
    * Sets a field on the form. File values can be passed either as {@code Path} or as {@code FilePayload}.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .set("firstName", "John")
+   *     // 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("age", 30);
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
    *
    * @param name Field name.
    * @param value Field value.
@@ -50,6 +63,19 @@ public interface FormData {
   FormData set(String name, String value);
   /**
    * Sets a field on the form. File values can be passed either as {@code Path} or as {@code FilePayload}.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .set("firstName", "John")
+   *     // 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("age", 30);
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
    *
    * @param name Field name.
    * @param value Field value.
@@ -58,6 +84,19 @@ public interface FormData {
   FormData set(String name, boolean value);
   /**
    * Sets a field on the form. File values can be passed either as {@code Path} or as {@code FilePayload}.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .set("firstName", "John")
+   *     // 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("age", 30);
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
    *
    * @param name Field name.
    * @param value Field value.
@@ -66,6 +105,19 @@ public interface FormData {
   FormData set(String name, int value);
   /**
    * Sets a field on the form. File values can be passed either as {@code Path} or as {@code FilePayload}.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .set("firstName", "John")
+   *     // 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("age", 30);
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
    *
    * @param name Field name.
    * @param value Field value.
@@ -74,6 +126,19 @@ public interface FormData {
   FormData set(String name, Path value);
   /**
    * Sets a field on the form. File values can be passed either as {@code Path} or as {@code FilePayload}.
+   * <pre>{@code
+   * import com.microsoft.playwright.options.FormData;
+   * ...
+   * FormData form = FormData.create()
+   *     // Only name and value are set.
+   *     .set("firstName", "John")
+   *     // 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("age", 30);
+   * page.request().post("http://localhost/submit", RequestOptions.create().setForm(form));
+   * }</pre>
    *
    * @param name Field name.
    * @param value Field value.

playwright/src/test/java/com/microsoft/playwright/TestBase.java

@@ -20,10 +20,17 @@ import org.junit.jupiter.api.*;
 
 import com.microsoft.playwright.options.SameSiteAttribute;
 
+import javax.sql.rowset.Predicate;
 import java.io.IOException;
+import java.security.Provider;
+import java.time.Duration;
+import java.time.Instant;
+import java.util.function.BooleanSupplier;
+import java.util.function.Supplier;
 
 import static com.microsoft.playwright.Utils.getBrowserNameFromEnv;
 import static com.microsoft.playwright.Utils.nextFreePort;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
 @TestInstance(TestInstance.Lifecycle.PER_CLASS)
 public class TestBase {
@@ -150,6 +157,13 @@ public class TestBase {
     }
   }
 
+  void waitForCondition(BooleanSupplier predicate) {
+    waitForCondition(predicate, 5_000);
+  }
+  void waitForCondition(BooleanSupplier predicate, int timeoutMs) {
+    page.waitForCondition(predicate, new Page.WaitForConditionOptions().setTimeout(timeoutMs));
+  }
+
   private static SameSiteAttribute initSameSiteAttribute() {
     if (isChromium()) return SameSiteAttribute.LAX;
     if (isWebKit()) return SameSiteAttribute.NONE;

playwright/src/test/java/com/microsoft/playwright/TestBrowser.java

@@ -16,10 +16,14 @@
 
 package com.microsoft.playwright;
 
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
 import com.microsoft.playwright.options.BrowserChannel;
 import org.junit.jupiter.api.Assumptions;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIf;
 
+import java.util.concurrent.atomic.AtomicReference;
 import java.util.regex.Pattern;
 
 import static org.junit.jupiter.api.Assertions.*;
@@ -98,4 +102,40 @@ public class TestBrowser extends TestBase {
   void shouldReturnBrowserType() {
     assertEquals(browserType, browser.browserType());
   }
+
+  @Test
+  @EnabledIf(value = "com.microsoft.playwright.TestBase#isChromium", disabledReason = "Chrome Devtools Protocol supported by chromium only")
+  void shouldWorkWithNewBrowserCDPSession() {
+    CDPSession session = browser.newBrowserCDPSession();
+
+    JsonElement response = session.send("Browser.getVersion");
+    assertNotNull(response.getAsJsonObject().get("userAgent").toString());
+
+    AtomicReference<Boolean> gotEvent = new AtomicReference<>(false);
+
+    session.on("Target.targetCreated", jsonElement -> {
+      gotEvent.set(true);
+    });
+
+    JsonObject params = new JsonObject();
+    params.addProperty("discover", true);
+    session.send("Target.setDiscoverTargets", params);
+
+    Page page = browser.newPage();
+    assertTrue(gotEvent.get());
+    page.close();
+
+    session.detach();
+  }
+
+  @Test
+  void shouldPropagateCloseReasonToPendingActions() {
+    Browser browser = browserType.launch();
+    BrowserContext context = browser.newContext();
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> context.waitForPage(() -> {
+      browser.close(new Browser.CloseOptions().setReason("The reason."));
+    }));
+    assertTrue(e.getMessage().contains("The reason."), e.getMessage());
+  }
+
 }

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextAddCookies.java

@@ -38,6 +38,14 @@ public class TestBrowserContextAddCookies extends TestBase {
     assertEquals("password=123456", page.evaluate("document.cookie"));
   }
 
+  // Slightly different rounding on chromium win.
+  private static List<Cookie> normalizeExpires(List<Cookie> cookies) {
+    for (Cookie cookie: cookies) {
+      cookie.expires = (double) Math.round(cookie.expires);
+    }
+    return cookies;
+  }
+
   @Test
   void shouldRoundtripCookie() {
     page.navigate(server.EMPTY_PAGE);
@@ -53,7 +61,7 @@ public class TestBrowserContextAddCookies extends TestBase {
     context.clearCookies();
     assertEquals(0, context.cookies().size());
     context.addCookies(cookies);
-    assertJsonEquals(cookies, context.cookies());
+    assertJsonEquals(normalizeExpires(cookies), normalizeExpires(context.cookies()));
   }
 
   @Test

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextBasic.java

@@ -144,7 +144,7 @@ public class TestBrowserContextBasic extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> {
       context.waitForPage(() -> context.close());
     });
-    assertTrue(e.getMessage().contains("Context closed"));
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());
   }
 
   @Test
@@ -236,8 +236,17 @@ public class TestBrowserContextBasic extends TestBase {
   void shouldWorkWithOfflineOption() {
     BrowserContext context = browser.newContext(new Browser.NewContextOptions().setOffline(true));
     Page page = context.newPage();
-    assertThrows(PlaywrightException.class, () -> page.navigate(server.EMPTY_PAGE));
-
+    if (isFirefox()) {
+      // Firefox navigates to an error page, and this navigation might conflict with the
+      // next navigation we do in test.
+      // So we need to wait for the navigation explicitly.
+      boolean[] frameNavigated = { false };
+      page.onFrameNavigated(frame -> frameNavigated[0] = true);
+      assertThrows(PlaywrightException.class, () -> page.navigate(server.EMPTY_PAGE));
+      page.waitForCondition(() -> frameNavigated[0], new Page.WaitForConditionOptions().setTimeout(10_000));
+    } else {
+      assertThrows(PlaywrightException.class, () -> page.navigate(server.EMPTY_PAGE));
+    }
     context.setOffline(false);
     Response response = page.navigate(server.EMPTY_PAGE);
     assertEquals(200, response.status());
@@ -281,7 +290,16 @@ public class TestBrowserContextBasic extends TestBase {
         context.close();
         return false;
       }));
-    assertTrue(e.getMessage().contains("Context closed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());
   }
 
+  @Test
+  void shouldPropagateCloseReasonToPendingActions() {
+    BrowserContext context = browser.newContext();
+    Page page = context.newPage();
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.waitForPopup(() -> {
+      context.close(new BrowserContext.CloseOptions().setReason("The reason."));
+    }));
+    assertTrue(e.getMessage().contains("The reason."), e.getMessage());
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextCDPSession.java

@@ -0,0 +1,165 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.microsoft.playwright;
+
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIf;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.Consumer;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@EnabledIf(value = "com.microsoft.playwright.TestBase#isChromium", disabledReason = "Chrome Devtools Protocol supported by chromium only")
+public class TestBrowserContextCDPSession extends TestBase {
+
+  @Test
+  void shouldWork() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+    cdpSession.send("Runtime.enable");
+
+    JsonObject params = new JsonObject();
+    params.addProperty("expression", "window.foo = 'bar'");
+    cdpSession.send("Runtime.evaluate", params);
+
+    Object foo = page.evaluate("window['foo']");
+    assertEquals("bar", foo);
+  }
+
+  @Test
+  void shouldSendEvents() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+    cdpSession.send("Network.enable");
+
+    List<JsonElement> events = new ArrayList<>();
+    cdpSession.on("Network.requestWillBeSent", events::add);
+    page.navigate(server.EMPTY_PAGE);
+
+    assertEquals(1, events.size());
+  }
+
+  @Test
+  void shouldDetachSession() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+    cdpSession.send("Runtime.enable");
+
+    JsonObject params = new JsonObject();
+    params.addProperty("expression", "1 + 2");
+    params.addProperty("returnByValue", true);
+
+    JsonElement evaluateResult = cdpSession.send("Runtime.evaluate", params);
+    assertEquals(3, evaluateResult.getAsJsonObject().getAsJsonObject("result").get("value").getAsInt());
+
+    cdpSession.detach();
+
+    PlaywrightException exception = assertThrows(PlaywrightException.class, () -> {
+      cdpSession.send("Runtime.evaluate", params);
+    });
+    assertTrue(exception.getMessage().contains("Target page, context or browser has been closed"));
+  }
+
+  @Test
+  void shouldThrowNiceErrors() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+
+    PlaywrightException exception = assertThrows(PlaywrightException.class, () -> {
+      cdpSession.send("ThisCommand.DoesNotExist");
+    });
+    assertTrue(exception.getMessage().contains("'ThisCommand.DoesNotExist' wasn't found"));
+  }
+
+  @Test
+  void shouldWorkWithMainFrame() {
+    CDPSession cdpSession = page.context().newCDPSession(page.mainFrame());
+    JsonObject params = new JsonObject();
+    params.addProperty("expression", "window.foo = 'bar'");
+    cdpSession.send("Runtime.evaluate", params);
+
+    Object foo = page.evaluate("window['foo']");
+    assertEquals("bar", foo);
+  }
+
+  @Test
+  void shouldThrowIfTargetIsPartOfMain() {
+    page.navigate(server.PREFIX + "/frames/one-frame.html");
+    assertEquals(server.PREFIX + "/frames/one-frame.html", page.frames().get(0).url());
+    assertEquals(server.PREFIX + "/frames/frame.html", page.frames().get(1).url());
+
+    PlaywrightException exception = assertThrows(PlaywrightException.class, () -> {
+      page.context().newCDPSession(page.frames().get(1));
+    });
+    assertTrue(exception.getMessage().contains("This frame does not have a separate CDP session, it is a part of the parent frame's session"));
+  }
+
+  @Test
+  void shouldNotBreakPageClose() {
+    BrowserContext context = browser.newContext();
+    Page page = context.newPage();
+    CDPSession session = page.context().newCDPSession(page);
+    session.detach();
+    page.close();
+    context.close();
+  }
+
+  @Test
+  void shouldDetachWhenPageCloses() {
+    BrowserContext context = browser.newContext();
+    Page page = context.newPage();
+    CDPSession session = page.context().newCDPSession(page);
+    page.close();
+
+    PlaywrightException exception = assertThrows(PlaywrightException.class, session::detach);
+    assertTrue(exception.getMessage().contains("Target page, context or browser has been closed"));
+    context.close();
+  }
+
+  @Test
+  void shouldAddMultipleEventListeners() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+    cdpSession.send("Network.enable");
+
+    List<JsonObject> events = new ArrayList<>();
+    cdpSession.on("Network.requestWillBeSent", events::add);
+    cdpSession.on("Network.requestWillBeSent", events::add);
+
+    page.navigate(server.EMPTY_PAGE);
+    assertEquals(2, events.size());
+  }
+
+  @Test
+  void shouldRemoveEventListeners() {
+    CDPSession cdpSession = page.context().newCDPSession(page);
+    cdpSession.send("Network.enable");
+
+    List<JsonObject> events = new ArrayList<>();
+    Consumer<JsonObject> listener1 = events::add;
+    cdpSession.on("Network.requestWillBeSent", listener1);
+    cdpSession.on("Network.requestWillBeSent", events::add);
+
+    page.navigate(server.EMPTY_PAGE);
+    assertEquals(2, events.size());
+
+    cdpSession.off("Network.requestWillBeSent", listener1);
+    events.clear();
+
+    page.navigate(server.EMPTY_PAGE);
+    assertEquals(1, events.size());
+  }
+}

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextEvents.java

@@ -7,6 +7,7 @@ import java.io.OutputStreamWriter;
 import java.io.Writer;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
 public class TestBrowserContextEvents extends TestBase {
   @Test
@@ -156,4 +157,17 @@ public class TestBrowserContextEvents extends TestBase {
     page.waitForCondition(() -> "hello".equals(popup.evaluate("window.result")),
       new Page.WaitForConditionOptions().setTimeout(5_000));
   }
+
+  @Test
+  void pageErrorEventShouldWork() {
+    WebError[] webError = { null };
+    context.onWebError(e -> {
+      webError[0] = e;
+    });
+    page.setContent("<script>throw new Error('boom')</script>");
+    waitForCondition(() -> webError[0] != null);
+    assertEquals(page, webError[0].page());
+    assertTrue(webError[0].error().contains("boom"), webError[0].error());
+  }
+
 }

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextFetch.java

@@ -511,14 +511,18 @@ public class TestBrowserContextFetch extends TestBase {
       FormData.create()
         .set("firstName", "John")
         .set("lastName", "Doe")
+        .set("age", 30)
+        .set("isMale", true)
         .set("file", "f.js")));
 
     assertEquals("POST", req.get().method);
     assertEquals(asList("application/x-www-form-urlencoded"), req.get().headers.get("content-type"));
     String body = new String(req.get().postBody);
-    assertTrue(body.contains("firstName=John"));
-    assertTrue(body.contains("lastName=Doe"));
-    assertTrue(body.contains("file=f.js"));
+    assertTrue(body.contains("firstName=John"), body);
+    assertTrue(body.contains("lastName=Doe"), body);
+    assertTrue(body.contains("age=30"), body);
+    assertTrue(body.contains("isMale=true"), body);
+    assertTrue(body.contains("file=f.js"), body);
   }
 
   @Test
@@ -526,6 +530,8 @@ public class TestBrowserContextFetch extends TestBase {
     Map<String, Object> data = mapOf(
       "firstName", "John",
       "lastName", "Doe",
+      "age", 30,
+      "isMale", true,
       "file", mapOf("name", "f.js")
     );
     Future<Server.Request> req = server.futureRequest("/empty.html");
@@ -666,7 +672,7 @@ public class TestBrowserContextFetch extends TestBase {
     });
     page.evaluate("() => setTimeout(closeContext, 1000);");
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> context.request().get(server.EMPTY_PAGE));
-    assertTrue(e.getMessage().contains("Request context disposed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());
 
     e = assertThrows(PlaywrightException.class, () ->  context.request().post(server.EMPTY_PAGE));
     assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());

playwright/src/test/java/com/microsoft/playwright/TestBrowserContextProxy.java

@@ -175,17 +175,33 @@ public class TestBrowserContextProxy extends TestBase {
       // @see https://gist.github.com/CollinChaffin/24f6c9652efb3d6d5ef2f5502720ef00
       .setBypass("1.non.existent.domain.for.the.test, 2.non.existent.domain.for.the.test, .another.test")));
 
-    Page page = context.newPage();
-    page.navigate("http://0.non.existent.domain.for.the.test/target.html");
-    assertEquals("Served by the proxy", page.title());
-
-    assertThrows(PlaywrightException.class, () -> page.navigate("http://1.non.existent.domain.for.the.test/target.html"));
-    assertThrows(PlaywrightException.class, () -> page.navigate("http://2.non.existent.domain.for.the.test/target.html"));
-    assertThrows(PlaywrightException.class, () -> page.navigate("http://foo.is.the.another.test/target.html"));
-
-    page.navigate("http://3.non.existent.domain.for.the.test/target.html");
-    assertEquals("Served by the proxy", page.title());
-
+    {
+      Page page = context.newPage();
+      page.navigate("http://0.non.existent.domain.for.the.test/target.html");
+      assertEquals("Served by the proxy", page.title());
+      page.close();
+    }
+    {
+      Page page = context.newPage();
+      assertThrows(PlaywrightException.class, () -> page.navigate("http://1.non.existent.domain.for.the.test/target.html"));
+      page.close();
+    }
+    {
+      Page page = context.newPage();
+      assertThrows(PlaywrightException.class, () -> page.navigate("http://2.non.existent.domain.for.the.test/target.html"));
+      page.close();
+    }
+    {
+      Page page = context.newPage();
+      assertThrows(PlaywrightException.class, () -> page.navigate("http://foo.is.the.another.test/target.html"));
+      page.close();
+    }
+    {
+      Page page = context.newPage();
+      page.navigate("http://3.non.existent.domain.for.the.test/target.html");
+      assertEquals("Served by the proxy", page.title());
+      page.close();
+    }
     context.close();
   }
 

playwright/src/test/java/com/microsoft/playwright/TestBrowserTypeConnect.java

@@ -28,6 +28,7 @@ import java.nio.charset.StandardCharsets;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.nio.file.attribute.FileTime;
 import java.util.*;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
@@ -39,6 +40,8 @@ import static java.util.Arrays.asList;
 import static org.junit.jupiter.api.Assertions.*;
 
 public class TestBrowserTypeConnect extends TestBase {
+  static Path FILE_TO_UPLOAD = Paths.get("src/test/resources/file-to-upload.txt");
+
   private Process browserServer;
   private String wsEndpoint;
 
@@ -349,7 +352,7 @@ public class TestBrowserTypeConnect extends TestBase {
     }
     browser.close();
   }
-  
+
   @Test
   void shouldSaveAsVideosFromRemoteBrowser(@TempDir Path tempDir) {
     Path videosPath = tempDir.resolve("videosPath");
@@ -501,4 +504,17 @@ public class TestBrowserTypeConnect extends TestBase {
     assertEquals("200MB.zip", fields.get(0).filename);
     assertEquals(200 * 1024 * 1024, fields.get(0).content.length());
   }
+
+  @Test
+  void setInputFilesDhouldPreserveLastModifiedTimestamp() throws IOException {
+    page.setContent("<input type=file multiple=true/>");
+    Locator input = page.locator("input");
+    input.setInputFiles(FILE_TO_UPLOAD);
+    assertEquals(asList("file-to-upload.txt"), input.evaluate("e => [...e.files].map(f => f.name)"));
+    List<Double> timestamps = (List<Double>) input.evaluate("e => [...e.files].map(f => f.lastModified)");
+    FileTime expected = Files.getLastModifiedTime(FILE_TO_UPLOAD);
+    // On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    // rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    assertTrue(Math.abs(timestamps.get(0) - expected.toMillis()) < 1000, "expected: " + expected.toMillis() + "; actual: " + timestamps.get(0));
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestElementHandleConvenience.java

@@ -18,6 +18,8 @@ package com.microsoft.playwright;
 
 import org.junit.jupiter.api.Test;
 
+import java.util.Collections;
+
 import static org.junit.jupiter.api.Assertions.*;
 
 public class TestElementHandleConvenience extends TestBase {
@@ -35,6 +37,17 @@ public class TestElementHandleConvenience extends TestBase {
     assertEquals("JSHandle@<input checked id=\"check\" foo=\"bar\"\" type=\"checkbox\"/>", check.toString());
   }
 
+  @Test
+  void shouldHaveANicePreviewForNonAsciiAttributesChildren() {
+    page.navigate(server.EMPTY_PAGE);
+    String text = String.join("", Collections.nCopies(100, "😛"));
+    page.setContent("<div title='" + text + "'>" + text + "</div>");
+    ElementHandle handle = page.querySelector("div");
+    context.waitForCondition(() -> "JSHandle@<div title=\"😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛…>😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛…</div>"
+        .equals(handle.toString()), new BrowserContext.WaitForConditionOptions().setTimeout(5_000));
+    assertEquals("JSHandle@<div title=\"😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛…>😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛😛…</div>", handle.toString());
+  }
+
   @Test
   void getAttributeShouldWork() {
     page.navigate(server.PREFIX + "/dom.html");

playwright/src/test/java/com/microsoft/playwright/TestEvalOnSelector.java

@@ -122,7 +122,7 @@ public class TestEvalOnSelector extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> {
       page.evalOnSelector("section", "e => e.id");
     });
-    assertTrue(e.getMessage().contains("failed to find element matching selector \"section\""));
+    assertTrue(e.getMessage().contains("Failed to find element matching selector \"section\""), e.getMessage());
   }
 
   @Test

playwright/src/test/java/com/microsoft/playwright/TestFirefoxLauncher.java

@@ -19,10 +19,14 @@ package com.microsoft.playwright;
 import org.junit.jupiter.api.BeforeAll;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.EnabledIf;
+import org.junit.jupiter.api.io.TempDir;
+
+import java.nio.file.Path;
 
 import static com.microsoft.playwright.Utils.mapOf;
 import static org.junit.jupiter.api.Assertions.*;
 
+@EnabledIf(value="com.microsoft.playwright.TestBase#isFirefox", disabledReason="skip")
 public class TestFirefoxLauncher extends TestBase {
 
   @Override
@@ -37,7 +41,6 @@ public class TestFirefoxLauncher extends TestBase {
   }
 
   @Test
-  @EnabledIf(value="com.microsoft.playwright.TestBase#isFirefox", disabledReason="skip")
   void shouldPassFirefoxUserPreferences() {
     BrowserType.LaunchOptions options = new BrowserType.LaunchOptions().setFirefoxUserPrefs(
       mapOf(
@@ -49,4 +52,19 @@ public class TestFirefoxLauncher extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.navigate("http://example.com"));
     assertTrue(e.getMessage().contains("NS_ERROR_PROXY_CONNECTION_REFUSED"));
   }
+
+  @Test
+  void shouldPassFirefoxUserPreferencesInPersistent(@TempDir Path tmpDir) {
+    BrowserType.LaunchPersistentContextOptions options = new BrowserType.LaunchPersistentContextOptions().setFirefoxUserPrefs(
+      mapOf(
+        "network.proxy.type", 1,
+        "network.proxy.http", "127.0.0.1",
+        "network.proxy.http_port", 3333));
+    initBrowserType();
+    context = browserType.launchPersistentContext(tmpDir.resolve("user-data-dir"), options);
+    assertNotNull(context);
+    Page page = context.pages().get(0);
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.navigate("http://example.com"));
+    assertTrue(e.getMessage().contains("NS_ERROR_PROXY_CONNECTION_REFUSED"));
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestLocatorAssertions.java

@@ -246,6 +246,14 @@ public class TestLocatorAssertions extends TestBase {
     assertTrue(e.getMessage().contains("Locator expected to have text"), e.getMessage());
   }
 
+  @Test
+  void hasAttributeTextIgnoreCase() {
+    page.setContent("<div id=NoDe>Text content</div>");
+    Locator locator = page.locator("#NoDe");
+    assertThat(locator).hasAttribute("id", "node", new LocatorAssertions.HasAttributeOptions().setIgnoreCase(true));
+    assertThat(locator).not().hasAttribute("id", "node");
+  }
+
   @Test
   void hasAttributeTextPass() {
     page.setContent("<div id=node>Text content</div>");

playwright/src/test/java/com/microsoft/playwright/TestLocatorMisc.java

@@ -116,4 +116,11 @@ public class TestLocatorMisc extends TestBase{
     assertEquals("outer", divLocator.locator("input").inputValue());
     assertEquals("inner", page.frameLocator("iframe").locator(divLocator).locator("input").inputValue());
   }
+
+  @Test
+  void shouldPressSequentially() {
+    page.setContent("<input type='text' />");
+    page.locator("input").pressSequentially("hello");
+    assertEquals("hello", page.evalOnSelector("input", "input => input.value"));
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageBasic.java

@@ -112,12 +112,12 @@ public class TestPageBasic extends TestBase {
         PlaywrightException e2 = assertThrows(PlaywrightException.class, () -> {
           newPage.waitForRequest(server.EMPTY_PAGE, () -> newPage.close());
         });
-        assertTrue(e2.getMessage().contains("Page closed"));
-        assertFalse(e2.getMessage().contains("Timeout"));
+        assertTrue(e2.getMessage().contains("Target page, context or browser has been closed"), e2.getMessage());
+        assertFalse(e2.getMessage().contains("Timeout"), e2.getMessage());
       });
     });
-    assertTrue(e1.getMessage().contains("Page closed"));
-    assertFalse(e1.getMessage().contains("Timeout"));
+    assertTrue(e1.getMessage().contains("Target page, context or browser has been closed"), e1.getMessage());
+    assertFalse(e1.getMessage().contains("Timeout"), e1.getMessage());
   }
 
   @Test
@@ -336,6 +336,15 @@ public class TestPageBasic extends TestBase {
         page.close();
         return false;
       }));
-    assertTrue(e.getMessage().contains("Page closed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());
+  }
+
+  @Test
+  void shouldPropagateCloseReasonToPendingActions() {
+    Page page = context.newPage();
+    PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.waitForPopup(() -> {
+      page.close(new Page.CloseOptions().setReason("The reason."));
+    }));
+    assertTrue(e.getMessage().contains("The reason."), e.getMessage());
   }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageEvaluate.java

@@ -19,6 +19,7 @@ package com.microsoft.playwright;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledIf;
 
+import java.math.BigInteger;
 import java.time.*;
 import java.util.Map;
 import java.util.regex.Pattern;
@@ -115,6 +116,12 @@ public class TestPageEvaluate extends TestBase {
     assertEquals(true, result);
   }
 
+  @Test
+  void shouldTransferBigint() {
+    assertEquals(new BigInteger("42", 10), page.evaluate("() => 42n"));
+    assertEquals(new BigInteger("17", 10), page.evaluate("a => a", new BigInteger("17", 10)));
+  }
+
   //  @Test
   void shouldTransferMapsAsEmptyObjects() {
     // Not applicable.
@@ -384,7 +391,7 @@ public class TestPageEvaluate extends TestBase {
     assertNotNull(element);
     element.dispose();
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.evaluate("e => e.textContent", element));
-    assertTrue(e.getMessage().contains("JSHandle is disposed"));
+    assertTrue(e.getMessage().contains("no object with guid"), e.getMessage());
   }
 
   @Test
@@ -638,4 +645,14 @@ public class TestPageEvaluate extends TestBase {
     assertTrue(object instanceof Date);
     assertEquals(Date.from(instant), object);
   }
+
+  @Test
+  void shouldTransferMaps() {
+    assertEquals(mapOf(), page.evaluate("() => new Map([[1, { test: 42n }]])"));
+  }
+
+  @Test
+  void shouldTransferSets() {
+    assertEquals(mapOf(), page.evaluate("() => new Set([1, { test: 42n }])"));
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageEventNetwork.java

@@ -66,17 +66,18 @@ public class TestPageEventNetwork extends TestBase {
     assertTrue(failedRequests.get(0).url().contains("one-style.css"));
     assertNull(failedRequests.get(0).response());
     assertEquals("stylesheet", failedRequests.get(0).resourceType());
+    String error = failedRequests.get(0).failure();
     if (isChromium()) {
-      assertEquals("net::ERR_EMPTY_RESPONSE", failedRequests.get(0).failure());
+      assertEquals("net::ERR_EMPTY_RESPONSE", error);
     } else if (isWebKit()) {
       if (isMac)
-        assertEquals("The network connection was lost.", failedRequests.get(0).failure());
+        assertEquals("The network connection was lost.", error);
       else if (isWindows)
-        assertEquals("Server returned nothing (no headers, no data)", failedRequests.get(0).failure());
+        assertEquals("Server returned nothing (no headers, no data)", error);
       else
-        assertEquals("Message Corrupt", failedRequests.get(0).failure());
+        assertTrue("Message Corrupt".equals(error) || "Connection terminated unexpectedly".equals(error), error);
     } else {
-      assertEquals("NS_ERROR_NET_RESET", failedRequests.get(0).failure());
+      assertEquals("NS_ERROR_NET_RESET", error);
     }
     assertNotNull(failedRequests.get(0).frame());
   }

playwright/src/test/java/com/microsoft/playwright/TestPageEventPopup.java

@@ -0,0 +1,17 @@
+package com.microsoft.playwright;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+public class TestPageEventPopup extends TestBase {
+  @Test
+  void shouldWorkWithClickingTarget_blank() {
+    page.navigate(server.EMPTY_PAGE);
+    page.setContent("<a target=_blank rel='opener' href='/one-style.html'>yo</a>");
+    Page popup = page.waitForPopup(() -> page.click("a"));
+    assertEquals(false, page.evaluate("() => !!window.opener"));
+    assertEquals(true, popup.evaluate("() => !!window.opener"));
+    assertEquals(popup, popup.mainFrame().page());
+  }
+}

playwright/src/test/java/com/microsoft/playwright/TestPageInterception.java

@@ -124,4 +124,15 @@ public class TestPageInterception extends TestBase {
     page.navigate(server.PREFIX + "/foo");
     assertTrue(page.content().contains("hello"));
   }
+
+  @Test
+  void shouldProperlyHandleCharacterSetsInGlobs() {
+    page.route("**/[a-z]*.html", route -> {
+      APIResponse response = route.fetch(new Route.FetchOptions().setUrl(server.PREFIX + "/one-style.html"));
+      route.fulfill(new Route.FulfillOptions().setResponse(response));
+    });
+    Response response = page.navigate(server.PREFIX + "/empty.html");
+    assertEquals(200, response.status());
+    assertTrue(response.text().contains("one-style.css"), response.text());
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageKeyboard.java

@@ -374,21 +374,9 @@ public class TestPageKeyboard extends TestBase {
     JSHandle lastEvent = captureLastKeyDown();
     page.keyboard().press("Meta");
     LinkedHashMap eventData = (LinkedHashMap) lastEvent.jsonValue();
-    if (isFirefox() && !isMac) {
-      assertEquals("OS", eventData.get("key"));
-    } else {
-      assertEquals("Meta", eventData.get("key"));
-    }
-    if (isFirefox()) {
-      assertEquals("OSLeft", eventData.get("code"));
-    } else {
-      assertEquals("MetaLeft", eventData.get("code"));
-    }
-    if (isFirefox() && !isMac) {
-      assertFalse((Boolean) eventData.get("metaKey"), eventData.toString());
-    } else {
-      assertTrue((Boolean) eventData.get("metaKey"), eventData.toString());
-    }
+    assertEquals("Meta", eventData.get("key"));
+    assertEquals("MetaLeft", eventData.get("code"));
+    assertTrue((Boolean) eventData.get("metaKey"), eventData.toString());
   }
 
   @Test

playwright/src/test/java/com/microsoft/playwright/TestPageLocatorQuery.java

@@ -16,6 +16,7 @@
 
 package com.microsoft.playwright;
 
+import com.microsoft.playwright.options.AriaRole;
 import org.junit.jupiter.api.Test;
 
 import java.util.regex.Pattern;
@@ -106,6 +107,39 @@ public class TestPageLocatorQuery extends TestBase {
     assertEquals("Hello \"world\"", page.locator("div", new Page.LocatorOptions().setHasText(Pattern.compile("Hello \"world\""))).textContent());
   }
 
+  @Test
+  void shouldFilterByRegexWithASingleQuote() {
+    page.setContent("<button>let's let's<span>hello</span></button>");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let's", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName(Pattern.compile("let's", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let['abc]s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let['abc]s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\\\'s", Pattern.CASE_INSENSITIVE)))).not().isVisible();
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\\\'s", Pattern.CASE_INSENSITIVE)))).not().isVisible();
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let's let\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let's let\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\'s let's", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\'s let's", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+
+    page.setContent("<button>let\\'s let\\'s<span>hello</span></button>");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\'s", Pattern.CASE_INSENSITIVE)))).not().isVisible();
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\'s", Pattern.CASE_INSENSITIVE)))).not().isVisible();
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\\\'s let\\\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\\\'s let\\\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.locator("button", new Page.LocatorOptions().setHasText(Pattern.compile("let\\\\\\'s let\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+    assertThat(page.getByRole(AriaRole.BUTTON,  new Page.GetByRoleOptions().setName(Pattern.compile("let\\\\\\'s let\\\\'s", Pattern.CASE_INSENSITIVE))).locator("span")).hasText("hello");
+  }
+
   @Test
   void shouldFilterByRegexAndRegexpFlags() {
     page.setContent("<div>Hello \"world\"</div><div>Hello world</div>");
@@ -207,4 +241,21 @@ public class TestPageLocatorQuery extends TestBase {
     assertThat(page.locator("div").or(page.locator("article"))).hasText("hello");
     assertThat(page.locator("span").or(page.locator("article"))).hasText("world");
   }
+
+  @Test
+  void shouldSupportLocatorLocatorWithAndOr() {
+    page.setContent("\n" +
+      "    <div>one <span>two</span> <button>three</button> </div>\n" +
+      "    <span>four</span>\n" +
+      "    <button>five</button>\n" +
+      "  ");
+
+    assertThat(page.locator("div").locator(page.locator("button"))).hasText(new String[] {"three"});
+    assertThat(page.locator("div").locator(page.locator("button").or(page.locator("span")))).hasText(new String[]{"two", "three"});
+    assertThat(page.locator("button").or(page.locator("span"))).hasText(new String[]{"two", "three", "four", "five"});
+
+    assertThat(page.locator("div").locator(page.locator("button").and(page.getByRole(AriaRole.BUTTON)))).hasText(new String[]{"three"});
+    assertThat(page.locator("button").and(page.getByRole(AriaRole.BUTTON))).hasText(new String[]{"three", "five"});
+  }
+
 }

playwright/src/test/java/com/microsoft/playwright/TestPageNetworkRequest.java

@@ -21,6 +21,8 @@ import com.microsoft.playwright.options.HttpHeader;
 import org.junit.jupiter.api.Test;
 
 import java.nio.charset.StandardCharsets;
+import java.time.Duration;
+import java.time.Instant;
 import java.util.*;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Future;
@@ -113,4 +115,23 @@ public class TestPageNetworkRequest extends TestBase {
     assertEquals("POST", request.method());
     assertEquals(403, request.response().status());
   }
+
+  @Test
+  void shouldNotAllowToAccessFrameOnPopupMainRequest() {
+    page.setContent("<a target=_blank href='" + server.EMPTY_PAGE + "'>click me</a>");
+    Request[] request = { null };
+    PlaywrightException[] error = { null };
+    page.context().onRequest(req -> {
+      request[0] = req;
+      try {
+        req.frame();
+      } catch (PlaywrightException e) {
+        error[0] = e;
+      }
+    });
+    page.getByText("click me").click();
+    waitForCondition(() -> request[0] != null);
+    assertTrue(request[0].isNavigationRequest());
+    assertTrue(error[0].getMessage().contains("Frame for this navigation request is not available"), error[0].getMessage());
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageRequestIntercept.java

@@ -0,0 +1,18 @@
+package com.microsoft.playwright;
+
+import org.junit.jupiter.api.Test;
+
+import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
+
+public class TestPageRequestIntercept extends TestBase {
+  @Test
+  void shouldFulfillPopupMainRequestUsingAlias() {
+    page.context().route("**/*", route -> {
+      APIResponse response = route.fetch();
+      route.fulfill(new Route.FulfillOptions().setResponse(response).setBody("hello" ));
+    });
+    page.setContent("<a target=_blank href='" + server.EMPTY_PAGE + "'>click me</a>");
+    Page popup = page.waitForPopup(() -> page.getByText("click me").click());
+    assertThat(popup.locator("body")).hasText("hello");
+  }
+}

playwright/src/test/java/com/microsoft/playwright/TestPageRoute.java

@@ -97,6 +97,42 @@ public class TestPageRoute extends TestBase {
     assertEquals(asList(1), intercepted);
   }
 
+  @Test
+  void shouldSupportQuestionMarkInGlobPattern() {
+    server.setRoute("/index", exchange -> {
+      exchange.sendResponseHeaders(200, 0);
+      try (OutputStreamWriter writer = new OutputStreamWriter(exchange.getResponseBody())) {
+        writer.write("index-no-hello");
+      }
+    });
+    server.setRoute("/index123hello", exchange -> {
+      exchange.sendResponseHeaders(200, 0);
+      try (OutputStreamWriter writer = new OutputStreamWriter(exchange.getResponseBody())) {
+        writer.write("index123hello");
+      }
+    });
+
+    page.route("**/index?hello", route -> {
+      route.fulfill(new Route.FulfillOptions().setBody("intercepted any character"));
+    });
+
+    page.route("**/index\\?hello", route -> {
+      route.fulfill(new Route.FulfillOptions().setBody("intercepted question mark"));
+    });
+
+    page.navigate(server.PREFIX + "/index?hello");
+    assertTrue(page.content().contains("intercepted question mark"), page.content());
+
+    page.navigate(server.PREFIX + "/index");
+    assertTrue(page.content().contains("index-no-hello"), page.content());
+
+    page.navigate(server.PREFIX + "/index1hello");
+    assertTrue(page.content().contains("intercepted any character"), page.content());
+
+    page.navigate(server.PREFIX + "/index123hello");
+    assertTrue(page.content().contains("index123hello"), page.content());
+  }
+
   @Test
   void shouldUnroutePredicate() {
     List<Integer> intercepted = new ArrayList<>();
@@ -353,7 +389,7 @@ public class TestPageRoute extends TestBase {
     Request r = intercepted.get(1);
     for (String url : asList("/one-style.css", "/two-style.css", "/three-style.css", "/four-style.css")) {
       assertEquals("stylesheet", r.resourceType());
-      assertTrue(r.url().contains(url));
+      assertTrue(r.url().contains(url), "actual: " + r.url() + "; expected: " + url);
       r = r.redirectedTo();
     }
     assertNull(r);

playwright/src/test/java/com/microsoft/playwright/TestPageScreenshot.java

@@ -28,13 +28,17 @@ import org.opentest4j.AssertionFailedError;
 import javax.imageio.ImageIO;
 import java.awt.image.BufferedImage;
 import java.io.ByteArrayInputStream;
+import java.io.File;
 import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.util.Arrays;
 
 import static com.microsoft.playwright.options.ScreenshotAnimations.DISABLED;
 import static java.util.Arrays.asList;
 import static org.junit.jupiter.api.Assertions.*;
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
 
 // TODO: suite.skip(browserName === "firefox" && headful");
 public class TestPageScreenshot extends TestBase {
@@ -233,4 +237,55 @@ public class TestPageScreenshot extends TestBase {
     }
     assertTrue(hasDifferentScreenshots);
   }
+
+  @Test
+  void shouldWorkWhenMaskColorIsNotPinkF0F() {
+    page.setViewportSize(500, 500);
+    page.navigate(server.PREFIX + "/grid.html");
+    byte[] screenshot1 = page.screenshot(
+      new Page.ScreenshotOptions()
+        .setMask(asList(page.locator("div").nth(5)))
+        .setMaskColor("#00FF00"));
+    byte[] screenshot2 = page.screenshot(
+      new Page.ScreenshotOptions()
+        .setMask(asList(page.locator("div").nth(5))));
+    assertThrows(AssertionError.class, () -> assertArrayEquals(screenshot1, screenshot2));
+  }
+
+  @Test
+  @DisabledIf(value="com.microsoft.playwright.TestBase#isWebKit", disabledReason="array lengths differ")
+  void shouldHideElementsBasedOnAttr() throws IOException {
+    page.setViewportSize(500, 500);
+    page.navigate(server.PREFIX + "/grid.html");
+    page.locator("div").nth(5).evaluate("element => {\n" +
+      "  element.setAttribute('data-test-screenshot', 'hide');\n" +
+      "}");
+    byte[] actual = page.screenshot(new Page.ScreenshotOptions().setStyle("[data-test-screenshot=\"hide\"] {\n" +
+      "          visibility: hidden;\n" +
+      "        }"));
+    assertArrayEquals(expectedScreenshot("hide-should-work"), actual, "Screenshots should match");
+    Object visibility = page.locator("div").nth(5).evaluate("element => element.style.visibility");
+    assertEquals("", visibility);
+  }
+
+  @Test
+  @DisabledIf(value="com.microsoft.playwright.TestBase#isWebKit", disabledReason="array lengths differ")
+  void shouldRemoveElementsBasedOnAttr() throws IOException {
+    page.setViewportSize(500, 500);
+    page.navigate(server.PREFIX + "/grid.html");
+    page.locator("div").nth(5).evaluate("element => {\n" +
+      "        element.setAttribute('data-test-screenshot', 'remove');\n" +
+      "      }");
+    byte[] actual = page.screenshot(new Page.ScreenshotOptions().setStyle("[data-test-screenshot=\"remove\"] {\n" +
+      "          display: none;\n" +
+      "        }"));
+    assertArrayEquals(expectedScreenshot("remove-should-work"), actual, "Screenshots should match");
+    Object display = page.locator("div").nth(5).evaluate("element => element.style.display");
+    assertEquals("", display);
+  }
+
+  private byte[] expectedScreenshot(String name) throws IOException {
+    Path path = Paths.get("src/test/resources/expectations");
+    return Files.readAllBytes(path.resolve(name + "-" + browserType.name() + ".png"));
+  }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageSetExtraHttpHeaders.java

@@ -73,6 +73,6 @@ public class TestPageSetExtraHttpHeaders extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> {
       browser.newContext(new Browser.NewContextOptions().setExtraHTTPHeaders(mapOf("foo", null)));
     });
-    assertTrue(e.getMessage().contains("expected string, got undefined"));
+    assertTrue(e.getMessage().contains("Value cannot be null"));
   }
 }

playwright/src/test/java/com/microsoft/playwright/TestPageSetInputFiles.java

@@ -16,15 +16,18 @@
 
 package com.microsoft.playwright;
 
+import com.microsoft.playwright.options.AriaRole;
 import com.microsoft.playwright.options.FilePayload;
 import org.junit.jupiter.api.Assumptions;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.io.TempDir;
+import org.junit.platform.commons.support.AnnotationSupport;
 
 import java.io.*;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.nio.file.attribute.FileTime;
 import java.time.Duration;
 import java.time.Instant;
 import java.util.ArrayList;
@@ -33,8 +36,10 @@ import java.util.List;
 import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Future;
+import java.util.concurrent.TimeUnit;
 import java.util.function.Consumer;
 
+import static com.microsoft.playwright.Utils.relativePathOrSkipTest;
 import static java.util.Arrays.asList;
 import static org.junit.jupiter.api.Assertions.*;
 
@@ -96,6 +101,34 @@ public class TestPageSetInputFiles extends TestBase {
     assertEquals(200 * 1024 * 1024, fields.get(0).content.length());
   }
 
+  @Test
+  void shouldUploadMultipleLargeFiles(@TempDir Path tmpDir) throws IOException, ExecutionException, InterruptedException {
+    Assumptions.assumeTrue(3 <= (Runtime.getRuntime().maxMemory() >> 30), "Fails if max heap size is < 3Gb");
+    int filesCount = 10;
+    page.navigate(server.PREFIX + "/input/fileupload-multi.html");
+    Path uploadFile = tmpDir.resolve("50MB_1.zip");
+    String str = String.join("", Collections.nCopies(1024, "A"));
+
+    try (Writer stream = new OutputStreamWriter(Files.newOutputStream(uploadFile))) {
+      for (int i = 0; i < 49 * 1024; i++) {
+        stream.write(str);
+      }
+    }
+    Locator input = page.locator("input[type='file']");
+    List<Path> uploadFiles = new ArrayList<>();
+    uploadFiles.add(uploadFile);
+    for (int i = 1; i < filesCount; i++) {
+      Path dstFile = tmpDir.resolve("50MB_" + i + ".zip");
+      Files.copy(uploadFile, dstFile);
+      uploadFiles.add(dstFile);
+    }
+    FileChooser fileChooser = page.waitForFileChooser(() -> input.click());
+    fileChooser.setFiles(uploadFiles.toArray(new Path[0]));
+    Object filesLen = page.getByRole(AriaRole.TEXTBOX).evaluate("e => e.files.length");
+    assertTrue(fileChooser.isMultiple());
+    assertEquals(filesCount, filesLen);
+  }
+
   @Test
   void shouldUploadLargeFileWithRelativePath(@TempDir Path tmpDir) throws IOException, ExecutionException, InterruptedException {
     Assumptions.assumeTrue(3 <= (Runtime.getRuntime().maxMemory() >> 30), "Fails if max heap size is < 3Gb");
@@ -116,8 +149,7 @@ public class TestPageSetInputFiles extends TestBase {
       "    return events;\n" +
       "  }");
 
-    Path cwd = Paths.get("").toAbsolutePath();
-    Path relativeUploadPath = cwd.relativize(uploadFile);
+    Path relativeUploadPath = relativePathOrSkipTest(uploadFile);
     assertFalse(relativeUploadPath.isAbsolute());
     input.setInputFiles(relativeUploadPath);
     assertEquals("200MB.zip", input.evaluate("e => e.files[0].name"));
@@ -276,7 +308,18 @@ public class TestPageSetInputFiles extends TestBase {
     assertEquals("file-to-upload.txt", page.evalOnSelector("input", "input => input.files[0].name"));
   }
 
-//  @Test
+  @Test
+  void shouldAcceptSingleFilePayload() {
+    page.setContent("<input type=file oninput='javascript:console.timeStamp()'>");
+    FileChooser fileChooser = page.waitForFileChooser(() -> page.click("input"));
+    assertEquals(page, fileChooser.page());
+    assertNotNull(fileChooser.element());
+    fileChooser.setFiles(new FilePayload("test.txt", "text/plain", "Hello!".getBytes()));
+    assertEquals(1, page.evalOnSelector("input", "input => input.files.length"));
+    assertEquals("test.txt", page.evalOnSelector("input", "input => input.files[0].name"));
+  }
+
+  //  @Test
   void shouldDetectMimeType() throws ExecutionException, InterruptedException {
     // TODO: Parse form fields on server
   }
@@ -373,5 +416,18 @@ public class TestPageSetInputFiles extends TestBase {
     FileChooser fileChooser = page.waitForFileChooser(() -> page.click("input"));
     assertTrue(fileChooser.isMultiple());
   }
+
+  @Test
+  void shouldPreserveLastModifiedTimestamp() throws IOException {
+    page.setContent("<input type=file multiple=true/>");
+    Locator input = page.locator("input");
+    input.setInputFiles(FILE_TO_UPLOAD);
+    assertEquals(asList("file-to-upload.txt"), input.evaluate("e => [...e.files].map(f => f.name)"));
+    List<Double> timestamps = (List<Double>) input.evaluate("e => [...e.files].map(f => f.lastModified)");
+    FileTime expected = Files.getLastModifiedTime(FILE_TO_UPLOAD);
+    // On Linux browser sometimes reduces the timestamp by 1ms: 1696272058110.0715  -> 1696272058109 or even
+    // rounds it to seconds in WebKit: 1696272058110 -> 1696272058000.
+    assertTrue(Math.abs(timestamps.get(0) - expected.toMillis()) < 1000, "expected: " + expected.toMillis() + "; actual: " + timestamps.get(0));
+  }
 }
 

playwright/src/test/java/com/microsoft/playwright/TestPdf.java

@@ -52,6 +52,18 @@ public class TestPdf extends TestBase {
   @DisabledIf(value="com.microsoft.playwright.TestBase#isChromium", disabledReason="skip")
   void shouldThrowInNonChromium() {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.pdf());
-    assertTrue(e.getMessage().contains("Page.pdf only supported in headless Chromium"));
+    assertTrue(e.getMessage().contains("PDF generation is only supported for Headless Chromium"), e.getMessage());
+  }
+
+
+  @Test
+  @DisabledIf(value="com.microsoft.playwright.TestBase#isChromium", disabledReason="skip")
+  void correctExceptionWithPersistentContext(@TempDir Path tempDir) {
+    Path profile = tempDir.resolve("profile");
+    try (BrowserContext context = browserType.launchPersistentContext(profile)) {
+      Page page = context.newPage();
+      PlaywrightException e = assertThrows(PlaywrightException.class, () -> page.pdf());
+      assertTrue(e.getMessage().contains("PDF generation is only supported for Headless Chromium"), e.getMessage());
+    }
   }
 }

playwright/src/test/java/com/microsoft/playwright/TestSelectorsGetBy.java

@@ -153,6 +153,25 @@ public class TestSelectorsGetBy extends TestBase {
     assertThat(page.getByTitle("my title", new Page.GetByTitleOptions().setExact(true))).hasCount(1, new LocatorAssertions.HasCountOptions().setTimeout(500));
     assertThat(page.getByTitle("my t\\itle", new Page.GetByTitleOptions().setExact(true))).hasCount(0, new LocatorAssertions.HasCountOptions().setTimeout(500));
     assertThat(page.getByTitle("my t\\\\itle", new Page.GetByTitleOptions().setExact(true))).hasCount(0, new LocatorAssertions.HasCountOptions().setTimeout(500));
+
+    page.setContent("<label for=target>foo &gt;&gt; bar</label><input id=target>");
+    page.evalOnSelector("input", "input => {\n" +
+      "    input.setAttribute('placeholder', 'foo >> bar');\n" +
+      "    input.setAttribute('title', 'foo >> bar');\n" +
+      "    input.setAttribute('alt', 'foo >> bar');\n" +
+      "  }");
+    assertEquals("foo >> bar", page.getByText("foo >> bar").textContent());
+    assertThat(page.locator("label")).hasText("foo >> bar");
+    assertThat(page.getByText("foo >> bar")).hasText("foo >> bar");
+    assertEquals("foo >> bar", page.getByText(Pattern.compile("foo >> bar")).textContent());
+    assertThat(page.getByLabel("foo >> bar")).hasAttribute("id", "target");
+    assertThat(page.getByLabel(Pattern.compile("foo >> bar"))).hasAttribute("id", "target");
+    assertThat(page.getByPlaceholder("foo >> bar")).hasAttribute("id", "target");
+    assertThat(page.getByAltText("foo >> bar")).hasAttribute("id", "target");
+    assertThat(page.getByTitle("foo >> bar")).hasAttribute("id", "target");
+    assertThat(page.getByPlaceholder(Pattern.compile("foo >> bar"))).hasAttribute("id", "target");
+    assertThat(page.getByAltText(Pattern.compile("foo >> bar"))).hasAttribute("id", "target");
+    assertThat(page.getByTitle(Pattern.compile("foo >> bar"))).hasAttribute("id", "target");
   }
 
   @Test

playwright/src/test/java/com/microsoft/playwright/TestSelectorsMisc.java

@@ -230,4 +230,13 @@ public class TestSelectorsMisc extends TestBase {
     assertEquals("hello", page.locator("div >> internal:or=\"article\"").textContent());
     assertEquals("world", page.locator("span >> internal:or=\"article\"").textContent());
   }
+  @Test
+  void shouldWorkWithInternalChain() {
+    page.setContent("<div>one <span>two</span> <button>three</button> </div>\n" +
+      "    <span>four</span>\n" +
+      "    <button>five</button>");
+    assertEquals(asList("three"), page.evalOnSelectorAll("div >> internal:chain=\"button\"", "els => els.map(e => e.textContent)"));
+    assertEquals(asList("two", "three"), page.evalOnSelectorAll("div >> internal:chain=\"span >> internal:or=\\\"button\\\"\"", "els => els.map(e => e.textContent)"));
+  }
+
 }

playwright/src/test/java/com/microsoft/playwright/TestSelectorsText.java

@@ -9,6 +9,18 @@ import static java.util.Arrays.asList;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
 public class TestSelectorsText extends TestBase {
+
+  @Test
+  void shouldWorkSmoke() {
+    page.setContent("<div>Hi&gt;&gt;<span></span></div>");
+    assertEquals("<span></span>", page.evalOnSelector("text=\"Hi>>\">>span", "e => e.outerHTML"));
+    assertEquals("<span></span>", page.evalOnSelector("text=/Hi\\>\\>/ >> span", "e => e.outerHTML"));
+
+    page.setContent("<div>let's<span>hello</span></div>");
+    assertEquals("<span>hello</span>", page.evalOnSelector("text=/let's/i >> span", "e => e.outerHTML"));
+    assertEquals("<span>hello</span>", page.evalOnSelector("text=/let\'s/i >> span", "e => e.outerHTML"));
+  }
+
   @Test
   void hasTextAndInternalTextShouldMatchFullNodeTextInStrictMode() {
     page.setContent("<div id=div1>hello<span>world</span></div>\n" +

playwright/src/test/java/com/microsoft/playwright/TestUnrouteBehavior.java

@@ -0,0 +1,33 @@
+package com.microsoft.playwright;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public class TestUnrouteBehavior extends TestBase {
+  @Test
+  void contextUnrouteAllRemovesAllHandlers() {
+    context.route("**/*", route -> {
+      route.abort();
+    });
+    context.route("**/empty.html", route -> {
+      route.abort();
+    });
+    context.unrouteAll();
+    page.navigate(server.EMPTY_PAGE);
+  }
+
+  @Test
+  void pageUnrouteAllRemovesAllRoutes() {
+    page.route("**/*", route -> {
+      route.abort();
+    });
+    page.route("**/empty.html", route -> {
+      route.abort();
+    });
+    page.unrouteAll();
+    Response response = page.navigate(server.EMPTY_PAGE);
+    assertTrue(response.ok());
+  }
+
+}

playwright/src/test/java/com/microsoft/playwright/TestVideo.java

@@ -0,0 +1,24 @@
+package com.microsoft.playwright;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.io.TempDir;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+
+import static com.microsoft.playwright.Utils.relativePathOrSkipTest;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public class TestVideo extends TestBase {
+  @Test
+  void shouldWorkWithRelativePathForRecordVideoDir(@TempDir Path tmpDir) {
+    Path relativeDir = relativePathOrSkipTest(tmpDir);
+    BrowserContext context = browser.newContext(new Browser.NewContextOptions()
+      .setRecordVideoSize(320, 240).setRecordVideoDir(relativeDir));
+    Page page = context.newPage();
+    Path videoPath = page.video().path();
+    context.close();
+    assertTrue(videoPath.isAbsolute(), "videosPath = " + videoPath);
+    assertTrue(Files.exists(videoPath), "videosPath = " + videoPath);
+  }
+}

playwright/src/test/java/com/microsoft/playwright/TestWebSocket.java

@@ -199,7 +199,7 @@ public class TestWebSocket extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> {
       ws.waitForFrameSent(() -> page.close());
     });
-    assertTrue(e.getMessage().contains("Page closed"));
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed"), e.getMessage());
   }
 
   @Test

playwright/src/test/java/com/microsoft/playwright/TestWorkers.java

@@ -16,6 +16,7 @@
 
 package com.microsoft.playwright;
 
+import org.junit.jupiter.api.Assumptions;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.condition.DisabledIf;
 import org.junit.jupiter.api.condition.EnabledIf;
@@ -28,6 +29,11 @@ import static org.junit.jupiter.api.Assertions.*;
 
 public class TestWorkers extends TestBase {
 
+  private int browserMajorVersion() {
+    String version = browser.version();
+    return Integer.parseInt(version.split("\\.")[0]);
+  }
+
   @Test
   void pageWorkers() {
     Worker worker = page.waitForWorker(() -> page.navigate(server.PREFIX + "/worker/worker.html"));
@@ -51,7 +57,7 @@ public class TestWorkers extends TestBase {
     PlaywrightException e = assertThrows(PlaywrightException.class, () -> {
       workerThisObj.getProperty("self");
     });
-    assertTrue(e.getMessage().contains("Target closed") || e.getMessage().contains("Worker was closed"), e.getMessage());
+    assertTrue(e.getMessage().contains("Target page, context or browser has been closed") || e.getMessage().contains("Worker was closed"), e.getMessage());
 
   }
 
@@ -145,6 +151,7 @@ public class TestWorkers extends TestBase {
 
   @Test
   void shouldReportNetworkActivity() {
+    Assumptions.assumeFalse(isFirefox() && browserMajorVersion() < 114);
     Worker worker = page.waitForWorker(() -> page.navigate(server.PREFIX + "/worker/worker.html"));
     String url = server.PREFIX + "/one-style.css";
     Request[] request = {null};
@@ -160,6 +167,7 @@ public class TestWorkers extends TestBase {
 
   @Test
   void shouldReportNetworkActivityOnWorkerCreation() {
+    Assumptions.assumeFalse(isFirefox() && browserMajorVersion() < 114);
     // Chromium needs waitForDebugger enabled for this one.
     page.navigate(server.EMPTY_PAGE);
     String url = server.PREFIX + "/one-style.css";

playwright/src/test/java/com/microsoft/playwright/Utils.java

@@ -19,11 +19,13 @@ package com.microsoft.playwright;
 import com.google.gson.Gson;
 import com.google.gson.JsonElement;
 import com.google.gson.JsonParser;
+import org.junit.jupiter.api.Assumptions;
 
 import java.io.*;
 import java.net.ServerSocket;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.nio.file.Paths;
 import java.util.Arrays;
 import java.util.HashMap;
 import java.util.List;
@@ -214,4 +216,17 @@ class Utils {
   static String generateDifferentOriginPort(final Server server){
     return server.PREFIX.replace(String.valueOf(server.PORT), String.valueOf(server.PORT+1));
   }
+
+  static Path relativePathOrSkipTest(Path path) {
+    Path cwd = Paths.get("").toAbsolutePath();
+    try  {
+      return cwd.relativize(path.toAbsolutePath());
+    } catch (IllegalArgumentException e) {
+      // May happen on Windows when the path and temp are on different disks.
+      if (e.getMessage().contains("has different root")) {
+        Assumptions.assumeTrue(false, "cwd is on another disk, skipping the test.");
+      }
+      throw e;
+    }
+  }
 }

playwright/src/test/resources/input/fileupload-multi.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>File upload test</title>
+  </head>
+  <body>
+    <form action="/upload" method="post" enctype="multipart/form-data">
+      <input type="file" multiple name="file1">
+      <input type="submit">
+    </form>
+  </body>
+</html>