@@ -491,6 +491,10 @@ class LaunchPersistentContextOptions {
491491 * {@code pfx}). Optionally, {@code passphrase} property should be provided if the certificate is encrypted. The {@code
492492 * origin} property should be provided with an exact match to the request origin that the certificate is valid for.
493493 *
494+ * <p> Client certificate authentication is only active when at least one client certificate is provided. If you want to reject
495+ * all client certificates sent by the server, you need to provide a client certificate with an {@code origin} that does
496+ * not match any of the domains you plan to visit.
497+ *
494498 * <p> <strong>NOTE:</strong> When using WebKit on macOS, accessing {@code localhost} will not pick up client certificates. You can make it work by
495499 * replacing {@code localhost} with {@code local.playwright}.
496500 */
@@ -813,6 +817,10 @@ public LaunchPersistentContextOptions setChromiumSandbox(boolean chromiumSandbox
813817 * {@code pfx}). Optionally, {@code passphrase} property should be provided if the certificate is encrypted. The {@code
814818 * origin} property should be provided with an exact match to the request origin that the certificate is valid for.
815819 *
820+ * <p> Client certificate authentication is only active when at least one client certificate is provided. If you want to reject
821+ * all client certificates sent by the server, you need to provide a client certificate with an {@code origin} that does
822+ * not match any of the domains you plan to visit.
823+ *
816824 * <p> <strong>NOTE:</strong> When using WebKit on macOS, accessing {@code localhost} will not pick up client certificates. You can make it work by
817825 * replacing {@code localhost} with {@code local.playwright}.
818826 */
@@ -1386,6 +1394,11 @@ default Browser launch() {
13861394 * the **parent** directory of the "Profile Path" seen at {@code chrome://version}.
13871395 *
13881396 * <p> Note that browsers do not allow launching multiple instances with the same User Data Directory.
1397+ *
1398+ * <p> <strong>NOTE:</strong> Chromium/Chrome: Due to recent Chrome policy changes, automating the default Chrome user profile is not supported.
1399+ * Pointing {@code userDataDir} to Chrome's main "User Data" directory (the profile used for your regular browsing) may
1400+ * result in pages not loading or the browser exiting. Create and use a separate directory (for example, an empty folder)
1401+ * as your automation profile instead. See https://developer.chrome.com/blog/remote-debugging-port for details.
13891402 * @since v1.8
13901403 */
13911404 default BrowserContext launchPersistentContext (Path userDataDir ) {
@@ -1406,6 +1419,11 @@ default BrowserContext launchPersistentContext(Path userDataDir) {
14061419 * the **parent** directory of the "Profile Path" seen at {@code chrome://version}.
14071420 *
14081421 * <p> Note that browsers do not allow launching multiple instances with the same User Data Directory.
1422+ *
1423+ * <p> <strong>NOTE:</strong> Chromium/Chrome: Due to recent Chrome policy changes, automating the default Chrome user profile is not supported.
1424+ * Pointing {@code userDataDir} to Chrome's main "User Data" directory (the profile used for your regular browsing) may
1425+ * result in pages not loading or the browser exiting. Create and use a separate directory (for example, an empty folder)
1426+ * as your automation profile instead. See https://developer.chrome.com/blog/remote-debugging-port for details.
14091427 * @since v1.8
14101428 */
14111429 BrowserContext launchPersistentContext (Path userDataDir , LaunchPersistentContextOptions options );
0 commit comments