chore: roll driver to 1.61.0-beta-1781285686000

README.md

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

examples/pom.xml

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

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

@@ -55,6 +55,20 @@ public interface APIResponse {
    * @since v1.16
    */
   boolean ok();
+  /**
+   * Returns SSL and other security information. Resolves to {@code null} for non-HTTPS responses. For redirected requests,
+   * returns the information for the last request in the redirect chain.
+   *
+   * @since v1.61
+   */
+  SecurityDetails securityDetails();
+  /**
+   * Returns the IP address and port of the server. Resolves to {@code null} if the server address is not available. For
+   * redirected requests, returns the information for the last request in the redirect chain.
+   *
+   * @since v1.61
+   */
+  ServerAddr serverAddr();
   /**
    * Contains the status code of the response (e.g., 200 for a success).
    *

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

@@ -563,6 +563,13 @@ public WaitForPageOptions setTimeout(double timeout) {
    * @since v1.45
    */
   Clock clock();
+  /**
+   * Virtual WebAuthn authenticator for this context. Lets tests seed credentials and intercept {@code
+   * navigator.credentials.create()} / {@code navigator.credentials.get()} ceremonies.
+   *
+   * @since v1.61
+   */
+  Credentials credentials();
   /**
    * Debugger allows to pause and resume the execution.
    *

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

@@ -124,6 +124,10 @@ public ConnectOptions setTimeout(double timeout) {
     }
   }
   class ConnectOverCDPOptions {
+    /**
+     * If specified, browser artifacts (such as traces and downloads) are saved into this directory.
+     */
+    public Path artifactsDir;
     /**
      * Additional HTTP headers to be sent with connect request. Optional.
      */
@@ -153,6 +157,13 @@ class ConnectOverCDPOptions {
      */
     public Double timeout;
 
+    /**
+     * If specified, browser artifacts (such as traces and downloads) are saved into this directory.
+     */
+    public ConnectOverCDPOptions setArtifactsDir(Path artifactsDir) {
+      this.artifactsDir = artifactsDir;
+      return this;
+    }
     /**
      * Additional HTTP headers to be sent with connect request. Optional.
      */

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

@@ -0,0 +1,238 @@
+/*
+ * 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.microsoft.playwright.options.*;
+import java.util.*;
+
+/**
+ * {@code Credentials} is a virtual WebAuthn authenticator scoped to a {@code BrowserContext}. It lets tests register
+ * passkeys and answer {@code navigator.credentials.create()} / {@code navigator.credentials.get()} ceremonies in the page,
+ * without a real authenticator or hardware security key.
+ *
+ * <p> There are two common ways to use it:
+ *
+ * <p> <strong>Usage: seed a known credential</strong>
+ * <pre>{@code
+ * BrowserContext context = browser.newContext();
+ *
+ * // A passkey your backend already provisioned for a test user.
+ * context.credentials().create("example.com", new Credentials.CreateOptions()
+ *     .setId(knownCredentialId) // base64url
+ *     .setUserHandle(knownUserHandle) // base64url
+ *     .setPrivateKey(knownPrivateKey) // base64url PKCS#8 (DER)
+ *     .setPublicKey(knownPublicKey)); // base64url SPKI (DER)
+ * context.credentials().install();
+ *
+ * Page page = context.newPage();
+ * page.navigate("https://example.com/login");
+ * // The page's navigator.credentials.get() is answered with the seeded passkey.
+ * }</pre>
+ *
+ * <p> <strong>Usage: capture a passkey, then reuse it</strong>
+ * <pre>{@code
+ * // setup test: let the app register a passkey, then save it.
+ * BrowserContext context = browser.newContext();
+ * context.credentials().install();
+ *
+ * Page page = context.newPage();
+ * page.navigate("https://example.com/register");
+ * page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Create a passkey")).click();
+ *
+ * // Read back the passkey the page registered — it includes the private key.
+ * VirtualCredential credential = context.credentials().get(
+ *     new Credentials.GetOptions().setRpId("example.com")).get(0);
+ * Files.writeString(Paths.get("playwright/.auth/passkey.json"), new Gson().toJson(credential));
+ * }</pre>
+ * <pre>{@code
+ * // later test: seed the captured passkey so the app starts already enrolled.
+ * VirtualCredential credential = new Gson().fromJson(
+ *     Files.readString(Paths.get("playwright/.auth/passkey.json")), VirtualCredential.class);
+ * BrowserContext context = browser.newContext();
+ * context.credentials().create(credential.rpId, new Credentials.CreateOptions()
+ *     .setId(credential.id)
+ *     .setUserHandle(credential.userHandle)
+ *     .setPrivateKey(credential.privateKey)
+ *     .setPublicKey(credential.publicKey));
+ * context.credentials().install();
+ *
+ * Page page = context.newPage();
+ * page.navigate("https://example.com/login");
+ * // navigator.credentials.get() resolves the captured passkey — already signed in.
+ * }</pre>
+ *
+ * <p> <strong>Defaults</strong>
+ */
+public interface Credentials {
+  class CreateOptions {
+    /**
+     * Base64url-encoded credential id. Auto-generated if omitted.
+     */
+    public String id;
+    /**
+     * Base64url-encoded PKCS#8 (DER) private key. Auto-generated if omitted.
+     */
+    public String privateKey;
+    /**
+     * Base64url-encoded SPKI (DER) public key. Auto-generated if omitted.
+     */
+    public String publicKey;
+    /**
+     * Base64url-encoded user handle. Auto-generated if omitted.
+     */
+    public String userHandle;
+
+    /**
+     * Base64url-encoded credential id. Auto-generated if omitted.
+     */
+    public CreateOptions setId(String id) {
+      this.id = id;
+      return this;
+    }
+    /**
+     * Base64url-encoded PKCS#8 (DER) private key. Auto-generated if omitted.
+     */
+    public CreateOptions setPrivateKey(String privateKey) {
+      this.privateKey = privateKey;
+      return this;
+    }
+    /**
+     * Base64url-encoded SPKI (DER) public key. Auto-generated if omitted.
+     */
+    public CreateOptions setPublicKey(String publicKey) {
+      this.publicKey = publicKey;
+      return this;
+    }
+    /**
+     * Base64url-encoded user handle. Auto-generated if omitted.
+     */
+    public CreateOptions setUserHandle(String userHandle) {
+      this.userHandle = userHandle;
+      return this;
+    }
+  }
+  class GetOptions {
+    /**
+     * Only return the credential with this base64url-encoded id.
+     */
+    public String id;
+    /**
+     * Only return credentials for this relying party id.
+     */
+    public String rpId;
+
+    /**
+     * Only return the credential with this base64url-encoded id.
+     */
+    public GetOptions setId(String id) {
+      this.id = id;
+      return this;
+    }
+    /**
+     * Only return credentials for this relying party id.
+     */
+    public GetOptions setRpId(String rpId) {
+      this.rpId = rpId;
+      return this;
+    }
+  }
+  /**
+   * Installs the virtual WebAuthn authenticator into the context, overriding {@code navigator.credentials.create()} and
+   * {@code navigator.credentials.get()} in all current and future pages. Call this before the page first touches {@code
+   * navigator.credentials}.
+   *
+   * <p> Required: until {@link com.microsoft.playwright.Credentials#install Credentials.install()} is called, no interception is
+   * in place and the page sees the platform's native (or absent) WebAuthn behaviour. Seeding credentials with {@link
+   * com.microsoft.playwright.Credentials#create Credentials.create()} without installing populates the authenticator, but
+   * the page will never see those credentials.
+   *
+   * @since v1.61
+   */
+  void install();
+  /**
+   * Seeds a virtual WebAuthn credential and returns it.
+   *
+   * <p> With only {@code rpId}, generates a fresh **ECDSA P-256** keypair, credential id and user handle. The seeded credential
+   * is discoverable (resident), so the page can resolve it from both username-then-passkey and usernameless passkey flows.
+   * The returned object carries the private and public keys, so it can be persisted to disk and re-seeded in a later test.
+   *
+   * <p> To **import a known credential**, supply all four of {@code id}, {@code userHandle}, {@code privateKey} and {@code
+   * publicKey} together.
+   *
+   * <p> Call {@link com.microsoft.playwright.Credentials#install Credentials.install()} before navigating to a page that uses
+   * WebAuthn.
+   *
+   * @param rpId Relying party id (typically the site's effective domain).
+   * @since v1.61
+   */
+  default VirtualCredential create(String rpId) {
+    return create(rpId, null);
+  }
+  /**
+   * Seeds a virtual WebAuthn credential and returns it.
+   *
+   * <p> With only {@code rpId}, generates a fresh **ECDSA P-256** keypair, credential id and user handle. The seeded credential
+   * is discoverable (resident), so the page can resolve it from both username-then-passkey and usernameless passkey flows.
+   * The returned object carries the private and public keys, so it can be persisted to disk and re-seeded in a later test.
+   *
+   * <p> To **import a known credential**, supply all four of {@code id}, {@code userHandle}, {@code privateKey} and {@code
+   * publicKey} together.
+   *
+   * <p> Call {@link com.microsoft.playwright.Credentials#install Credentials.install()} before navigating to a page that uses
+   * WebAuthn.
+   *
+   * @param rpId Relying party id (typically the site's effective domain).
+   * @since v1.61
+   */
+  VirtualCredential create(String rpId, CreateOptions options);
+  /**
+   * Removes a credential from the authenticator by its id. Works for any credential currently held — both those seeded with
+   * {@link com.microsoft.playwright.Credentials#create Credentials.create()} and those the page registered itself by calling
+   * {@code navigator.credentials.create()}.
+   *
+   * @param id Base64url-encoded credential id.
+   * @since v1.61
+   */
+  void delete(String id);
+  /**
+   * Returns every credential currently held by the authenticator, optionally filtered by {@code rpId} or {@code id}. This
+   * includes both credentials seeded with {@link com.microsoft.playwright.Credentials#create Credentials.create()} and
+   * credentials the page registered itself by calling {@code navigator.credentials.create()}.
+   *
+   * <p> Each returned credential includes its private and public keys, so a passkey the app just registered can be saved and
+   * re-seeded into a later test with {@link com.microsoft.playwright.Credentials#create Credentials.create()} — see the
+   * second example in the class overview.
+   *
+   * @since v1.61
+   */
+  default List<VirtualCredential> get() {
+    return get(null);
+  }
+  /**
+   * Returns every credential currently held by the authenticator, optionally filtered by {@code rpId} or {@code id}. This
+   * includes both credentials seeded with {@link com.microsoft.playwright.Credentials#create Credentials.create()} and
+   * credentials the page registered itself by calling {@code navigator.credentials.create()}.
+   *
+   * <p> Each returned credential includes its private and public keys, so a passkey the app just registered can be saved and
+   * re-seeded into a later test with {@link com.microsoft.playwright.Credentials#create Credentials.create()} — see the
+   * second example in the class overview.
+   *
+   * @since v1.61
+   */
+  List<VirtualCredential> get(GetOptions options);
+}
+

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

@@ -2965,7 +2965,7 @@ default Object evalOnSelectorAll(String selector, String expression) {
    * <p> {@code ElementHandle} instances can be passed as an argument to the {@link com.microsoft.playwright.Frame#evaluate
    * Frame.evaluate()}:
    * <pre>{@code
-   * ElementHandle bodyHandle = frame.evaluate("document.body");
+   * ElementHandle bodyHandle = frame.evaluateHandle("document.body");
    * String html = (String) frame.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));
    * bodyHandle.dispose();
    * }</pre>
@@ -3005,7 +3005,7 @@ default Object evaluate(String expression) {
    * <p> {@code ElementHandle} instances can be passed as an argument to the {@link com.microsoft.playwright.Frame#evaluate
    * Frame.evaluate()}:
    * <pre>{@code
-   * ElementHandle bodyHandle = frame.evaluate("document.body");
+   * ElementHandle bodyHandle = frame.evaluateHandle("document.body");
    * String html = (String) frame.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));
    * bodyHandle.dispose();
    * }</pre>

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

