From ef666f613ec3a9c14023834dfd1feff7cc5dae22 Mon Sep 17 00:00:00 2001 From: Kevin Bond Date: Sun, 15 Nov 2026 09:21:02 -0500 Subject: [PATCH] docs: document native discovery and authenticator assumptions --- docs/guide/connect-browser.md | 4 ++++ docs/guide/handling-authentication.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/guide/connect-browser.md b/docs/guide/connect-browser.md index 8dbb1861..693287d9 100644 --- a/docs/guide/connect-browser.md +++ b/docs/guide/connect-browser.md @@ -170,3 +170,7 @@ $playwright->close(); - `docs/examples/connect_external_browser.php` - `docs/examples/connect_remote_browser.php` - `docs/examples/launch_server.php` + +## Local browser discovery + +`Browser::bind()` delegates discovery publication to the installed Playwright version. Its descriptor can contain original launch options, including proxy credentials. Keep the Playwright cache private to the owning user and use a restrictive process umask when creating it. Existing cache files also need owner-only access; changing the umask does not change their permissions. This package does not independently redact Playwright's discovery descriptors. diff --git a/docs/guide/handling-authentication.md b/docs/guide/handling-authentication.md index 2bb7b01e..9cf0d8c8 100644 --- a/docs/guide/handling-authentication.md +++ b/docs/guide/handling-authentication.md @@ -123,3 +123,7 @@ class ProfilePageTest extends AuthenticatedTestCase * Use **UI Login** when you are specifically testing the login, password-reset, or logout features. * Use **Reusing Authentication State** for all other tests that require an authenticated user. It will make your test suite significantly faster and more stable. + +## Virtual credentials + +Virtual WebAuthn authenticators are provided by the installed Playwright version. Use disposable test identities and a separate browser context containing only trusted relying-party pages. The wrapper does not independently verify origin claims made through Playwright's virtual-authenticator binding.