@@ -4529,7 +4529,7 @@ default Object evalOnSelectorAll(String selector, String expression) {
    * <p> {@code ElementHandle} instances can be passed as an argument to the {@link com.microsoft.playwright.Page#evaluate
    * Page.evaluate()}:
    * <pre>{@code
-   * ElementHandle bodyHandle = page.evaluate("document.body");
+   * ElementHandle bodyHandle = page.evaluateHandle("document.body");
    * String html = (String) page.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));
    * bodyHandle.dispose();
    * }</pre>
@@ -4571,7 +4571,7 @@ default Object evaluate(String expression) {
    * <p> {@code ElementHandle} instances can be passed as an argument to the {@link com.microsoft.playwright.Page#evaluate
    * Page.evaluate()}:
    * <pre>{@code
-   * ElementHandle bodyHandle = page.evaluate("document.body");
+   * ElementHandle bodyHandle = page.evaluateHandle("document.body");
    * String html = (String) page.evaluate("([body, suffix]) => body.innerHTML + suffix", Arrays.asList(bodyHandle, "hello"));
    * bodyHandle.dispose();
    * }</pre>
@@ -5808,6 +5808,18 @@ default boolean isVisible(String selector) {
    * @since v1.59
    */
   void clearPageErrors();
+  /**
+   * Provides access to the page's {@code localStorage} for the current origin. See {@code WebStorage}.
+   *
+   * @since v1.61
+   */
+  WebStorage localStorage();
+  /**
+   * Provides access to the page's {@code sessionStorage} for the current origin. See {@code WebStorage}.
+   *
+   * @since v1.61
+   */
+  WebStorage sessionStorage();
   /**
    * Returns up to (currently) 200 last console messages from this page. See {@link
    * com.microsoft.playwright.Page#onConsoleMessage Page.onConsoleMessage()} for more details.
@@ -7552,8 +7564,8 @@ default String ariaSnapshot() {
    * <p> When all steps combined have not finished during the specified {@code timeout}, this method throws a {@code
    * TimeoutError}. Passing zero timeout disables this.
    *
-   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#tap Page.tap()} the method will throw if {@code hasTouch} option of the browser
-   * context is false.
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#tap Page.tap()} will throw if the {@code hasTouch} option of the browser context is
+   * false.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @since v1.8
@@ -7575,8 +7587,8 @@ default void tap(String selector) {
    * <p> When all steps combined have not finished during the specified {@code timeout}, this method throws a {@code
    * TimeoutError}. Passing zero timeout disables this.
    *
-   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#tap Page.tap()} the method will throw if {@code hasTouch} option of the browser
-   * context is false.
+   * <p> <strong>NOTE:</strong> {@link com.microsoft.playwright.Page#tap Page.tap()} will throw if the {@code hasTouch} option of the browser context is
+   * false.
    *
    * @param selector A selector to search for an element. If there are multiple elements satisfying the selector, the first will be used.
    * @since v1.8