From 5023775a8310058d161c1853cc8cb3c21dc5f7ca Mon Sep 17 00:00:00 2001
From: "microsoft-playwright-automation[bot]"
 <203992400+microsoft-playwright-automation[bot]@users.noreply.github.com>
Date: Wed, 11 Nov 2026 10:14:24 +0000
Subject: [PATCH] feat(roll): roll to ToT Playwright (11-11-26)

---
 dotnet/docs/actionability.mdx                 |   2 +
 dotnet/docs/api-testing.mdx                   |   2 +
 dotnet/docs/api/class-apirequest.mdx          |   2 +
 dotnet/docs/api/class-apirequestcontext.mdx   |   2 +
 dotnet/docs/api/class-apiresponse.mdx         |   2 +
 .../docs/api/class-apiresponseassertions.mdx  |   2 +
 dotnet/docs/api/class-browser.mdx             |   2 +
 dotnet/docs/api/class-browsercontext.mdx      |   2 +
 dotnet/docs/api/class-browsertype.mdx         |   2 +
 dotnet/docs/api/class-cdpsession.mdx          |   2 +
 dotnet/docs/api/class-cdpsessionevent.mdx     |   2 +
 dotnet/docs/api/class-clock.mdx               |   2 +
 dotnet/docs/api/class-consolemessage.mdx      |   2 +
 dotnet/docs/api/class-credentials.mdx         |   2 +
 dotnet/docs/api/class-debugger.mdx            |   2 +
 dotnet/docs/api/class-dialog.mdx              |   2 +
 dotnet/docs/api/class-download.mdx            |   2 +
 dotnet/docs/api/class-elementhandle.mdx       |   2 +
 dotnet/docs/api/class-filechooser.mdx         |   2 +
 dotnet/docs/api/class-formdata.mdx            |   2 +
 dotnet/docs/api/class-frame.mdx               |   4 +
 dotnet/docs/api/class-framelocator.mdx        |   4 +
 dotnet/docs/api/class-jshandle.mdx            |   2 +
 dotnet/docs/api/class-keyboard.mdx            |   2 +
 dotnet/docs/api/class-locator.mdx             |   4 +
 dotnet/docs/api/class-locatorassertions.mdx   |   2 +
 dotnet/docs/api/class-mouse.mdx               |   2 +
 dotnet/docs/api/class-page.mdx                |   4 +
 dotnet/docs/api/class-pageassertions.mdx      |   2 +
 dotnet/docs/api/class-playwright.mdx          |   2 +
 .../class-playwrightassertionexception.mdx    | 106 +++++
 .../docs/api/class-playwrightassertions.mdx   |   2 +
 dotnet/docs/api/class-playwrightexception.mdx | 107 +++++
 dotnet/docs/api/class-request.mdx             |   2 +
 dotnet/docs/api/class-response.mdx            |   2 +
 dotnet/docs/api/class-route.mdx               |   2 +
 dotnet/docs/api/class-screencast.mdx          |   2 +
 dotnet/docs/api/class-selectors.mdx           |   2 +
 dotnet/docs/api/class-timeouterror.mdx        |   2 +
 dotnet/docs/api/class-touchscreen.mdx         |   2 +
 dotnet/docs/api/class-tracing.mdx             |   2 +
 dotnet/docs/api/class-video.mdx               |   2 +
 dotnet/docs/api/class-weberror.mdx            |   2 +
 dotnet/docs/api/class-webmcp.mdx              |   2 +
 dotnet/docs/api/class-websocket.mdx           |   2 +
 dotnet/docs/api/class-websocketframe.mdx      |   2 +
 dotnet/docs/api/class-websocketroute.mdx      |   2 +
 dotnet/docs/api/class-webstorage.mdx          |   2 +
 dotnet/docs/api/class-worker.mdx              |   2 +
 dotnet/docs/aria-snapshots.mdx                |   2 +
 dotnet/docs/auth.mdx                          |   2 +
 dotnet/docs/browser-contexts.mdx              |   2 +
 dotnet/docs/browsers.mdx                      |   2 +
 dotnet/docs/ci-intro.mdx                      |   2 +
 dotnet/docs/ci.mdx                            |   2 +
 dotnet/docs/clock.mdx                         |   2 +
 dotnet/docs/codegen-intro.mdx                 |   2 +
 dotnet/docs/codegen.mdx                       |   2 +
 dotnet/docs/debug.mdx                         |   2 +
 dotnet/docs/dialogs.mdx                       |   2 +
 dotnet/docs/docker.mdx                        |   2 +
 dotnet/docs/downloads.mdx                     |   2 +
 dotnet/docs/emulation.mdx                     |   2 +
 dotnet/docs/evaluating.mdx                    |   2 +
 dotnet/docs/events.mdx                        |   2 +
 dotnet/docs/extensibility.mdx                 |   2 +
 dotnet/docs/frames.mdx                        |   2 +
 dotnet/docs/getting-started-cli.mdx           | 411 ----------------
 dotnet/docs/getting-started-mcp.mdx           | 338 -------------
 dotnet/docs/handles.mdx                       |   2 +
 dotnet/docs/input.mdx                         |   2 +
 dotnet/docs/intro.mdx                         |   2 +
 dotnet/docs/languages.mdx                     |   2 +
 dotnet/docs/library.mdx                       |   2 +
 dotnet/docs/locators.mdx                      |   2 +
 dotnet/docs/mock.mdx                          |   2 +
 dotnet/docs/navigations.mdx                   |   2 +
 dotnet/docs/network.mdx                       |   2 +
 dotnet/docs/other-locators.mdx                |   2 +
 dotnet/docs/pages.mdx                         |   2 +
 dotnet/docs/pom.mdx                           |   2 +
 dotnet/docs/release-notes.mdx                 |  10 +-
 dotnet/docs/running-tests.mdx                 |   2 +
 dotnet/docs/screenshots.mdx                   |   2 +
 dotnet/docs/selenium-grid.mdx                 |   2 +
 dotnet/docs/test-assertions.mdx               |   4 +-
 dotnet/docs/test-runners.mdx                  | 130 ++++-
 dotnet/docs/touch-events.mdx                  |   2 +
 dotnet/docs/trace-viewer-intro.mdx            |   2 +
 dotnet/docs/trace-viewer.mdx                  |   2 +
 dotnet/docs/videos.mdx                        |   2 +
 dotnet/docs/webview2.mdx                      |   2 +
 dotnet/docs/writing-tests.mdx                 |   2 +
 java/docs/api/class-frame.mdx                 |   2 +
 java/docs/api/class-framelocator.mdx          |   2 +
 java/docs/api/class-locator.mdx               |   2 +
 java/docs/api/class-page.mdx                  |   2 +
 java/docs/api/class-playwrightexception.mdx   |  11 +-
 java/docs/getting-started-cli.mdx             | 415 ----------------
 java/docs/getting-started-mcp.mdx             | 342 --------------
 java/docs/release-notes.mdx                   |   8 +-
 nodejs/docs/api/class-androiddevice.mdx       |   3 +
 nodejs/docs/api/class-apirequestcontext.mdx   |  42 +-
 nodejs/docs/api/class-browser.mdx             |   6 +
 nodejs/docs/api/class-browsertype.mdx         |   3 +
 nodejs/docs/api/class-frame.mdx               |   2 +
 nodejs/docs/api/class-framelocator.mdx        |   2 +
 nodejs/docs/api/class-fullconfig.mdx          |   2 +-
 nodejs/docs/api/class-fullproject.mdx         |  19 +-
 nodejs/docs/api/class-locator.mdx             |   2 +
 nodejs/docs/api/class-page.mdx                |   2 +
 nodejs/docs/api/class-test.mdx                |  10 +-
 nodejs/docs/api/class-testcase.mdx            |   2 +-
 nodejs/docs/api/class-testconfig.mdx          |  25 +-
 nodejs/docs/api/class-testinfo.mdx            |   2 +-
 nodejs/docs/api/class-testoptions.mdx         |  23 +
 nodejs/docs/api/class-testproject.mdx         |  55 ++-
 nodejs/docs/ci.mdx                            |  20 +-
 nodejs/docs/docker.mdx                        |  22 +-
 nodejs/docs/getting-started-cli.mdx           | 445 ------------------
 nodejs/docs/getting-started-mcp.mdx           | 372 ---------------
 nodejs/docs/release-notes.mdx                 |  11 +-
 nodejs/docs/test-retries.mdx                  |  19 +
 nodejs/docs/test-webserver.mdx                |   2 +
 python/docs/api/class-frame.mdx               |   2 +
 python/docs/api/class-framelocator.mdx        |   2 +
 python/docs/api/class-locator.mdx             |   2 +
 python/docs/api/class-page.mdx                |   2 +
 python/docs/ci.mdx                            |  12 +-
 python/docs/clock.mdx                         |   2 +-
 python/docs/docker.mdx                        |  22 +-
 python/docs/getting-started-cli.mdx           | 409 ----------------
 python/docs/getting-started-mcp.mdx           | 336 -------------
 python/docs/release-notes.mdx                 |  10 +-
 134 files changed, 810 insertions(+), 3150 deletions(-)
 create mode 100644 dotnet/docs/api/class-playwrightassertionexception.mdx
 create mode 100644 dotnet/docs/api/class-playwrightexception.mdx
 delete mode 100644 dotnet/docs/getting-started-cli.mdx
 delete mode 100644 dotnet/docs/getting-started-mcp.mdx
 delete mode 100644 java/docs/getting-started-cli.mdx
 delete mode 100644 java/docs/getting-started-mcp.mdx
 delete mode 100644 nodejs/docs/getting-started-cli.mdx
 delete mode 100644 nodejs/docs/getting-started-mcp.mdx
 delete mode 100644 python/docs/getting-started-cli.mdx
 delete mode 100644 python/docs/getting-started-mcp.mdx

diff --git a/dotnet/docs/actionability.mdx b/dotnet/docs/actionability.mdx
index f0e47c24c5..28b4f53d17 100644
--- a/dotnet/docs/actionability.mdx
+++ b/dotnet/docs/actionability.mdx
@@ -160,7 +160,9 @@ For example, consider a scenario where Playwright will click `Sign Up` button re
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api-testing.mdx b/dotnet/docs/api-testing.mdx
index 1c30cbb3a8..b1ceb3550a 100644
--- a/dotnet/docs/api-testing.mdx
+++ b/dotnet/docs/api-testing.mdx
@@ -1594,7 +1594,9 @@ var context = await Browser.NewContextAsync(new() { StorageState = state });
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-apirequest.mdx b/dotnet/docs/api/class-apirequest.mdx
index e73f1a4a73..8fd95d224b 100644
--- a/dotnet/docs/api/class-apirequest.mdx
+++ b/dotnet/docs/api/class-apirequest.mdx
@@ -162,7 +162,9 @@ await ApiRequest.NewContextAsync(options);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-apirequestcontext.mdx b/dotnet/docs/api/class-apirequestcontext.mdx
index a07387244e..851547368f 100644
--- a/dotnet/docs/api/class-apirequestcontext.mdx
+++ b/dotnet/docs/api/class-apirequestcontext.mdx
@@ -751,7 +751,9 @@ ApiRequestContext.Tracing
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-apiresponse.mdx b/dotnet/docs/api/class-apiresponse.mdx
index 4af7de1c15..ed917c3f88 100644
--- a/dotnet/docs/api/class-apiresponse.mdx
+++ b/dotnet/docs/api/class-apiresponse.mdx
@@ -317,7 +317,9 @@ ApiResponse.Url
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-apiresponseassertions.mdx b/dotnet/docs/api/class-apiresponseassertions.mdx
index 04ea542a4b..9e73fc35bc 100644
--- a/dotnet/docs/api/class-apiresponseassertions.mdx
+++ b/dotnet/docs/api/class-apiresponseassertions.mdx
@@ -97,7 +97,9 @@ await Expect(response).Not.ToBeOKAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-browser.mdx b/dotnet/docs/api/class-browser.mdx
index 157791fce6..8b80381b37 100644
--- a/dotnet/docs/api/class-browser.mdx
+++ b/dotnet/docs/api/class-browser.mdx
@@ -730,7 +730,9 @@ Browser.Disconnected += async (_, browser) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-browsercontext.mdx b/dotnet/docs/api/class-browsercontext.mdx
index 5a59d11c13..a1a6fc869c 100644
--- a/dotnet/docs/api/class-browsercontext.mdx
+++ b/dotnet/docs/api/class-browsercontext.mdx
@@ -1491,7 +1491,9 @@ BrowserContext.BackgroundPages
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-browsertype.mdx b/dotnet/docs/api/class-browsertype.mdx
index f5599e241f..d1ffc99d96 100644
--- a/dotnet/docs/api/class-browsertype.mdx
+++ b/dotnet/docs/api/class-browsertype.mdx
@@ -605,7 +605,9 @@ BrowserType.Name
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-cdpsession.mdx b/dotnet/docs/api/class-cdpsession.mdx
index 30bdcaadb8..0d1d7f4e75 100644
--- a/dotnet/docs/api/class-cdpsession.mdx
+++ b/dotnet/docs/api/class-cdpsession.mdx
@@ -142,7 +142,9 @@ CdpSession.Close += async (_, cDPSession) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-cdpsessionevent.mdx b/dotnet/docs/api/class-cdpsessionevent.mdx
index fbd7552e72..6314e3bd2a 100644
--- a/dotnet/docs/api/class-cdpsessionevent.mdx
+++ b/dotnet/docs/api/class-cdpsessionevent.mdx
@@ -75,7 +75,9 @@ CdpSessionEvent.OnEvent += async (_, jsonElement) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-clock.mdx b/dotnet/docs/api/class-clock.mdx
index eb23abf7ef..9ee50d236a 100644
--- a/dotnet/docs/api/class-clock.mdx
+++ b/dotnet/docs/api/class-clock.mdx
@@ -219,7 +219,9 @@ await page.Clock.SetSystemTimeAsync("2020-02-02");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-consolemessage.mdx b/dotnet/docs/api/class-consolemessage.mdx
index 377a84da3e..79c3ed9bfa 100644
--- a/dotnet/docs/api/class-consolemessage.mdx
+++ b/dotnet/docs/api/class-consolemessage.mdx
@@ -180,7 +180,9 @@ ConsoleMessage.Worker
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-credentials.mdx b/dotnet/docs/api/class-credentials.mdx
index d9bebb89ad..da0f1725f1 100644
--- a/dotnet/docs/api/class-credentials.mdx
+++ b/dotnet/docs/api/class-credentials.mdx
@@ -253,7 +253,9 @@ await Credentials.InstallAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-debugger.mdx b/dotnet/docs/api/class-debugger.mdx
index 64d37f47c3..71c214b037 100644
--- a/dotnet/docs/api/class-debugger.mdx
+++ b/dotnet/docs/api/class-debugger.mdx
@@ -172,7 +172,9 @@ Debugger.PausedStateChanged += async (_, void) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-dialog.mdx b/dotnet/docs/api/class-dialog.mdx
index f15f8a1ea9..d0ed597a8c 100644
--- a/dotnet/docs/api/class-dialog.mdx
+++ b/dotnet/docs/api/class-dialog.mdx
@@ -177,7 +177,9 @@ Dialog.Type
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-download.mdx b/dotnet/docs/api/class-download.mdx
index 08dbaa8edf..6b146b046e 100644
--- a/dotnet/docs/api/class-download.mdx
+++ b/dotnet/docs/api/class-download.mdx
@@ -220,7 +220,9 @@ Download.Url
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-elementhandle.mdx b/dotnet/docs/api/class-elementhandle.mdx
index 85054a153c..bee7f6ddb1 100644
--- a/dotnet/docs/api/class-elementhandle.mdx
+++ b/dotnet/docs/api/class-elementhandle.mdx
@@ -1630,7 +1630,9 @@ This method does not work across navigations, use [Page.WaitForSelectorAsync()](
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-filechooser.mdx b/dotnet/docs/api/class-filechooser.mdx
index 51b852384c..e17cdb90ae 100644
--- a/dotnet/docs/api/class-filechooser.mdx
+++ b/dotnet/docs/api/class-filechooser.mdx
@@ -141,7 +141,9 @@ await FileChooser.SetFilesAsync(files, options);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-formdata.mdx b/dotnet/docs/api/class-formdata.mdx
index 7eb9c28a18..070e586d86 100644
--- a/dotnet/docs/api/class-formdata.mdx
+++ b/dotnet/docs/api/class-formdata.mdx
@@ -147,7 +147,9 @@ FormData.Set(name, value);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-frame.mdx b/dotnet/docs/api/class-frame.mdx
index b504397f38..9c7f8b7e94 100644
--- a/dotnet/docs/api/class-frame.mdx
+++ b/dotnet/docs/api/class-frame.mdx
@@ -400,6 +400,8 @@ await page.GetByAltText("Playwright logo").ClickAsync();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
@@ -2783,7 +2785,9 @@ await Frame.WaitForTimeoutAsync(timeout);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-framelocator.mdx b/dotnet/docs/api/class-framelocator.mdx
index 234fa857ec..29e8cefa64 100644
--- a/dotnet/docs/api/class-framelocator.mdx
+++ b/dotnet/docs/api/class-framelocator.mdx
@@ -115,6 +115,8 @@ await page.GetByAltText("Playwright logo").ClickAsync();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
@@ -581,7 +583,9 @@ FrameLocator.Nth(index);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-jshandle.mdx b/dotnet/docs/api/class-jshandle.mdx
index 08aa0631f3..c614d98a87 100644
--- a/dotnet/docs/api/class-jshandle.mdx
+++ b/dotnet/docs/api/class-jshandle.mdx
@@ -211,7 +211,9 @@ await JsHandle.JsonValueAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-keyboard.mdx b/dotnet/docs/api/class-keyboard.mdx
index b35d77a6a8..882fd83303 100644
--- a/dotnet/docs/api/class-keyboard.mdx
+++ b/dotnet/docs/api/class-keyboard.mdx
@@ -254,7 +254,9 @@ await Keyboard.UpAsync(key);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-locator.mdx b/dotnet/docs/api/class-locator.mdx
index d18cc8e65c..667a61d426 100644
--- a/dotnet/docs/api/class-locator.mdx
+++ b/dotnet/docs/api/class-locator.mdx
@@ -1119,6 +1119,8 @@ await page.GetByAltText("Playwright logo").ClickAsync();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
@@ -2771,7 +2773,9 @@ To press a special key, like `Control` or `ArrowDown`, use [Locator.PressAsync()
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-locatorassertions.mdx b/dotnet/docs/api/class-locatorassertions.mdx
index 176cbb25f5..0a6bbd918b 100644
--- a/dotnet/docs/api/class-locatorassertions.mdx
+++ b/dotnet/docs/api/class-locatorassertions.mdx
@@ -938,7 +938,9 @@ await Expect(locator).Not.ToContainTextAsync("error");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-mouse.mdx b/dotnet/docs/api/class-mouse.mdx
index 3dbc2c0237..2e6eeaae65 100644
--- a/dotnet/docs/api/class-mouse.mdx
+++ b/dotnet/docs/api/class-mouse.mdx
@@ -236,7 +236,9 @@ await Mouse.WheelAsync(deltaX, deltaY);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-page.mdx b/dotnet/docs/api/class-page.mdx
index 038aee3e62..1c8956334d 100644
--- a/dotnet/docs/api/class-page.mdx
+++ b/dotnet/docs/api/class-page.mdx
@@ -926,6 +926,8 @@ await page.GetByAltText("Playwright logo").ClickAsync();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
@@ -5209,7 +5211,9 @@ await page.WaitForTimeoutAsync(1000);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-pageassertions.mdx b/dotnet/docs/api/class-pageassertions.mdx
index 28166ba8e7..f3e80e073c 100644
--- a/dotnet/docs/api/class-pageassertions.mdx
+++ b/dotnet/docs/api/class-pageassertions.mdx
@@ -164,7 +164,9 @@ await Expect(Page).Not.ToHaveURLAsync("error");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-playwright.mdx b/dotnet/docs/api/class-playwright.mdx
index 9907a4514c..e766cb81e9 100644
--- a/dotnet/docs/api/class-playwright.mdx
+++ b/dotnet/docs/api/class-playwright.mdx
@@ -180,7 +180,9 @@ Playwright.Webkit
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-playwrightassertionexception.mdx b/dotnet/docs/api/class-playwrightassertionexception.mdx
new file mode 100644
index 0000000000..161957048d
--- /dev/null
+++ b/dotnet/docs/api/class-playwrightassertionexception.mdx
@@ -0,0 +1,106 @@
+---
+id: class-playwrightassertionexception
+title: "PlaywrightAssertionException"
+---
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import HTMLCard from '@site/src/components/HTMLCard';
+
+* extends: [PlaywrightException]
+
+PlaywrightAssertionException is thrown when an [assertion](../test-assertions.mdx) is not met, e.g. [Expect(Locator).ToBeVisibleAsync()](/api/class-locatorassertions.mdx#locator-assertions-to-be-visible) times out waiting for the element. It inherits from [PlaywrightException], so `catch (PlaywrightException)` blocks catch it as well.
+
+```csharp
+try
+{
+    await Expect(page.GetByRole(AriaRole.Button)).ToBeVisibleAsync();
+}
+catch (PlaywrightAssertionException e)
+{
+    Console.WriteLine($"Assertion failed: {e.Message}");
+}
+```
+
+
+
+[APIRequest]: /api/class-apirequest.mdx "APIRequest"
+[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
+[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
+[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
+[Browser]: /api/class-browser.mdx "Browser"
+[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
+[BrowserType]: /api/class-browsertype.mdx "BrowserType"
+[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
+[CDPSessionEvent]: /api/class-cdpsessionevent.mdx "CDPSessionEvent"
+[Clock]: /api/class-clock.mdx "Clock"
+[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
+[Credentials]: /api/class-credentials.mdx "Credentials"
+[Debugger]: /api/class-debugger.mdx "Debugger"
+[Dialog]: /api/class-dialog.mdx "Dialog"
+[Download]: /api/class-download.mdx "Download"
+[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
+[FileChooser]: /api/class-filechooser.mdx "FileChooser"
+[FormData]: /api/class-formdata.mdx "FormData"
+[Frame]: /api/class-frame.mdx "Frame"
+[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
+[JSHandle]: /api/class-jshandle.mdx "JSHandle"
+[Keyboard]: /api/class-keyboard.mdx "Keyboard"
+[Locator]: /api/class-locator.mdx "Locator"
+[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
+[Mouse]: /api/class-mouse.mdx "Mouse"
+[Page]: /api/class-page.mdx "Page"
+[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
+[Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
+[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
+[Request]: /api/class-request.mdx "Request"
+[Response]: /api/class-response.mdx "Response"
+[Route]: /api/class-route.mdx "Route"
+[Screencast]: /api/class-screencast.mdx "Screencast"
+[Selectors]: /api/class-selectors.mdx "Selectors"
+[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
+[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
+[Tracing]: /api/class-tracing.mdx "Tracing"
+[Video]: /api/class-video.mdx "Video"
+[WebError]: /api/class-weberror.mdx "WebError"
+[WebMCP]: /api/class-webmcp.mdx "WebMCP"
+[WebSocket]: /api/class-websocket.mdx "WebSocket"
+[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
+[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
+[WebStorage]: /api/class-webstorage.mdx "WebStorage"
+[Worker]: /api/class-worker.mdx "Worker"
+[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
+[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
+[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
+[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
+[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
+[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
+[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
+[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
+[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
+[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
+
+[bool]: https://docs.microsoft.com/en-us/dotnet/api/system.boolean "bool"
+[Date]: https://learn.microsoft.com/en-us/dotnet/api/system.datetime "DateTime"
+[double]: https://docs.microsoft.com/en-us/dotnet/api/system.double "double"
+[byte]: https://docs.microsoft.com/en-us/dotnet/api/system.byte "byte"
+[int]: https://docs.microsoft.com/en-us/dotnet/api/system.int32 "int"
+[long]: https://docs.microsoft.com/en-us/dotnet/api/system.int64 "long"
+[void]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/void "void"
+[string]: https://docs.microsoft.com/en-us/dotnet/api/system.string "string"
+[URL]: https://nodejs.org/api/url.html "URL"
+[Regex]: https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.regex "Regex"
+
+[Action]: https://docs.microsoft.com/en-us/dotnet/api/system.action-1 "Action"
+[Func]: https://docs.microsoft.com/en-us/dotnet/api/system.func-2 "Func"
+[IEnumerable]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerable "IEnumerable"
+[IReadOnlyList]: https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1?view=net-9.0 "IReadOnlyList"
+[IDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.idictionary "IDictionary"
+[Task]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task?view=net-5.0 "Task"
+[IReadOnlyDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 "IReadOnlyDictionary"
+[JsonElement]: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonelement "JsonElement"
+
+[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "all available image tags"
+[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "Microsoft Artifact Registry"
+[Dockerfile.noble]: https://github.com/microsoft/playwright-dotnet/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/dotnet/docs/api/class-playwrightassertions.mdx b/dotnet/docs/api/class-playwrightassertions.mdx
index 8ff2354d97..efb8268520 100644
--- a/dotnet/docs/api/class-playwrightassertions.mdx
+++ b/dotnet/docs/api/class-playwrightassertions.mdx
@@ -127,7 +127,9 @@ await Expect(Page).ToHaveTitleAsync("News");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-playwrightexception.mdx b/dotnet/docs/api/class-playwrightexception.mdx
new file mode 100644
index 0000000000..bd5f7ecca3
--- /dev/null
+++ b/dotnet/docs/api/class-playwrightexception.mdx
@@ -0,0 +1,107 @@
+---
+id: class-playwrightexception
+title: "PlaywrightException"
+---
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import HTMLCard from '@site/src/components/HTMLCard';
+
+* extends: [RuntimeException]
+
+PlaywrightException is thrown whenever certain operations are terminated abnormally, e.g. browser closes while [Page.EvaluateAsync()](/api/class-page.mdx#page-evaluate) is running.
+
+```csharp
+try
+{
+    await page.EvaluateAsync("() => new Promise(() => {})");
+}
+catch (PlaywrightException e)
+{
+    // When the page closes during the call, the exception message says so.
+    Console.WriteLine(e.Message);
+}
+```
+
+
+
+[APIRequest]: /api/class-apirequest.mdx "APIRequest"
+[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
+[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
+[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
+[Browser]: /api/class-browser.mdx "Browser"
+[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
+[BrowserType]: /api/class-browsertype.mdx "BrowserType"
+[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
+[CDPSessionEvent]: /api/class-cdpsessionevent.mdx "CDPSessionEvent"
+[Clock]: /api/class-clock.mdx "Clock"
+[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
+[Credentials]: /api/class-credentials.mdx "Credentials"
+[Debugger]: /api/class-debugger.mdx "Debugger"
+[Dialog]: /api/class-dialog.mdx "Dialog"
+[Download]: /api/class-download.mdx "Download"
+[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
+[FileChooser]: /api/class-filechooser.mdx "FileChooser"
+[FormData]: /api/class-formdata.mdx "FormData"
+[Frame]: /api/class-frame.mdx "Frame"
+[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
+[JSHandle]: /api/class-jshandle.mdx "JSHandle"
+[Keyboard]: /api/class-keyboard.mdx "Keyboard"
+[Locator]: /api/class-locator.mdx "Locator"
+[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
+[Mouse]: /api/class-mouse.mdx "Mouse"
+[Page]: /api/class-page.mdx "Page"
+[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
+[Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
+[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
+[Request]: /api/class-request.mdx "Request"
+[Response]: /api/class-response.mdx "Response"
+[Route]: /api/class-route.mdx "Route"
+[Screencast]: /api/class-screencast.mdx "Screencast"
+[Selectors]: /api/class-selectors.mdx "Selectors"
+[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
+[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
+[Tracing]: /api/class-tracing.mdx "Tracing"
+[Video]: /api/class-video.mdx "Video"
+[WebError]: /api/class-weberror.mdx "WebError"
+[WebMCP]: /api/class-webmcp.mdx "WebMCP"
+[WebSocket]: /api/class-websocket.mdx "WebSocket"
+[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
+[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
+[WebStorage]: /api/class-webstorage.mdx "WebStorage"
+[Worker]: /api/class-worker.mdx "Worker"
+[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
+[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
+[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
+[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
+[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
+[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
+[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
+[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
+[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
+[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
+
+[bool]: https://docs.microsoft.com/en-us/dotnet/api/system.boolean "bool"
+[Date]: https://learn.microsoft.com/en-us/dotnet/api/system.datetime "DateTime"
+[double]: https://docs.microsoft.com/en-us/dotnet/api/system.double "double"
+[byte]: https://docs.microsoft.com/en-us/dotnet/api/system.byte "byte"
+[int]: https://docs.microsoft.com/en-us/dotnet/api/system.int32 "int"
+[long]: https://docs.microsoft.com/en-us/dotnet/api/system.int64 "long"
+[void]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/void "void"
+[string]: https://docs.microsoft.com/en-us/dotnet/api/system.string "string"
+[URL]: https://nodejs.org/api/url.html "URL"
+[Regex]: https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.regex "Regex"
+
+[Action]: https://docs.microsoft.com/en-us/dotnet/api/system.action-1 "Action"
+[Func]: https://docs.microsoft.com/en-us/dotnet/api/system.func-2 "Func"
+[IEnumerable]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerable "IEnumerable"
+[IReadOnlyList]: https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1?view=net-9.0 "IReadOnlyList"
+[IDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.idictionary "IDictionary"
+[Task]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task?view=net-5.0 "Task"
+[IReadOnlyDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 "IReadOnlyDictionary"
+[JsonElement]: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonelement "JsonElement"
+
+[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "all available image tags"
+[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "Microsoft Artifact Registry"
+[Dockerfile.noble]: https://github.com/microsoft/playwright-dotnet/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/dotnet/docs/api/class-request.mdx b/dotnet/docs/api/class-request.mdx
index 0cd4fa0910..3935a081de 100644
--- a/dotnet/docs/api/class-request.mdx
+++ b/dotnet/docs/api/class-request.mdx
@@ -463,7 +463,9 @@ Request.Url
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-response.mdx b/dotnet/docs/api/class-response.mdx
index 94808a3d15..6e25fb5ad6 100644
--- a/dotnet/docs/api/class-response.mdx
+++ b/dotnet/docs/api/class-response.mdx
@@ -402,7 +402,9 @@ Response.Url
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-route.mdx b/dotnet/docs/api/class-route.mdx
index af39c13ad3..e6a6d35585 100644
--- a/dotnet/docs/api/class-route.mdx
+++ b/dotnet/docs/api/class-route.mdx
@@ -338,7 +338,9 @@ Route.Request
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-screencast.mdx b/dotnet/docs/api/class-screencast.mdx
index 946e737e48..f51ecb5f2f 100644
--- a/dotnet/docs/api/class-screencast.mdx
+++ b/dotnet/docs/api/class-screencast.mdx
@@ -276,7 +276,9 @@ await Screencast.StopAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-selectors.mdx b/dotnet/docs/api/class-selectors.mdx
index 95ec44abe6..e081c96806 100644
--- a/dotnet/docs/api/class-selectors.mdx
+++ b/dotnet/docs/api/class-selectors.mdx
@@ -120,7 +120,9 @@ Selectors.SetTestIdAttribute(attributeName);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-timeouterror.mdx b/dotnet/docs/api/class-timeouterror.mdx
index 0949b56856..2e2cee3bd9 100644
--- a/dotnet/docs/api/class-timeouterror.mdx
+++ b/dotnet/docs/api/class-timeouterror.mdx
@@ -56,7 +56,9 @@ catch (TimeoutException)
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-touchscreen.mdx b/dotnet/docs/api/class-touchscreen.mdx
index 355eb4d43e..90ea67f07b 100644
--- a/dotnet/docs/api/class-touchscreen.mdx
+++ b/dotnet/docs/api/class-touchscreen.mdx
@@ -73,7 +73,9 @@ await Touchscreen.TapAsync(x, y);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-tracing.mdx b/dotnet/docs/api/class-tracing.mdx
index 247b127774..22c5faf697 100644
--- a/dotnet/docs/api/class-tracing.mdx
+++ b/dotnet/docs/api/class-tracing.mdx
@@ -343,7 +343,9 @@ await Tracing.StopHarAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-video.mdx b/dotnet/docs/api/class-video.mdx
index 1e28efe785..a8898533f7 100644
--- a/dotnet/docs/api/class-video.mdx
+++ b/dotnet/docs/api/class-video.mdx
@@ -101,7 +101,9 @@ await Video.SaveAsAsync(path);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-weberror.mdx b/dotnet/docs/api/class-weberror.mdx
index 2b9aab99e5..31f6089857 100644
--- a/dotnet/docs/api/class-weberror.mdx
+++ b/dotnet/docs/api/class-weberror.mdx
@@ -107,7 +107,9 @@ WebError.Page
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-webmcp.mdx b/dotnet/docs/api/class-webmcp.mdx
index 6a42b0cee2..81241b4ba5 100644
--- a/dotnet/docs/api/class-webmcp.mdx
+++ b/dotnet/docs/api/class-webmcp.mdx
@@ -125,7 +125,9 @@ await WebMCP.ToolsAsync(options);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-websocket.mdx b/dotnet/docs/api/class-websocket.mdx
index c29af3134c..a83da81823 100644
--- a/dotnet/docs/api/class-websocket.mdx
+++ b/dotnet/docs/api/class-websocket.mdx
@@ -147,7 +147,9 @@ WebSocket.SocketError += async (_, value) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-websocketframe.mdx b/dotnet/docs/api/class-websocketframe.mdx
index 4ffa5bb9ab..f0a2cec908 100644
--- a/dotnet/docs/api/class-websocketframe.mdx
+++ b/dotnet/docs/api/class-websocketframe.mdx
@@ -75,7 +75,9 @@ WebSocketFrame.Text
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-websocketroute.mdx b/dotnet/docs/api/class-websocketroute.mdx
index 1790f059e2..99ba0aba91 100644
--- a/dotnet/docs/api/class-websocketroute.mdx
+++ b/dotnet/docs/api/class-websocketroute.mdx
@@ -268,7 +268,9 @@ WebSocketRoute.Url
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-webstorage.mdx b/dotnet/docs/api/class-webstorage.mdx
index c6349ef57b..41e5a64ba0 100644
--- a/dotnet/docs/api/class-webstorage.mdx
+++ b/dotnet/docs/api/class-webstorage.mdx
@@ -160,7 +160,9 @@ await WebStorage.SetItemAsync(name, value);
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/api/class-worker.mdx b/dotnet/docs/api/class-worker.mdx
index 8c71e22148..a75d16ff43 100644
--- a/dotnet/docs/api/class-worker.mdx
+++ b/dotnet/docs/api/class-worker.mdx
@@ -164,7 +164,9 @@ Worker.Console += async (_, consoleMessage) => {};
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/aria-snapshots.mdx b/dotnet/docs/aria-snapshots.mdx
index 16b829c5bb..7f95b7fbdc 100644
--- a/dotnet/docs/aria-snapshots.mdx
+++ b/dotnet/docs/aria-snapshots.mdx
@@ -422,7 +422,9 @@ The `aria-invalid` value is surfaced directly. A value of `true` renders as `[in
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/auth.mdx b/dotnet/docs/auth.mdx
index 711b384349..9fa66362d7 100644
--- a/dotnet/docs/auth.mdx
+++ b/dotnet/docs/auth.mdx
@@ -153,7 +153,9 @@ await context.AddInitScriptAsync(@"(storage => {
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/browser-contexts.mdx b/dotnet/docs/browser-contexts.mdx
index 38f6f93c4c..d820b2c4d5 100644
--- a/dotnet/docs/browser-contexts.mdx
+++ b/dotnet/docs/browser-contexts.mdx
@@ -87,7 +87,9 @@ class Program
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/browsers.mdx b/dotnet/docs/browsers.mdx
index bfb9af9b99..17b1b202f2 100644
--- a/dotnet/docs/browsers.mdx
+++ b/dotnet/docs/browsers.mdx
@@ -566,7 +566,9 @@ pwsh bin/Debug/netX/playwright.ps1 uninstall --all
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/ci-intro.mdx b/dotnet/docs/ci-intro.mdx
index 4512d83787..01c90e398c 100644
--- a/dotnet/docs/ci-intro.mdx
+++ b/dotnet/docs/ci-intro.mdx
@@ -125,7 +125,9 @@ Artifacts like trace files or console logs contain information about your test e
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/ci.mdx b/dotnet/docs/ci.mdx
index db35a54b0f..517c5c500b 100644
--- a/dotnet/docs/ci.mdx
+++ b/dotnet/docs/ci.mdx
@@ -268,7 +268,9 @@ xvfb-run dotnet test
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/clock.mdx b/dotnet/docs/clock.mdx
index 369a61d6de..f0460cecfe 100644
--- a/dotnet/docs/clock.mdx
+++ b/dotnet/docs/clock.mdx
@@ -215,7 +215,9 @@ await Expect(locator).ToHaveTextAsync("2/2/2024, 10:00:02 AM");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/codegen-intro.mdx b/dotnet/docs/codegen-intro.mdx
index 259bfe69dd..0413cb288b 100644
--- a/dotnet/docs/codegen-intro.mdx
+++ b/dotnet/docs/codegen-intro.mdx
@@ -91,7 +91,9 @@ You can generate tests using emulation for specific viewports, devices, color sc
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/codegen.mdx b/dotnet/docs/codegen.mdx
index a74c02fe3a..bd42041867 100644
--- a/dotnet/docs/codegen.mdx
+++ b/dotnet/docs/codegen.mdx
@@ -205,7 +205,9 @@ await page.PauseAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/debug.mdx b/dotnet/docs/debug.mdx
index b60a677aca..1a3ebc0d88 100644
--- a/dotnet/docs/debug.mdx
+++ b/dotnet/docs/debug.mdx
@@ -292,7 +292,9 @@ await using var browser = await playwright.Chromium.LaunchAsync(new()
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/dialogs.mdx b/dotnet/docs/dialogs.mdx
index d39a40e087..f5a8aea5bc 100644
--- a/dotnet/docs/dialogs.mdx
+++ b/dotnet/docs/dialogs.mdx
@@ -101,7 +101,9 @@ This will wait for the print dialog to be opened after the button is clicked. Ma
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/docker.mdx b/dotnet/docs/docker.mdx
index deb21cf97d..45c5152645 100644
--- a/dotnet/docs/docker.mdx
+++ b/dotnet/docs/docker.mdx
@@ -190,7 +190,9 @@ curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --install-dir /
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/downloads.mdx b/dotnet/docs/downloads.mdx
index ab0f0c85e5..1c8d9b9258 100644
--- a/dotnet/docs/downloads.mdx
+++ b/dotnet/docs/downloads.mdx
@@ -73,7 +73,9 @@ For uploading files, see the [uploading files](./input.mdx#upload-files) section
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/emulation.mdx b/dotnet/docs/emulation.mdx
index 5b64818e36..7ae8a47446 100644
--- a/dotnet/docs/emulation.mdx
+++ b/dotnet/docs/emulation.mdx
@@ -237,7 +237,9 @@ var context = await browser.NewContextAsync(new() { JavaScriptEnabled = false })
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/evaluating.mdx b/dotnet/docs/evaluating.mdx
index 7fda36d298..b1b222427e 100644
--- a/dotnet/docs/evaluating.mdx
+++ b/dotnet/docs/evaluating.mdx
@@ -135,7 +135,9 @@ await Page.AddInitScriptAsync(scriptPath: "mocks/preload.js");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/events.mdx b/dotnet/docs/events.mdx
index f3d5a740a5..ea81ef809b 100644
--- a/dotnet/docs/events.mdx
+++ b/dotnet/docs/events.mdx
@@ -80,7 +80,9 @@ await page.GotoAsync("https://www.openstreetmap.org/");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/extensibility.mdx b/dotnet/docs/extensibility.mdx
index 0b51c2e72c..2a78174cb2 100644
--- a/dotnet/docs/extensibility.mdx
+++ b/dotnet/docs/extensibility.mdx
@@ -75,7 +75,9 @@ await page.Locator("tag=div").GetByText("Click me").ClickAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/frames.mdx b/dotnet/docs/frames.mdx
index b5de4404ab..4ef762459e 100644
--- a/dotnet/docs/frames.mdx
+++ b/dotnet/docs/frames.mdx
@@ -69,7 +69,9 @@ await frame.FillAsync("#username-input", "John");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/getting-started-cli.mdx b/dotnet/docs/getting-started-cli.mdx
deleted file mode 100644
index b149b7468f..0000000000
--- a/dotnet/docs/getting-started-cli.mdx
+++ /dev/null
@@ -1,411 +0,0 @@
----
-id: getting-started-cli
-title: "Coding agents"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-Playwright comes with `playwright-cli`, a command-line interface for browser automation designed for coding agents. It provides token-efficient browser control through concise CLI commands and installable skills, making it ideal for agents that need to balance browser automation with large codebases and reasoning within limited context windows.
-
-### `playwright-cli` vs Playwright MCP
-- **`playwright-cli`** is best for **coding agents** (Claude Code, GitHub Copilot, etc.) that favor token-efficient, skill-based workflows. CLI commands avoid loading large tool schemas and verbose accessibility trees into the model context.
-- **MCP** is best for specialized agentic loops that benefit from persistent state and iterative reasoning over page structure, such as exploratory automation or long-running autonomous workflows. See the [MCP getting started guide](./getting-started-mcp.mdx).
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- A coding agent: Claude Code, GitHub Copilot, or similar
-
-## Installation
-
-Install `playwright-cli` globally:
-
-```bash
-npm install -g @playwright/cli@latest
-playwright-cli --help
-```
-
-Alternatively, install `@playwright/cli` as a local dependency and use `npx`:
-
-```bash
-npm install -D @playwright/cli@latest
-npx playwright cli --help
-```
-
-### Installing skills
-
-Coding agents like Claude Code and GitHub Copilot can use locally installed skills for richer context about available commands:
-
-```bash
-playwright-cli install --skills
-```
-
-To share the skills across all your projects, add the `-g` flag to install them into your home directory (`~/.claude/skills` or, with `--skills=agents`, `~/.agents/skills`):
-
-```bash
-playwright-cli install --skills -g
-```
-
-### Skills-less operation
-
-You can also point your agent at the CLI directly and let it discover commands on its own:
-
-```txt
-Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
-Check playwright-cli --help for available commands.
-```
-
-## First Steps
-
-### Interactive demo
-
-Try asking your coding agent:
-
-```txt
-Use playwright skills to test https://demo.playwright.dev/todomvc/.
-Take screenshots for all successful and failing scenarios.
-```
-
-### Manual walkthrough
-
-You can also run commands manually to see how the CLI works:
-
-```bash
-playwright-cli open https://demo.playwright.dev/todomvc/ --headed
-playwright-cli type "Buy groceries"
-playwright-cli press Enter
-playwright-cli type "Water flowers"
-playwright-cli press Enter
-playwright-cli check e21
-playwright-cli screenshot
-```
-
-After each command, the CLI outputs a snapshot of the current page state:
-
-```txt
-### Page
-- Page URL: https://demo.playwright.dev/todomvc/#/
-- Page Title: React • TodoMVC
-### Snapshot
-[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
-```
-
-## Core Commands
-
-### Interacting with pages
-
-```bash
-playwright-cli open [url]               # open browser, optionally navigate to url
-playwright-cli goto <url>               # navigate to a url
-playwright-cli click <ref> [button]     # click an element
-playwright-cli type <text>              # type text into editable element
-playwright-cli fill <ref> <text>        # fill text into editable element
-playwright-cli select <ref> <value>     # select an option in a dropdown
-playwright-cli check <ref>              # check a checkbox or radio button
-playwright-cli uncheck <ref>            # uncheck a checkbox
-playwright-cli hover <ref>              # hover over element
-playwright-cli drag <startRef> <endRef> # drag and drop between elements
-playwright-cli upload <files...>        # upload one or multiple files
-playwright-cli close                    # close the page
-```
-
-### Targeting elements
-
-Use element refs from snapshots to target elements:
-
-```bash
-playwright-cli snapshot                 # get snapshot with element refs
-playwright-cli click e15                # click using a ref
-```
-
-You can also use CSS or role selectors:
-
-```bash
-playwright-cli click "#main > button.submit"
-playwright-cli click "role=button[name=Submit]"
-playwright-cli click "#footer >> role=button[name=Submit]"
-```
-
-### Screenshots and snapshots
-
-```bash
-playwright-cli snapshot                 # capture page snapshot
-playwright-cli snapshot --filename=f    # save snapshot to specific file
-playwright-cli screenshot               # screenshot of the current page
-playwright-cli screenshot [ref]         # screenshot of a specific element
-playwright-cli screenshot --filename=f  # save with specific filename
-playwright-cli screenshot --hires       # capture using device pixels
-playwright-cli pdf                      # save page as PDF
-```
-
-### Navigation
-
-```bash
-playwright-cli go-back                  # go back
-playwright-cli go-forward               # go forward
-playwright-cli reload                   # reload the page
-```
-
-### Keyboard and mouse
-
-```bash
-playwright-cli press <key>              # press a key (e.g. Enter, ArrowLeft)
-playwright-cli keydown <key>            # key down
-playwright-cli keyup <key>              # key up
-playwright-cli mousemove <x> <y>        # move mouse
-playwright-cli mousedown [button]       # mouse button down
-playwright-cli mouseup [button]         # mouse button up
-playwright-cli mousewheel <dx> <dy>     # scroll
-```
-
-### Tabs
-
-```bash
-playwright-cli tab-list                 # list all tabs
-playwright-cli tab-new [url]            # create a new tab
-playwright-cli tab-select <index>       # select a tab
-playwright-cli tab-close [index]        # close a tab
-```
-
-### Network
-
-```bash
-playwright-cli requests                 # list network requests since page load
-playwright-cli request <num>            # show full details of a single request
-playwright-cli route <pattern> [opts]   # mock network requests
-playwright-cli route-list               # list active routes
-playwright-cli unroute [pattern]        # remove routes
-```
-
-### Storage
-
-```bash
-playwright-cli state-save [filename]    # save storage state (cookies, localStorage)
-playwright-cli state-load <filename>    # load storage state
-
-# Cookies
-playwright-cli cookie-list [--domain]   # list cookies
-playwright-cli cookie-get <name>        # get a cookie
-playwright-cli cookie-set <name> <val>  # set a cookie
-playwright-cli cookie-delete <name>     # delete a cookie
-playwright-cli cookie-clear             # clear all cookies
-
-# localStorage
-playwright-cli localstorage-list        # list entries
-playwright-cli localstorage-get <key>   # get value
-playwright-cli localstorage-set <k> <v> # set value
-playwright-cli localstorage-delete <k>  # delete entry
-playwright-cli localstorage-clear       # clear all
-```
-
-### DevTools
-
-```bash
-playwright-cli console [min-level]      # list console messages
-playwright-cli eval <func> [ref]        # evaluate JavaScript on page
-playwright-cli run-code <code>          # run Playwright code snippet
-playwright-cli tracing-start            # start trace recording
-playwright-cli tracing-stop             # stop trace recording
-playwright-cli video-start              # start video recording
-playwright-cli video-chapter <title>    # add chapter marker to video
-playwright-cli video-stop --filename=f  # stop video recording
-```
-
-### WebMCP
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools a page registers are listed at the top of the page snapshot, and they can be called directly:
-
-```bash
-playwright-cli webmcp-list                       # list tools registered by the page
-playwright-cli webmcp-call <name> [--params]     # call one, passing a JSON object
-```
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Sessions
-
-The CLI keeps the browser profile in memory by default — cookies and storage state are preserved between calls within a session but lost when the browser closes. Use `--persistent` to save the profile to disk.
-
-### Named sessions
-
-Run multiple browser instances for different projects:
-
-```bash
-playwright-cli open https://playwright.dev
-playwright-cli -s=example open https://example.com --persistent
-playwright-cli list                     # list all sessions
-```
-
-You can configure your coding agent to use a specific session:
-
-```bash
-PLAYWRIGHT_CLI_SESSION=todo-app claude .
-```
-
-### Session management
-
-```bash
-playwright-cli list                     # list all sessions
-playwright-cli close-all                # close all browsers
-playwright-cli kill-all                 # forcefully kill all browser processes
-playwright-cli -s=name delete-data      # delete user data for a named session
-```
-
-A headless session shuts itself down after an hour without commands, so a session an agent forgot to close does not keep a browser running. Headed and attached browsers are never closed automatically. Change the timeout with `open --idle-timeout=<ms>` or `timeouts.idle` in the config file, and pass `0` to disable it.
-
-## Monitoring
-
-Use `playwright-cli show` to open a visual dashboard for observing and controlling all running browser sessions:
-
-```bash
-playwright-cli show
-```
-
-The dashboard provides:
-- **Session grid** — all active sessions grouped by workspace, each with a live screencast preview, session name, current URL, and page title. Click any session to zoom in.
-- **Session detail** — a live view of the selected session with tab bar, navigation controls, and full remote control. Click into the viewport to take over mouse and keyboard; press Escape to release.
-
-## Configuration
-
-### Headed mode
-
-The CLI runs headless by default. To see the browser:
-
-```bash
-playwright-cli open https://playwright.dev --headed
-```
-
-### Browser selection
-
-```bash
-playwright-cli open --browser=chrome    # use specific browser
-playwright-cli open --browser=firefox
-playwright-cli open --browser=webkit
-playwright-cli open --browser=msedge
-```
-
-### Configuration file
-
-For advanced settings, use a JSON config file:
-
-```bash
-playwright-cli --config path/to/config.json open example.com
-```
-
-The CLI also loads `.playwright/cli.config.json` automatically if present. The config file supports browser options, context options, network rules, timeouts, and more. Run `playwright-cli --help` for the full list of options.
-
-### Browser extension
-
-Connect to your existing browser tabs instead of launching a new browser:
-
-```bash
-playwright-cli attach --extension
-```
-
-This requires the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md) to be installed.
-
-## Quick Reference
-
-| Action                    | Command                                             |
-| ------------------------- | --------------------------------------------------- |
-| **Install CLI**           | `npm install -g @playwright/cli@latest`             |
-| **Install skills**        | `playwright-cli install --skills`                   |
-| **Open a page**           | `playwright-cli open https://example.com`           |
-| **Click an element**      | `playwright-cli click e15`                          |
-| **Type text**             | `playwright-cli type "hello world"`                 |
-| **Take a screenshot**     | `playwright-cli screenshot`                         |
-| **Get page snapshot**     | `playwright-cli snapshot`                           |
-| **Run headed**            | `playwright-cli open https://example.com --headed`  |
-| **Use Firefox**           | `playwright-cli open --browser=firefox`             |
-| **Monitor sessions**      | `playwright-cli show`                               |
-| **List page WebMCP tools** | `playwright-cli webmcp-list`                       |
-
-## What's Next
-- [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
-- [Run your tests on CI](./ci-intro.mdx)
-- [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[CDPSessionEvent]: /api/class-cdpsessionevent.mdx "CDPSessionEvent"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[bool]: https://docs.microsoft.com/en-us/dotnet/api/system.boolean "bool"
-[Date]: https://learn.microsoft.com/en-us/dotnet/api/system.datetime "DateTime"
-[double]: https://docs.microsoft.com/en-us/dotnet/api/system.double "double"
-[byte]: https://docs.microsoft.com/en-us/dotnet/api/system.byte "byte"
-[int]: https://docs.microsoft.com/en-us/dotnet/api/system.int32 "int"
-[long]: https://docs.microsoft.com/en-us/dotnet/api/system.int64 "long"
-[void]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/void "void"
-[string]: https://docs.microsoft.com/en-us/dotnet/api/system.string "string"
-[URL]: https://nodejs.org/api/url.html "URL"
-[Regex]: https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.regex "Regex"
-
-[Action]: https://docs.microsoft.com/en-us/dotnet/api/system.action-1 "Action"
-[Func]: https://docs.microsoft.com/en-us/dotnet/api/system.func-2 "Func"
-[IEnumerable]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerable "IEnumerable"
-[IReadOnlyList]: https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1?view=net-9.0 "IReadOnlyList"
-[IDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.idictionary "IDictionary"
-[Task]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task?view=net-5.0 "Task"
-[IReadOnlyDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 "IReadOnlyDictionary"
-[JsonElement]: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonelement "JsonElement"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-dotnet/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/dotnet/docs/getting-started-mcp.mdx b/dotnet/docs/getting-started-mcp.mdx
deleted file mode 100644
index 5e349945cd..0000000000
--- a/dotnet/docs/getting-started-mcp.mdx
+++ /dev/null
@@ -1,338 +0,0 @@
----
-id: getting-started-mcp
-title: "Playwright MCP"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-The Playwright MCP server provides browser automation capabilities through the [Model Context Protocol](https://modelcontextprotocol.io), enabling LLMs to interact with web pages using structured accessibility snapshots. It works with VS Code, Cursor, Windsurf, Claude Desktop, and any other MCP client — no vision models required.
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- An MCP client: VS Code, Cursor, Windsurf, Claude Code, Claude Desktop, or similar
-
-## Getting Started
-
-### Installation
-
-Add the Playwright MCP server to your client using the standard configuration:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
-```
-
-#### VS Code
-
-Click one of the buttons below to install directly:
-
-[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D)
-
-Or install via the VS Code CLI:
-
-```bash
-code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
-```
-
-#### Cursor
-
-[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=Playwright&config=eyJjb21tYW5kIjoibnB4IEBwbGF5d3JpZ2h0L21jcEBsYXRlc3QifQ%3D%3D)
-
-Or go to `Cursor Settings` → `MCP` → `Add new MCP Server` and use command type with `npx @playwright/mcp@latest`.
-
-#### Claude Code
-
-```bash
-claude mcp add playwright npx @playwright/mcp@latest
-```
-
-#### Claude Desktop
-
-Follow the MCP install [guide](https://modelcontextprotocol.io/quickstart/user) and use the standard config above.
-
-#### Other clients
-
-The standard configuration works with most MCP clients, including Windsurf, Cline, Goose, Kiro, Codex, Copilot CLI, and others. Consult your client's MCP documentation for where to place the config.
-
-### First interaction
-
-Once the server is connected, ask your AI assistant to interact with a web page:
-
-```txt
-Navigate to https://demo.playwright.dev/todomvc and add a few todo items.
-```
-
-The assistant will use Playwright MCP tools to open the browser, navigate to the page, and interact with elements — all through structured accessibility snapshots rather than screenshots.
-
-## Core Features
-
-### Accessibility snapshots
-
-Playwright MCP operates on the page's accessibility tree, not pixels. When a tool runs, it returns a structured snapshot showing the page elements, their roles, and text content. The LLM uses element references from these snapshots to interact with the page:
-
-```txt
-- heading "todos" [level=1]
-- textbox "What needs to be done?" [ref=e5]
-- listitem:
-  - checkbox "Toggle Todo" [ref=e10]
-  - text: "Buy groceries"
-```
-
-The LLM reads this snapshot and uses `ref=e5` to type into the textbox or `ref=e10` to check the checkbox.
-
-### Interacting with pages
-
-Playwright MCP provides tools for all common browser interactions:
--   **Navigation**: Open URLs, go back/forward, reload pages.
--   **Clicking and typing**: Click elements, type text, fill forms, select dropdowns.
--   **Screenshots**: Capture the current page or specific elements for visual verification.
--   **Keyboard and mouse**: Press keys, hover, drag and drop.
--   **Dialogs**: Accept or dismiss browser dialogs.
--   **Tabs**: Create, close, and switch between browser tabs.
-
-### Running Playwright code
-
-For complex interactions that go beyond individual tool calls, use the `browser_run_code_unsafe` tool to execute Playwright scripts directly. This tool runs arbitrary JavaScript in the Playwright server process and is RCE-equivalent — only enable it for trusted MCP clients:
-
-```txt
-Run this Playwright code to verify the todo count:
-async (page) => {
-  const count = await page.getByTestId('todo-count').textContent();
-  return count;
-}
-```
-
-### Network monitoring and mocking
-
-Inspect network traffic and mock API responses:
--   **View network requests**: List all requests made since page load.
--   **Mock routes**: Set up URL pattern matching to return custom responses.
--   **Console messages**: Access browser console output for debugging.
-
-### Storage state
-
-Save and restore browser state including cookies and localStorage:
--   **Save state**: Persist authentication and session data to a file.
--   **Restore state**: Load previously saved state into a new session.
--   **Cookie management**: List, get, set, and delete individual cookies.
-
-### WebMCP tools
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools of the current tab are offered as MCP tools named `webmcp_<tool>`.
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Configuration
-
-### Headed mode
-
-By default, Playwright MCP runs the browser in headed mode so you can see what's happening. To run headless:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headless"
-      ]
-    }
-  }
-}
-```
-
-### Browser selection
-
-Choose which browser to use:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--browser=firefox"
-      ]
-    }
-  }
-}
-```
-
-Supported values: `chrome`, `firefox`, `webkit`, `msedge`.
-
-### User profile
-
-Playwright MCP supports three profile modes:
--   **Persistent (default)**: Login state and cookies are preserved between sessions. The profile is stored in `ms-playwright/mcp-{channel}-{workspace-hash}` in your platform's cache directory, so different projects get separate profiles automatically. Override with `--user-data-dir`.
--   **Isolated**: Each session starts fresh. Pass `--isolated` to enable. You can load initial state with `--storage-state`.
--   **Browser extension**: Connect to your existing browser tabs with the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md). Pass `--extension` to enable.
-
-### Idle timeout
-
-A page that keeps animating or rendering costs CPU for as long as the browser is open, and an agent session can last hours. A headless browser launched by the server is therefore closed after an hour without tool calls. Headed browsers, and browsers attached over `--cdp-endpoint` or `--extension`, are never closed automatically. Pass `--idle-timeout` to set the timeout in milliseconds for any mode, or `0` to disable it:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--idle-timeout=300000"
-      ]
-    }
-  }
-}
-```
-
-When no tool call has completed for that long, the browser is closed, headed or not, the same way as if you had closed it by hand. The next tool call launches a new browser, so the agent navigates again. The timer never fires while a tool call is running.
--   With `--isolated`, cookies and storage kept in memory are lost on an idle close. Use the persistent profile or `--storage-state` to keep them. Each client has its own timer: the context of an idle client is closed while other clients keep working, and the browser is closed once no client has a context.
--   With `--cdp-endpoint` or `--extension`, the browser is not owned by the server, so there is no default timeout, and an explicit one only disconnects from it, leaving its pages open. With `--extension`, the next tool call goes through the connect flow again.
--   With `--shared-browser-context`, the timer spans all clients: a client that is idle while others keep working keeps its tabs and state, and the shared browser is closed only once every client has been idle for the timeout.
-
-### Configuration file
-
-For advanced configuration, use a JSON config file:
-
-```bash
-npx @playwright/mcp@latest --config path/to/config.json
-```
-
-The config file supports browser options, context options, network rules, timeouts, and more. See the [Playwright MCP repository](https://github.com/microsoft/playwright-mcp/blob/main/config.d.ts) for the full schema.
-
-### Standalone server
-
-When running a headed browser on a system without a display or from IDE worker processes, start the MCP server separately with HTTP transport:
-
-```bash
-npx @playwright/mcp@latest --port 8931
-```
-
-HTTP sessions use a five-second heartbeat timeout. If your MCP client or proxy does not answer server-initiated pings, set `PLAYWRIGHT_MCP_PING_TIMEOUT_MS` to a longer timeout in milliseconds. Set it to `0` to disable the heartbeat.
-
-Then point your MCP client to the HTTP endpoint:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "url": "http://localhost:8931/mcp"
-    }
-  }
-}
-```
-
-## Quick Reference
-
-| Action                    | How to do it                                                  |
-| ------------------------- | ------------------------------------------------------------- |
-| **Install server**        | Add standard config to your MCP client                        |
-| **Navigate to a page**    | Ask: "Go to https://example.com"                              |
-| **Click an element**      | Ask: "Click the Submit button"                                |
-| **Fill a form**           | Ask: "Fill in the email field with test@example.com"          |
-| **Take a screenshot**     | Ask: "Take a screenshot of the page"                          |
-| **Run Playwright code**   | Ask: "Run this Playwright code: ..."                          |
-| **Mock an API**           | Ask: "Mock the /api/users endpoint to return ..."             |
-| **Use headed mode**       | Default. Pass `--headless` to disable                         |
-| **Choose a browser**      | Pass `--browser=firefox` in args                              |
-
-## What's Next
--   [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
--   [Run your tests on CI](./ci-intro.mdx)
--   [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[CDPSessionEvent]: /api/class-cdpsessionevent.mdx "CDPSessionEvent"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[bool]: https://docs.microsoft.com/en-us/dotnet/api/system.boolean "bool"
-[Date]: https://learn.microsoft.com/en-us/dotnet/api/system.datetime "DateTime"
-[double]: https://docs.microsoft.com/en-us/dotnet/api/system.double "double"
-[byte]: https://docs.microsoft.com/en-us/dotnet/api/system.byte "byte"
-[int]: https://docs.microsoft.com/en-us/dotnet/api/system.int32 "int"
-[long]: https://docs.microsoft.com/en-us/dotnet/api/system.int64 "long"
-[void]: https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/builtin-types/void "void"
-[string]: https://docs.microsoft.com/en-us/dotnet/api/system.string "string"
-[URL]: https://nodejs.org/api/url.html "URL"
-[Regex]: https://docs.microsoft.com/en-us/dotnet/api/system.text.regularexpressions.regex "Regex"
-
-[Action]: https://docs.microsoft.com/en-us/dotnet/api/system.action-1 "Action"
-[Func]: https://docs.microsoft.com/en-us/dotnet/api/system.func-2 "Func"
-[IEnumerable]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.ienumerable "IEnumerable"
-[IReadOnlyList]: https://learn.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlylist-1?view=net-9.0 "IReadOnlyList"
-[IDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.idictionary "IDictionary"
-[Task]: https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task?view=net-5.0 "Task"
-[IReadOnlyDictionary]: https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.ireadonlydictionary-2 "IReadOnlyDictionary"
-[JsonElement]: https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonelement "JsonElement"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/dotnet/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-dotnet/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/dotnet/docs/handles.mdx b/dotnet/docs/handles.mdx
index 7e06be84be..e19488c497 100644
--- a/dotnet/docs/handles.mdx
+++ b/dotnet/docs/handles.mdx
@@ -142,7 +142,9 @@ await locator.ClickAsync();
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/input.mdx b/dotnet/docs/input.mdx
index 48ce85a342..45755fac47 100644
--- a/dotnet/docs/input.mdx
+++ b/dotnet/docs/input.mdx
@@ -291,7 +291,9 @@ await page.GetByTestId("scrolling-container").EvaluateAsync("e => e.scrollTop +=
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/intro.mdx b/dotnet/docs/intro.mdx
index 8d5097274a..e00fdff186 100644
--- a/dotnet/docs/intro.mdx
+++ b/dotnet/docs/intro.mdx
@@ -315,7 +315,9 @@ See our doc on [Running and Debugging Tests](./running-tests.mdx) to learn more
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/languages.mdx b/dotnet/docs/languages.mdx
index c601682aa7..ea56e493e8 100644
--- a/dotnet/docs/languages.mdx
+++ b/dotnet/docs/languages.mdx
@@ -63,7 +63,9 @@ Playwright for .NET comes with MSTest, NUnit, xUnit, and xUnit v3 [base classes]
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/library.mdx b/dotnet/docs/library.mdx
index 0a71e3ac69..99a60a2b5e 100644
--- a/dotnet/docs/library.mdx
+++ b/dotnet/docs/library.mdx
@@ -126,7 +126,9 @@ or:
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/locators.mdx b/dotnet/docs/locators.mdx
index d4daf1125a..3d4bbd1079 100644
--- a/dotnet/docs/locators.mdx
+++ b/dotnet/docs/locators.mdx
@@ -965,7 +965,9 @@ For less commonly used locators, look at the [other locators](./other-locators.m
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/mock.mdx b/dotnet/docs/mock.mdx
index 6db79f3b7e..37773cb13a 100644
--- a/dotnet/docs/mock.mdx
+++ b/dotnet/docs/mock.mdx
@@ -224,7 +224,9 @@ For more details, see [WebSocketRoute].
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/navigations.mdx b/dotnet/docs/navigations.mdx
index 2788b7d57e..67496e3e17 100644
--- a/dotnet/docs/navigations.mdx
+++ b/dotnet/docs/navigations.mdx
@@ -119,7 +119,9 @@ Playwright splits the process of showing a new document in a page into **navigat
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/network.mdx b/dotnet/docs/network.mdx
index 9ff329cf06..141098b37c 100644
--- a/dotnet/docs/network.mdx
+++ b/dotnet/docs/network.mdx
@@ -288,7 +288,9 @@ It might be that you are using a mock tool such as Mock Service Worker (MSW). Wh
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/other-locators.mdx b/dotnet/docs/other-locators.mdx
index fd57573022..78c1e30b1c 100644
--- a/dotnet/docs/other-locators.mdx
+++ b/dotnet/docs/other-locators.mdx
@@ -436,7 +436,9 @@ For example, `css=article >> text=Hello` captures the element with the text `Hel
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/pages.mdx b/dotnet/docs/pages.mdx
index 3c62abde71..478f848e2d 100644
--- a/dotnet/docs/pages.mdx
+++ b/dotnet/docs/pages.mdx
@@ -121,7 +121,9 @@ page.Popup += async  (_, popup) => {
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/pom.mdx b/dotnet/docs/pom.mdx
index b5adb0738a..cfda101738 100644
--- a/dotnet/docs/pom.mdx
+++ b/dotnet/docs/pom.mdx
@@ -88,7 +88,9 @@ await page.SearchAsync("search query");
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/release-notes.mdx b/dotnet/docs/release-notes.mdx
index 98db0da3b5..9cf2ad8fbc 100644
--- a/dotnet/docs/release-notes.mdx
+++ b/dotnet/docs/release-notes.mdx
@@ -32,7 +32,7 @@ Console.WriteLine(normalized.ToString());
 - The `ParamsString` option in [APIRequestContext] requests is now appended to the query that the URL already has, instead of replacing it.
 
 ### Browser Versions
-- Chromium 158.0.8127.2
+- Chromium 158.0.8127.18
 - Mozilla Firefox 159.0
 - WebKit 27.2
 
@@ -58,9 +58,9 @@ var result = await page.Webmcp.CallToolAsync("add", new { a = 2, b = 40 });
 Console.WriteLine(result?.GetProperty("content")[0].GetProperty("text")); // "42"
 ```
 
-[Playwright MCP](./getting-started-mcp.mdx) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+[Playwright MCP](https://playwright.dev/mcp/introduction) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
 
-[`playwright-cli`](./getting-started-cli.mdx) exposes them as well:
+[`playwright-cli`](https://playwright.dev/agent-cli/introduction) exposes them as well:
 
 ```bash
 playwright-cli webmcp-list
@@ -93,7 +93,7 @@ await page.Screencast.ShowActionsAsync(new()
 - New [Style](/api/class-screencast.mdx#screencast-show-actions-option-style) option takes CSS declarations for the `point` marker, the target `highlight` and the action `title`. It replaces the `FontSize` option, which is now deprecated.
 - The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
 - Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better quality.
-- All video options are also available in [Playwright MCP](./getting-started-mcp.mdx) and [`playwright-cli`](./getting-started-cli.mdx).
+- All video options are also available in [Playwright MCP](https://playwright.dev/mcp/introduction) and [`playwright-cli`](https://playwright.dev/agent-cli/introduction).
 
 ### 🪆 Locator.within()
 
@@ -2165,7 +2165,9 @@ This version of Playwright was also tested against the following stable channels
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/running-tests.mdx b/dotnet/docs/running-tests.mdx
index 55060240e9..0e3d94053c 100644
--- a/dotnet/docs/running-tests.mdx
+++ b/dotnet/docs/running-tests.mdx
@@ -276,7 +276,9 @@ Check out our [debugging guide](./debug.mdx) to learn more about the [Playwright
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/screenshots.mdx b/dotnet/docs/screenshots.mdx
index a47be249ac..9bb92aa387 100644
--- a/dotnet/docs/screenshots.mdx
+++ b/dotnet/docs/screenshots.mdx
@@ -77,7 +77,9 @@ await page.Locator(".header").ScreenshotAsync(new() { Path = "screenshot.png" })
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/selenium-grid.mdx b/dotnet/docs/selenium-grid.mdx
index 738f2c070b..284fd621a2 100644
--- a/dotnet/docs/selenium-grid.mdx
+++ b/dotnet/docs/selenium-grid.mdx
@@ -152,7 +152,9 @@ This means that Selenium 3 is supported in a best-effort manner, where Playwrigh
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/test-assertions.mdx b/dotnet/docs/test-assertions.mdx
index aadb02a21a..3d94e804d2 100644
--- a/dotnet/docs/test-assertions.mdx
+++ b/dotnet/docs/test-assertions.mdx
@@ -64,7 +64,7 @@ await Expect(Page.GetByText("Name"), "should be logged in").ToBeVisibleAsync();
 When expect fails, the error would look like this:
 
 ```bash
-Microsoft.Playwright.PlaywrightException : should be logged in
+Microsoft.Playwright.PlaywrightAssertionException : should be logged in
 
 Locator expected to be visible
 Call log:
@@ -204,7 +204,9 @@ await Expect(Page.GetByText("Name")).ToBeVisibleAsync(new() { Timeout = 10_000 }
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/test-runners.mdx b/dotnet/docs/test-runners.mdx
index 794353d1e7..3135af99c3 100644
--- a/dotnet/docs/test-runners.mdx
+++ b/dotnet/docs/test-runners.mdx
@@ -8,7 +8,7 @@ import HTMLCard from '@site/src/components/HTMLCard';
 
 ## Introduction
 
-While Playwright for .NET isn't tied to a particular test runner or testing framework, in our experience the easiest way of getting started is by using the base classes we provide for MSTest, NUnit, xUnit, or xUnit v3. These classes support running tests on multiple browser engines, adjusting launch/context options and getting a [Page]/[BrowserContext] instance per test out of the box. 
+While Playwright for .NET isn't tied to a particular test runner or testing framework, in our experience the easiest way of getting started is by using the base classes we provide for MSTest, NUnit, xUnit, or xUnit v3. These classes support running tests on multiple browser engines, adjusting launch/context options and getting a [Page]/[BrowserContext] instance per test out of the box.
 
 Playwright and Browser instances will be reused between tests for better performance. We recommend running each test case in a new BrowserContext, this way browser state will be isolated between the tests.
 
@@ -276,6 +276,120 @@ public class UnitTest1 : PageTest
 dotnet test -- Playwright.BrowserName=chromium Playwright.LaunchOptions.Headless=false Playwright.LaunchOptions.Channel=msedge
 ```
 
+## Retrying failed tests
+
+Playwright for .NET does not retry failed tests itself, use the retries of your test runner. NUnit and MSTest have an attribute that retries a single test, and [Microsoft.Testing.Platform](#retrying-with-microsofttestingplatform) can retry all failed tests of a run. Every attempt gets a new [BrowserContext] and [Page].
+
+<Tabs groupId="test-runners" defaultValue="mstest" values={[ {label: 'MSTest', value: 'mstest'}, {label: 'NUnit', value: 'nunit'}, {label: 'xUnit', value: 'xunit'}, {label: 'xUnit v3', value: 'xunit-v3'}, ] }>
+
+<TabItem value="nunit">
+
+Add the [`Retry`](https://docs.nunit.org/articles/nunit/writing-tests/attributes/retry.html) attribute to a test method. Its argument is the total number of attempts, so `[Retry(3)]` retries a failed test up to two times.
+
+By default NUnit only retries a test that failed an NUnit assertion. Playwright assertions throw [PlaywrightAssertionException], other Playwright errors throw [PlaywrightException] and actions that time out throw `TimeoutException`, so pass them all as `RetryExceptions`. This property requires NUnit 4.5 or later.
+
+```csharp
+using Microsoft.Playwright;
+using Microsoft.Playwright.NUnit;
+
+namespace PlaywrightTests;
+
+[Parallelizable(ParallelScope.Self)]
+[TestFixture]
+public class MyTest : PageTest
+{
+    [Test]
+    [Retry(3, RetryExceptions = [typeof(PlaywrightException), typeof(PlaywrightAssertionException), typeof(TimeoutException)])]
+    public async Task TestWithRetries()
+    {
+        await Page.GotoAsync("https://playwright.dev");
+        await Expect(Page.GetByRole(AriaRole.Link, new() { Name = "Get started" })).ToBeVisibleAsync();
+    }
+}
+```
+
+</TabItem>
+
+<TabItem value="mstest">
+
+Add the [`Retry`](https://learn.microsoft.com/en-us/dotnet/core/testing/unit-testing-mstest-writing-tests-controlling-execution) attribute to a test method. It requires MSTest 3.8 or later. Its argument is the number of retries, so `[Retry(2)]` runs a failing test up to three times. MSTest retries after any failure, including a failed Playwright assertion and a timeout.
+
+```csharp
+using System.Threading.Tasks;
+using Microsoft.Playwright;
+using Microsoft.Playwright.MSTest;
+using Microsoft.VisualStudio.TestTools.UnitTesting;
+
+namespace PlaywrightTests;
+
+[TestClass]
+public class ExampleTest : PageTest
+{
+    [TestMethod]
+    [Retry(2)]
+    public async Task TestWithRetries()
+    {
+        await Page.GotoAsync("https://playwright.dev");
+        await Expect(Page.GetByRole(AriaRole.Link, new() { Name = "Get started" })).ToBeVisibleAsync();
+    }
+}
+```
+
+</TabItem>
+
+<TabItem value="xunit">
+
+xUnit v2 has no built-in way to retry failed tests. Retries need xUnit v3, which runs on [Microsoft.Testing.Platform](#retrying-with-microsofttestingplatform).
+
+</TabItem>
+
+<TabItem value="xunit-v3">
+
+xUnit v3 has no retry attribute. Retry failed tests with [Microsoft.Testing.Platform](#retrying-with-microsofttestingplatform).
+
+</TabItem>
+
+</Tabs>
+
+### Retrying with Microsoft.Testing.Platform
+
+The [retry extension](https://learn.microsoft.com/en-us/dotnet/core/testing/microsoft-testing-platform-retry) of Microsoft.Testing.Platform reruns the failed tests of a run in a new process, without changes to the tests. It works with MSTest, NUnit and xUnit v3, but not with xUnit v2.
+
+First, run your tests on Microsoft.Testing.Platform. xUnit v3 [supports it](https://xunit.net/docs/getting-started/v3/microsoft-testing-platform) out of the box. For MSTest, set `EnableMSTestRunner` in the project file, and for NUnit set `EnableNUnitRunner`:
+
+```xml
+<PropertyGroup>
+  <OutputType>Exe</OutputType>
+  <EnableMSTestRunner>true</EnableMSTestRunner>
+</PropertyGroup>
+```
+
+With the .NET 10 SDK, `dotnet test` also needs the following `global.json` file:
+
+```json
+{
+  "test": {
+    "runner": "Microsoft.Testing.Platform"
+  }
+}
+```
+
+Then add the extension to the test project:
+
+```bash
+dotnet add package Microsoft.Testing.Extensions.Retry
+```
+
+:::note
+The major version of the package has to match the version of Microsoft.Testing.Platform that your test runner uses, otherwise no tests run. For example, xUnit v3 3.x needs version 1.x of the package, and xUnit v3 4.x needs version 2.x.
+:::
+
+Now you can retry each failed test up to two times:
+
+```bash
+dotnet test --retry-failed-tests 2
+```
+
 ## Using Verbose API Logs
 
 When you have enabled the [verbose API log](./debug.mdx#verbose-api-logs), via the `DEBUG` environment variable, you will see the messages in the standard error stream. Within Visual Studio, that will be the `Tests` pane of the `Output` window. It will also be displayed in the `Test Log` for each test.
@@ -293,7 +407,7 @@ For example, to specify the number of workers you can use `NUnit.NumberOfTestWor
 ```xml
 <?xml version="1.0" encoding="utf-8"?>
 <RunSettings>
-  <!-- NUnit adapter -->  
+  <!-- NUnit adapter -->
   <NUnit>
     <NumberOfTestWorkers>24</NumberOfTestWorkers>
   </NUnit>
@@ -304,7 +418,7 @@ For example, to specify the number of workers you can use `NUnit.NumberOfTestWor
       <DEBUG>pw:api</DEBUG>
     </EnvironmentVariables>
   </RunConfiguration>
-  <!-- Playwright -->  
+  <!-- Playwright -->
   <Playwright>
     <BrowserName>chromium</BrowserName>
     <ExpectTimeout>5000</ExpectTimeout>
@@ -324,7 +438,7 @@ For example, to specify the number of workers, you can use `MSTest.Parallelize.W
 
 ```xml
 <RunSettings>
-  <!-- MSTest adapter -->  
+  <!-- MSTest adapter -->
   <MSTest>
     <Parallelize>
       <Workers>4</Workers>
@@ -338,7 +452,7 @@ For example, to specify the number of workers, you can use `MSTest.Parallelize.W
       <DEBUG>pw:api</DEBUG>
     </EnvironmentVariables>
   </RunConfiguration>
-  <!-- Playwright -->  
+  <!-- Playwright -->
   <Playwright>
     <BrowserName>chromium</BrowserName>
     <ExpectTimeout>5000</ExpectTimeout>
@@ -370,7 +484,7 @@ For example, to specify the number of workers, you can use `xUnit.MaxParallelThr
       <DEBUG>pw:api</DEBUG>
     </EnvironmentVariables>
   </RunConfiguration>
-  <!-- Playwright -->  
+  <!-- Playwright -->
   <Playwright>
     <BrowserName>chromium</BrowserName>
     <ExpectTimeout>5000</ExpectTimeout>
@@ -402,7 +516,7 @@ For example, to specify the number of workers, you can use `xUnit.MaxParallelThr
       <DEBUG>pw:api</DEBUG>
     </EnvironmentVariables>
   </RunConfiguration>
-  <!-- Playwright -->  
+  <!-- Playwright -->
   <Playwright>
     <BrowserName>chromium</BrowserName>
     <ExpectTimeout>5000</ExpectTimeout>
@@ -484,7 +598,9 @@ There are a few base classes available to you in `Microsoft.Playwright.Xunit.v3`
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/touch-events.mdx b/dotnet/docs/touch-events.mdx
index c9063d7174..b30d909932 100644
--- a/dotnet/docs/touch-events.mdx
+++ b/dotnet/docs/touch-events.mdx
@@ -186,7 +186,9 @@ public class TouchEvents
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/trace-viewer-intro.mdx b/dotnet/docs/trace-viewer-intro.mdx
index f6a300f0cb..9b249a3b3f 100644
--- a/dotnet/docs/trace-viewer-intro.mdx
+++ b/dotnet/docs/trace-viewer-intro.mdx
@@ -290,7 +290,9 @@ Check out our detailed guide on [Trace Viewer](/trace-viewer.mdx) to learn more
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/trace-viewer.mdx b/dotnet/docs/trace-viewer.mdx
index 68a9acbe44..2be275a565 100644
--- a/dotnet/docs/trace-viewer.mdx
+++ b/dotnet/docs/trace-viewer.mdx
@@ -627,7 +627,9 @@ Next to the Actions tab you will find the Metadata tab which will show you more
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/videos.mdx b/dotnet/docs/videos.mdx
index 60d5dc20f5..55c1ad63c3 100644
--- a/dotnet/docs/videos.mdx
+++ b/dotnet/docs/videos.mdx
@@ -74,7 +74,9 @@ Note that the video is only available after the page or browser context is close
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/webview2.mdx b/dotnet/docs/webview2.mdx
index 9cc8e0a0ca..2a068416d4 100644
--- a/dotnet/docs/webview2.mdx
+++ b/dotnet/docs/webview2.mdx
@@ -433,7 +433,9 @@ For debugging tests, see the Playwright [Debugging guide](./debug).
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/dotnet/docs/writing-tests.mdx b/dotnet/docs/writing-tests.mdx
index 24cd1a5558..b4ea45ee9b 100644
--- a/dotnet/docs/writing-tests.mdx
+++ b/dotnet/docs/writing-tests.mdx
@@ -521,7 +521,9 @@ public class UnitTest1: PageTest
 [Page]: /api/class-page.mdx "Page"
 [PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
 [Playwright]: /api/class-playwright.mdx "Playwright"
+[PlaywrightAssertionException]: /api/class-playwrightassertionexception.mdx "PlaywrightAssertionException"
 [PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
+[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
 [Request]: /api/class-request.mdx "Request"
 [Response]: /api/class-response.mdx "Response"
 [Route]: /api/class-route.mdx "Route"
diff --git a/java/docs/api/class-frame.mdx b/java/docs/api/class-frame.mdx
index e866393a5a..d01406e471 100644
--- a/java/docs/api/class-frame.mdx
+++ b/java/docs/api/class-frame.mdx
@@ -403,6 +403,8 @@ page.getByAltText("Playwright logo").click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/java/docs/api/class-framelocator.mdx b/java/docs/api/class-framelocator.mdx
index a9d4895ae9..dc1cf99f64 100644
--- a/java/docs/api/class-framelocator.mdx
+++ b/java/docs/api/class-framelocator.mdx
@@ -115,6 +115,8 @@ page.getByAltText("Playwright logo").click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/java/docs/api/class-locator.mdx b/java/docs/api/class-locator.mdx
index 6554528567..1b9214b2eb 100644
--- a/java/docs/api/class-locator.mdx
+++ b/java/docs/api/class-locator.mdx
@@ -1121,6 +1121,8 @@ page.getByAltText("Playwright logo").click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/java/docs/api/class-page.mdx b/java/docs/api/class-page.mdx
index 560e7ba7e2..f7e03d8027 100644
--- a/java/docs/api/class-page.mdx
+++ b/java/docs/api/class-page.mdx
@@ -933,6 +933,8 @@ page.getByAltText("Playwright logo").click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/java/docs/api/class-playwrightexception.mdx b/java/docs/api/class-playwrightexception.mdx
index be03fffe34..700b3c85e9 100644
--- a/java/docs/api/class-playwrightexception.mdx
+++ b/java/docs/api/class-playwrightexception.mdx
@@ -8,7 +8,16 @@ import HTMLCard from '@site/src/components/HTMLCard';
 
 * extends: [RuntimeException]
 
-PlaywrightException is thrown whenever certain operations are terminated abnormally, e.g. browser closes while [Page.evaluate()](/api/class-page.mdx#page-evaluate) is running. All Playwright exceptions inherit from this class.
+PlaywrightException is thrown whenever certain operations are terminated abnormally, e.g. browser closes while [Page.evaluate()](/api/class-page.mdx#page-evaluate) is running.
+
+```java
+try {
+  page.evaluate("() => new Promise(() => {})");
+} catch (PlaywrightException e) {
+  // When the page closes during the call, the exception message says so.
+  System.out.println(e.getMessage());
+}
+```
 
 
 
diff --git a/java/docs/getting-started-cli.mdx b/java/docs/getting-started-cli.mdx
deleted file mode 100644
index 7f59e827aa..0000000000
--- a/java/docs/getting-started-cli.mdx
+++ /dev/null
@@ -1,415 +0,0 @@
----
-id: getting-started-cli
-title: "Coding agents"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-Playwright comes with `playwright-cli`, a command-line interface for browser automation designed for coding agents. It provides token-efficient browser control through concise CLI commands and installable skills, making it ideal for agents that need to balance browser automation with large codebases and reasoning within limited context windows.
-
-### `playwright-cli` vs Playwright MCP
-- **`playwright-cli`** is best for **coding agents** (Claude Code, GitHub Copilot, etc.) that favor token-efficient, skill-based workflows. CLI commands avoid loading large tool schemas and verbose accessibility trees into the model context.
-- **MCP** is best for specialized agentic loops that benefit from persistent state and iterative reasoning over page structure, such as exploratory automation or long-running autonomous workflows. See the [MCP getting started guide](./getting-started-mcp.mdx).
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- A coding agent: Claude Code, GitHub Copilot, or similar
-
-## Installation
-
-Install `playwright-cli` globally:
-
-```bash
-npm install -g @playwright/cli@latest
-playwright-cli --help
-```
-
-Alternatively, install `@playwright/cli` as a local dependency and use `npx`:
-
-```bash
-npm install -D @playwright/cli@latest
-npx playwright cli --help
-```
-
-### Installing skills
-
-Coding agents like Claude Code and GitHub Copilot can use locally installed skills for richer context about available commands:
-
-```bash
-playwright-cli install --skills
-```
-
-To share the skills across all your projects, add the `-g` flag to install them into your home directory (`~/.claude/skills` or, with `--skills=agents`, `~/.agents/skills`):
-
-```bash
-playwright-cli install --skills -g
-```
-
-### Skills-less operation
-
-You can also point your agent at the CLI directly and let it discover commands on its own:
-
-```txt
-Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
-Check playwright-cli --help for available commands.
-```
-
-## First Steps
-
-### Interactive demo
-
-Try asking your coding agent:
-
-```txt
-Use playwright skills to test https://demo.playwright.dev/todomvc/.
-Take screenshots for all successful and failing scenarios.
-```
-
-### Manual walkthrough
-
-You can also run commands manually to see how the CLI works:
-
-```bash
-playwright-cli open https://demo.playwright.dev/todomvc/ --headed
-playwright-cli type "Buy groceries"
-playwright-cli press Enter
-playwright-cli type "Water flowers"
-playwright-cli press Enter
-playwright-cli check e21
-playwright-cli screenshot
-```
-
-After each command, the CLI outputs a snapshot of the current page state:
-
-```txt
-### Page
-- Page URL: https://demo.playwright.dev/todomvc/#/
-- Page Title: React • TodoMVC
-### Snapshot
-[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
-```
-
-## Core Commands
-
-### Interacting with pages
-
-```bash
-playwright-cli open [url]               # open browser, optionally navigate to url
-playwright-cli goto <url>               # navigate to a url
-playwright-cli click <ref> [button]     # click an element
-playwright-cli type <text>              # type text into editable element
-playwright-cli fill <ref> <text>        # fill text into editable element
-playwright-cli select <ref> <value>     # select an option in a dropdown
-playwright-cli check <ref>              # check a checkbox or radio button
-playwright-cli uncheck <ref>            # uncheck a checkbox
-playwright-cli hover <ref>              # hover over element
-playwright-cli drag <startRef> <endRef> # drag and drop between elements
-playwright-cli upload <files...>        # upload one or multiple files
-playwright-cli close                    # close the page
-```
-
-### Targeting elements
-
-Use element refs from snapshots to target elements:
-
-```bash
-playwright-cli snapshot                 # get snapshot with element refs
-playwright-cli click e15                # click using a ref
-```
-
-You can also use CSS or role selectors:
-
-```bash
-playwright-cli click "#main > button.submit"
-playwright-cli click "role=button[name=Submit]"
-playwright-cli click "#footer >> role=button[name=Submit]"
-```
-
-### Screenshots and snapshots
-
-```bash
-playwright-cli snapshot                 # capture page snapshot
-playwright-cli snapshot --filename=f    # save snapshot to specific file
-playwright-cli screenshot               # screenshot of the current page
-playwright-cli screenshot [ref]         # screenshot of a specific element
-playwright-cli screenshot --filename=f  # save with specific filename
-playwright-cli screenshot --hires       # capture using device pixels
-playwright-cli pdf                      # save page as PDF
-```
-
-### Navigation
-
-```bash
-playwright-cli go-back                  # go back
-playwright-cli go-forward               # go forward
-playwright-cli reload                   # reload the page
-```
-
-### Keyboard and mouse
-
-```bash
-playwright-cli press <key>              # press a key (e.g. Enter, ArrowLeft)
-playwright-cli keydown <key>            # key down
-playwright-cli keyup <key>              # key up
-playwright-cli mousemove <x> <y>        # move mouse
-playwright-cli mousedown [button]       # mouse button down
-playwright-cli mouseup [button]         # mouse button up
-playwright-cli mousewheel <dx> <dy>     # scroll
-```
-
-### Tabs
-
-```bash
-playwright-cli tab-list                 # list all tabs
-playwright-cli tab-new [url]            # create a new tab
-playwright-cli tab-select <index>       # select a tab
-playwright-cli tab-close [index]        # close a tab
-```
-
-### Network
-
-```bash
-playwright-cli requests                 # list network requests since page load
-playwright-cli request <num>            # show full details of a single request
-playwright-cli route <pattern> [opts]   # mock network requests
-playwright-cli route-list               # list active routes
-playwright-cli unroute [pattern]        # remove routes
-```
-
-### Storage
-
-```bash
-playwright-cli state-save [filename]    # save storage state (cookies, localStorage)
-playwright-cli state-load <filename>    # load storage state
-
-# Cookies
-playwright-cli cookie-list [--domain]   # list cookies
-playwright-cli cookie-get <name>        # get a cookie
-playwright-cli cookie-set <name> <val>  # set a cookie
-playwright-cli cookie-delete <name>     # delete a cookie
-playwright-cli cookie-clear             # clear all cookies
-
-# localStorage
-playwright-cli localstorage-list        # list entries
-playwright-cli localstorage-get <key>   # get value
-playwright-cli localstorage-set <k> <v> # set value
-playwright-cli localstorage-delete <k>  # delete entry
-playwright-cli localstorage-clear       # clear all
-```
-
-### DevTools
-
-```bash
-playwright-cli console [min-level]      # list console messages
-playwright-cli eval <func> [ref]        # evaluate JavaScript on page
-playwright-cli run-code <code>          # run Playwright code snippet
-playwright-cli tracing-start            # start trace recording
-playwright-cli tracing-stop             # stop trace recording
-playwright-cli video-start              # start video recording
-playwright-cli video-chapter <title>    # add chapter marker to video
-playwright-cli video-stop --filename=f  # stop video recording
-```
-
-### WebMCP
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools a page registers are listed at the top of the page snapshot, and they can be called directly:
-
-```bash
-playwright-cli webmcp-list                       # list tools registered by the page
-playwright-cli webmcp-call <name> [--params]     # call one, passing a JSON object
-```
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Sessions
-
-The CLI keeps the browser profile in memory by default — cookies and storage state are preserved between calls within a session but lost when the browser closes. Use `--persistent` to save the profile to disk.
-
-### Named sessions
-
-Run multiple browser instances for different projects:
-
-```bash
-playwright-cli open https://playwright.dev
-playwright-cli -s=example open https://example.com --persistent
-playwright-cli list                     # list all sessions
-```
-
-You can configure your coding agent to use a specific session:
-
-```bash
-PLAYWRIGHT_CLI_SESSION=todo-app claude .
-```
-
-### Session management
-
-```bash
-playwright-cli list                     # list all sessions
-playwright-cli close-all                # close all browsers
-playwright-cli kill-all                 # forcefully kill all browser processes
-playwright-cli -s=name delete-data      # delete user data for a named session
-```
-
-A headless session shuts itself down after an hour without commands, so a session an agent forgot to close does not keep a browser running. Headed and attached browsers are never closed automatically. Change the timeout with `open --idle-timeout=<ms>` or `timeouts.idle` in the config file, and pass `0` to disable it.
-
-## Monitoring
-
-Use `playwright-cli show` to open a visual dashboard for observing and controlling all running browser sessions:
-
-```bash
-playwright-cli show
-```
-
-The dashboard provides:
-- **Session grid** — all active sessions grouped by workspace, each with a live screencast preview, session name, current URL, and page title. Click any session to zoom in.
-- **Session detail** — a live view of the selected session with tab bar, navigation controls, and full remote control. Click into the viewport to take over mouse and keyboard; press Escape to release.
-
-## Configuration
-
-### Headed mode
-
-The CLI runs headless by default. To see the browser:
-
-```bash
-playwright-cli open https://playwright.dev --headed
-```
-
-### Browser selection
-
-```bash
-playwright-cli open --browser=chrome    # use specific browser
-playwright-cli open --browser=firefox
-playwright-cli open --browser=webkit
-playwright-cli open --browser=msedge
-```
-
-### Configuration file
-
-For advanced settings, use a JSON config file:
-
-```bash
-playwright-cli --config path/to/config.json open example.com
-```
-
-The CLI also loads `.playwright/cli.config.json` automatically if present. The config file supports browser options, context options, network rules, timeouts, and more. Run `playwright-cli --help` for the full list of options.
-
-### Browser extension
-
-Connect to your existing browser tabs instead of launching a new browser:
-
-```bash
-playwright-cli attach --extension
-```
-
-This requires the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md) to be installed.
-
-## Quick Reference
-
-| Action                    | Command                                             |
-| ------------------------- | --------------------------------------------------- |
-| **Install CLI**           | `npm install -g @playwright/cli@latest`             |
-| **Install skills**        | `playwright-cli install --skills`                   |
-| **Open a page**           | `playwright-cli open https://example.com`           |
-| **Click an element**      | `playwright-cli click e15`                          |
-| **Type text**             | `playwright-cli type "hello world"`                 |
-| **Take a screenshot**     | `playwright-cli screenshot`                         |
-| **Get page snapshot**     | `playwright-cli snapshot`                           |
-| **Run headed**            | `playwright-cli open https://example.com --headed`  |
-| **Use Firefox**           | `playwright-cli open --browser=firefox`             |
-| **Monitor sessions**      | `playwright-cli show`                               |
-| **List page WebMCP tools** | `playwright-cli webmcp-list`                       |
-
-## What's Next
-- [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
-- [Run your tests on CI](./ci-intro.mdx)
-- [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
-[Request]: /api/class-request.mdx "Request"
-[RequestOptions]: /api/class-requestoptions.mdx "RequestOptions"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[BiConsumer]: https://docs.oracle.com/javase/8/docs/api/java/util/function/BiConsumer.html "BiConsumer"
-[boolean]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "boolean"
-[byte&#91;&#93;]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "byte[]"
-[Consumer]: https://docs.oracle.com/javase/8/docs/api/java/util/function/Consumer.html "Consumer"
-[Date]: https://docs.oracle.com/javase/8/docs/api/java/util/Date.html "Date"
-[double]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "double"
-[InputStream]: https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html "InputStream"
-[int]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "int"
-[Integer]: https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html "Integer"
-[long]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "long"
-[JsonObject]: https://www.javadoc.io/doc/com.google.code.gson/gson/latest/com.google.gson/com/google/gson/JsonObject.html "JsonObject"
-[List]: https://docs.oracle.com/javase/8/docs/api/java/util/List.html "List"
-[Map]: https://docs.oracle.com/javase/8/docs/api/java/util/Map.html "Map"
-[null]: https://docs.oracle.com/javase/specs/jls/se8/html/jls-3.html#jls-3.10.7 "null"
-[Object]: https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html "Object"
-[Path]: https://docs.oracle.com/javase/8/docs/api/java/nio/file/Path.html "Path"
-[Pattern]: https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html "Pattern"
-[Predicate]: https://docs.oracle.com/javase/8/docs/api/java/util/function/Predicate.html "Predicate"
-[void]: https://docs.oracle.com/javase/tutorial/java/javaOO/methods.html "void"
-[Runnable]: https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html "Runnable"
-[RuntimeException]: https://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html "RuntimeException"
-[String]: https://docs.oracle.com/javase/8/docs/api/java/lang/String.html "String"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/java/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/java/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-java/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/java/docs/getting-started-mcp.mdx b/java/docs/getting-started-mcp.mdx
deleted file mode 100644
index 987d1212a1..0000000000
--- a/java/docs/getting-started-mcp.mdx
+++ /dev/null
@@ -1,342 +0,0 @@
----
-id: getting-started-mcp
-title: "Playwright MCP"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-The Playwright MCP server provides browser automation capabilities through the [Model Context Protocol](https://modelcontextprotocol.io), enabling LLMs to interact with web pages using structured accessibility snapshots. It works with VS Code, Cursor, Windsurf, Claude Desktop, and any other MCP client — no vision models required.
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- An MCP client: VS Code, Cursor, Windsurf, Claude Code, Claude Desktop, or similar
-
-## Getting Started
-
-### Installation
-
-Add the Playwright MCP server to your client using the standard configuration:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
-```
-
-#### VS Code
-
-Click one of the buttons below to install directly:
-
-[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D)
-
-Or install via the VS Code CLI:
-
-```bash
-code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
-```
-
-#### Cursor
-
-[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=Playwright&config=eyJjb21tYW5kIjoibnB4IEBwbGF5d3JpZ2h0L21jcEBsYXRlc3QifQ%3D%3D)
-
-Or go to `Cursor Settings` → `MCP` → `Add new MCP Server` and use command type with `npx @playwright/mcp@latest`.
-
-#### Claude Code
-
-```bash
-claude mcp add playwright npx @playwright/mcp@latest
-```
-
-#### Claude Desktop
-
-Follow the MCP install [guide](https://modelcontextprotocol.io/quickstart/user) and use the standard config above.
-
-#### Other clients
-
-The standard configuration works with most MCP clients, including Windsurf, Cline, Goose, Kiro, Codex, Copilot CLI, and others. Consult your client's MCP documentation for where to place the config.
-
-### First interaction
-
-Once the server is connected, ask your AI assistant to interact with a web page:
-
-```txt
-Navigate to https://demo.playwright.dev/todomvc and add a few todo items.
-```
-
-The assistant will use Playwright MCP tools to open the browser, navigate to the page, and interact with elements — all through structured accessibility snapshots rather than screenshots.
-
-## Core Features
-
-### Accessibility snapshots
-
-Playwright MCP operates on the page's accessibility tree, not pixels. When a tool runs, it returns a structured snapshot showing the page elements, their roles, and text content. The LLM uses element references from these snapshots to interact with the page:
-
-```txt
-- heading "todos" [level=1]
-- textbox "What needs to be done?" [ref=e5]
-- listitem:
-  - checkbox "Toggle Todo" [ref=e10]
-  - text: "Buy groceries"
-```
-
-The LLM reads this snapshot and uses `ref=e5` to type into the textbox or `ref=e10` to check the checkbox.
-
-### Interacting with pages
-
-Playwright MCP provides tools for all common browser interactions:
--   **Navigation**: Open URLs, go back/forward, reload pages.
--   **Clicking and typing**: Click elements, type text, fill forms, select dropdowns.
--   **Screenshots**: Capture the current page or specific elements for visual verification.
--   **Keyboard and mouse**: Press keys, hover, drag and drop.
--   **Dialogs**: Accept or dismiss browser dialogs.
--   **Tabs**: Create, close, and switch between browser tabs.
-
-### Running Playwright code
-
-For complex interactions that go beyond individual tool calls, use the `browser_run_code_unsafe` tool to execute Playwright scripts directly. This tool runs arbitrary JavaScript in the Playwright server process and is RCE-equivalent — only enable it for trusted MCP clients:
-
-```txt
-Run this Playwright code to verify the todo count:
-async (page) => {
-  const count = await page.getByTestId('todo-count').textContent();
-  return count;
-}
-```
-
-### Network monitoring and mocking
-
-Inspect network traffic and mock API responses:
--   **View network requests**: List all requests made since page load.
--   **Mock routes**: Set up URL pattern matching to return custom responses.
--   **Console messages**: Access browser console output for debugging.
-
-### Storage state
-
-Save and restore browser state including cookies and localStorage:
--   **Save state**: Persist authentication and session data to a file.
--   **Restore state**: Load previously saved state into a new session.
--   **Cookie management**: List, get, set, and delete individual cookies.
-
-### WebMCP tools
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools of the current tab are offered as MCP tools named `webmcp_<tool>`.
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Configuration
-
-### Headed mode
-
-By default, Playwright MCP runs the browser in headed mode so you can see what's happening. To run headless:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headless"
-      ]
-    }
-  }
-}
-```
-
-### Browser selection
-
-Choose which browser to use:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--browser=firefox"
-      ]
-    }
-  }
-}
-```
-
-Supported values: `chrome`, `firefox`, `webkit`, `msedge`.
-
-### User profile
-
-Playwright MCP supports three profile modes:
--   **Persistent (default)**: Login state and cookies are preserved between sessions. The profile is stored in `ms-playwright/mcp-{channel}-{workspace-hash}` in your platform's cache directory, so different projects get separate profiles automatically. Override with `--user-data-dir`.
--   **Isolated**: Each session starts fresh. Pass `--isolated` to enable. You can load initial state with `--storage-state`.
--   **Browser extension**: Connect to your existing browser tabs with the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md). Pass `--extension` to enable.
-
-### Idle timeout
-
-A page that keeps animating or rendering costs CPU for as long as the browser is open, and an agent session can last hours. A headless browser launched by the server is therefore closed after an hour without tool calls. Headed browsers, and browsers attached over `--cdp-endpoint` or `--extension`, are never closed automatically. Pass `--idle-timeout` to set the timeout in milliseconds for any mode, or `0` to disable it:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--idle-timeout=300000"
-      ]
-    }
-  }
-}
-```
-
-When no tool call has completed for that long, the browser is closed, headed or not, the same way as if you had closed it by hand. The next tool call launches a new browser, so the agent navigates again. The timer never fires while a tool call is running.
--   With `--isolated`, cookies and storage kept in memory are lost on an idle close. Use the persistent profile or `--storage-state` to keep them. Each client has its own timer: the context of an idle client is closed while other clients keep working, and the browser is closed once no client has a context.
--   With `--cdp-endpoint` or `--extension`, the browser is not owned by the server, so there is no default timeout, and an explicit one only disconnects from it, leaving its pages open. With `--extension`, the next tool call goes through the connect flow again.
--   With `--shared-browser-context`, the timer spans all clients: a client that is idle while others keep working keeps its tabs and state, and the shared browser is closed only once every client has been idle for the timeout.
-
-### Configuration file
-
-For advanced configuration, use a JSON config file:
-
-```bash
-npx @playwright/mcp@latest --config path/to/config.json
-```
-
-The config file supports browser options, context options, network rules, timeouts, and more. See the [Playwright MCP repository](https://github.com/microsoft/playwright-mcp/blob/main/config.d.ts) for the full schema.
-
-### Standalone server
-
-When running a headed browser on a system without a display or from IDE worker processes, start the MCP server separately with HTTP transport:
-
-```bash
-npx @playwright/mcp@latest --port 8931
-```
-
-HTTP sessions use a five-second heartbeat timeout. If your MCP client or proxy does not answer server-initiated pings, set `PLAYWRIGHT_MCP_PING_TIMEOUT_MS` to a longer timeout in milliseconds. Set it to `0` to disable the heartbeat.
-
-Then point your MCP client to the HTTP endpoint:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "url": "http://localhost:8931/mcp"
-    }
-  }
-}
-```
-
-## Quick Reference
-
-| Action                    | How to do it                                                  |
-| ------------------------- | ------------------------------------------------------------- |
-| **Install server**        | Add standard config to your MCP client                        |
-| **Navigate to a page**    | Ask: "Go to https://example.com"                              |
-| **Click an element**      | Ask: "Click the Submit button"                                |
-| **Fill a form**           | Ask: "Fill in the email field with test@example.com"          |
-| **Take a screenshot**     | Ask: "Take a screenshot of the page"                          |
-| **Run Playwright code**   | Ask: "Run this Playwright code: ..."                          |
-| **Mock an API**           | Ask: "Mock the /api/users endpoint to return ..."             |
-| **Use headed mode**       | Default. Pass `--headless` to disable                         |
-| **Choose a browser**      | Pass `--browser=firefox` in args                              |
-
-## What's Next
--   [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
--   [Run your tests on CI](./ci-intro.mdx)
--   [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[PlaywrightException]: /api/class-playwrightexception.mdx "PlaywrightException"
-[Request]: /api/class-request.mdx "Request"
-[RequestOptions]: /api/class-requestoptions.mdx "RequestOptions"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketFrame]: /api/class-websocketframe.mdx "WebSocketFrame"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[BiConsumer]: https://docs.oracle.com/javase/8/docs/api/java/util/function/BiConsumer.html "BiConsumer"
-[boolean]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "boolean"
-[byte&#91;&#93;]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "byte[]"
-[Consumer]: https://docs.oracle.com/javase/8/docs/api/java/util/function/Consumer.html "Consumer"
-[Date]: https://docs.oracle.com/javase/8/docs/api/java/util/Date.html "Date"
-[double]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "double"
-[InputStream]: https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html "InputStream"
-[int]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "int"
-[Integer]: https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html "Integer"
-[long]: https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html "long"
-[JsonObject]: https://www.javadoc.io/doc/com.google.code.gson/gson/latest/com.google.gson/com/google/gson/JsonObject.html "JsonObject"
-[List]: https://docs.oracle.com/javase/8/docs/api/java/util/List.html "List"
-[Map]: https://docs.oracle.com/javase/8/docs/api/java/util/Map.html "Map"
-[null]: https://docs.oracle.com/javase/specs/jls/se8/html/jls-3.html#jls-3.10.7 "null"
-[Object]: https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html "Object"
-[Path]: https://docs.oracle.com/javase/8/docs/api/java/nio/file/Path.html "Path"
-[Pattern]: https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html "Pattern"
-[Predicate]: https://docs.oracle.com/javase/8/docs/api/java/util/function/Predicate.html "Predicate"
-[void]: https://docs.oracle.com/javase/tutorial/java/javaOO/methods.html "void"
-[Runnable]: https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html "Runnable"
-[RuntimeException]: https://docs.oracle.com/javase/8/docs/api/java/lang/RuntimeException.html "RuntimeException"
-[String]: https://docs.oracle.com/javase/8/docs/api/java/lang/String.html "String"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/java/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/java/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-java/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/java/docs/release-notes.mdx b/java/docs/release-notes.mdx
index 1aac53225f..a3626d8777 100644
--- a/java/docs/release-notes.mdx
+++ b/java/docs/release-notes.mdx
@@ -31,7 +31,7 @@ System.out.println(normalized.toString());
 - Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed `<details>`, is no longer part of accessible names and aria snapshots. This can change the results of [Page.getByRole()](/api/class-page.mdx#page-get-by-role) with a name, [Locator.ariaSnapshot()](/api/class-locator.mdx#locator-aria-snapshot) and [assertThat(locator).matchesAriaSnapshot()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
 
 ### Browser Versions
-- Chromium 158.0.8127.2
+- Chromium 158.0.8127.18
 - Mozilla Firefox 159.0
 - WebKit 27.2
 
@@ -58,9 +58,9 @@ Object result = page.webmcp().callTool("add", Map.of("a", 2, "b", 40));
 System.out.println(result); // {content=[{type=text, text=42}]}
 ```
 
-[Playwright MCP](./getting-started-mcp.mdx) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+[Playwright MCP](https://playwright.dev/mcp/introduction) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
 
-[`playwright-cli`](./getting-started-cli.mdx) exposes them as well:
+[`playwright-cli`](https://playwright.dev/agent-cli/introduction) exposes them as well:
 
 ```bash
 playwright-cli webmcp-list
@@ -87,7 +87,7 @@ page.screencast().showActions(new Screencast.ShowActionsOptions()
 - New [setStyle](/api/class-screencast.mdx#screencast-show-actions-option-style) option takes CSS declarations for the `point` marker, the target `highlight` and the action `title`. It replaces the `fontSize` option, which is now deprecated.
 - The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
 - Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better quality.
-- All video options are also available in [Playwright MCP](./getting-started-mcp.mdx) and [`playwright-cli`](./getting-started-cli.mdx).
+- All video options are also available in [Playwright MCP](https://playwright.dev/mcp/introduction) and [`playwright-cli`](https://playwright.dev/agent-cli/introduction).
 
 ### 🪆 Locator.within()
 
diff --git a/nodejs/docs/api/class-androiddevice.mdx b/nodejs/docs/api/class-androiddevice.mdx
index 609c8ede4a..393021aafa 100644
--- a/nodejs/docs/api/class-androiddevice.mdx
+++ b/nodejs/docs/api/class-androiddevice.mdx
@@ -273,6 +273,9 @@ await androidDevice.launchBrowser(options);
   - `locale` [string] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="android-device-launch-browser-option-locale"/><a href="#android-device-launch-browser-option-locale" class="list-anchor">#</a>
     
     Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `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 [emulation guide](../emulation.mdx#locale--timezone).
+  - `locateOnlyVisible` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="android-device-launch-browser-option-locate-only-visible"/><a href="#android-device-launch-browser-option-locate-only-visible" class="list-anchor">#</a>
+    
+    Whether to restrict all locators in this context to [visible](../actionability.mdx#visible) elements. Defaults to `false`. When enabled, actions, assertions and queries behave as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended to the end of the locator chain, unless its last part is an explicit visibility filter. For example, `.filter({ visible: false })` at the end of a locator selects hidden elements even when this option is enabled. Intermediate locators and inner locators used in [locator.filter()](/api/class-locator.mdx#locator-filter) are not automatically filtered. This does not change the accessibility rules of [page.getByRole()](/api/class-page.mdx#page-get-by-role) or the behavior of selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
   - `logger` [Logger] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="android-device-launch-browser-option-logger"/><a href="#android-device-launch-browser-option-logger" class="list-anchor">#</a>
     
     :::warning[Deprecated]
diff --git a/nodejs/docs/api/class-apirequestcontext.mdx b/nodejs/docs/api/class-apirequestcontext.mdx
index 50d7f0fb68..2f5308c4b6 100644
--- a/nodejs/docs/api/class-apirequestcontext.mdx
+++ b/nodejs/docs/api/class-apirequestcontext.mdx
@@ -179,7 +179,11 @@ await apiRequestContext.delete(url, options);
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)* <font size="2">Added in: v1.17</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-delete-option-data"/><a href="#api-request-context-delete-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-delete-option-fail-on-status-code"/><a href="#api-request-context-delete-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -290,7 +294,11 @@ await request.fetch('https://example.com/api/uploadForm', {
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-fetch-option-data"/><a href="#api-request-context-fetch-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-fetch-option-fail-on-status-code"/><a href="#api-request-context-fetch-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -377,7 +385,11 @@ await request.get('https://example.com/api/getText', { params: queryString });
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)* <font size="2">Added in: v1.26</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-get-option-data"/><a href="#api-request-context-get-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-get-option-fail-on-status-code"/><a href="#api-request-context-get-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -443,7 +455,11 @@ await apiRequestContext.head(url, options);
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)* <font size="2">Added in: v1.26</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-head-option-data"/><a href="#api-request-context-head-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-head-option-fail-on-status-code"/><a href="#api-request-context-head-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -509,7 +525,11 @@ await apiRequestContext.patch(url, options);
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-patch-option-data"/><a href="#api-request-context-patch-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-patch-option-fail-on-status-code"/><a href="#api-request-context-patch-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -606,7 +626,11 @@ await request.post('https://example.com/api/uploadForm', {
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-post-option-data"/><a href="#api-request-context-post-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-post-option-fail-on-status-code"/><a href="#api-request-context-post-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
@@ -672,7 +696,11 @@ await apiRequestContext.put(url, options);
 - `options` [Object] *(optional)*
   - `data` [string] | [Buffer] | [Serializable] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-put-option-data"/><a href="#api-request-context-put-option-data" class="list-anchor">#</a>
     
-    Allows to set post data of the request. If the data parameter is an object, it will be serialized to json string and `content-type` header will be set to `application/json` if not explicitly set. Otherwise the `content-type` header will be set to `application/octet-stream` if not explicitly set.
+    Allows to set post data of the request. If the data parameter is an object other than a [Buffer], it will be serialized to JSON and the `content-type` header will be set to `application/json` if not explicitly set.
+    
+    If the data parameter is a string and the explicitly set `content-type` is `application/json` (case-insensitive, with optional parameters such as `charset=utf-8`), the string is sent as is if it parses as JSON. Otherwise, it is JSON-encoded as a string, including quotes and escaping. Strings with other content types are sent as is.
+    
+    Pass a [Buffer], such as `Buffer.from(body, 'utf8')`, to send exact bytes without JSON encoding, for example to send deliberately malformed JSON or a body used to compute a signature. For strings and buffers, the `content-type` header defaults to `application/octet-stream` if not explicitly set.
   - `failOnStatusCode` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="api-request-context-put-option-fail-on-status-code"/><a href="#api-request-context-put-option-fail-on-status-code" class="list-anchor">#</a>
     
     Whether to throw on response codes other than 2xx and 3xx. By default response object is returned for all status codes.
diff --git a/nodejs/docs/api/class-browser.mdx b/nodejs/docs/api/class-browser.mdx
index c939abe5c3..e7a4074c2c 100644
--- a/nodejs/docs/api/class-browser.mdx
+++ b/nodejs/docs/api/class-browser.mdx
@@ -311,6 +311,9 @@ If directly using this method to create [BrowserContext]s, it is best practice t
   - `locale` [string] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-context-option-locale"/><a href="#browser-new-context-option-locale" class="list-anchor">#</a>
     
     Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `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 [emulation guide](../emulation.mdx#locale--timezone).
+  - `locateOnlyVisible` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-context-option-locate-only-visible"/><a href="#browser-new-context-option-locate-only-visible" class="list-anchor">#</a>
+    
+    Whether to restrict all locators in this context to [visible](../actionability.mdx#visible) elements. Defaults to `false`. When enabled, actions, assertions and queries behave as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended to the end of the locator chain, unless its last part is an explicit visibility filter. For example, `.filter({ visible: false })` at the end of a locator selects hidden elements even when this option is enabled. Intermediate locators and inner locators used in [locator.filter()](/api/class-locator.mdx#locator-filter) are not automatically filtered. This does not change the accessibility rules of [page.getByRole()](/api/class-page.mdx#page-get-by-role) or the behavior of selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
   - `logger` [Logger] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-context-option-logger"/><a href="#browser-new-context-option-logger" class="list-anchor">#</a>
     
     :::warning[Deprecated]
@@ -619,6 +622,9 @@ await browser.newPage(options);
   - `locale` [string] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-page-option-locale"/><a href="#browser-new-page-option-locale" class="list-anchor">#</a>
     
     Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `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 [emulation guide](../emulation.mdx#locale--timezone).
+  - `locateOnlyVisible` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-page-option-locate-only-visible"/><a href="#browser-new-page-option-locate-only-visible" class="list-anchor">#</a>
+    
+    Whether to restrict all locators in this context to [visible](../actionability.mdx#visible) elements. Defaults to `false`. When enabled, actions, assertions and queries behave as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended to the end of the locator chain, unless its last part is an explicit visibility filter. For example, `.filter({ visible: false })` at the end of a locator selects hidden elements even when this option is enabled. Intermediate locators and inner locators used in [locator.filter()](/api/class-locator.mdx#locator-filter) are not automatically filtered. This does not change the accessibility rules of [page.getByRole()](/api/class-page.mdx#page-get-by-role) or the behavior of selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
   - `logger` [Logger] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-new-page-option-logger"/><a href="#browser-new-page-option-logger" class="list-anchor">#</a>
     
     :::warning[Deprecated]
diff --git a/nodejs/docs/api/class-browsertype.mdx b/nodejs/docs/api/class-browsertype.mdx
index 8f6a64c168..2cede2c54d 100644
--- a/nodejs/docs/api/class-browsertype.mdx
+++ b/nodejs/docs/api/class-browsertype.mdx
@@ -456,6 +456,9 @@ await browserType.launchPersistentContext(userDataDir, options);
   - `locale` [string] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-launch-persistent-context-option-locale"/><a href="#browser-type-launch-persistent-context-option-locale" class="list-anchor">#</a>
     
     Specify user locale, for example `en-GB`, `de-DE`, etc. Locale will affect `navigator.language` value, `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 [emulation guide](../emulation.mdx#locale--timezone).
+  - `locateOnlyVisible` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-launch-persistent-context-option-locate-only-visible"/><a href="#browser-type-launch-persistent-context-option-locate-only-visible" class="list-anchor">#</a>
+    
+    Whether to restrict all locators in this context to [visible](../actionability.mdx#visible) elements. Defaults to `false`. When enabled, actions, assertions and queries behave as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended to the end of the locator chain, unless its last part is an explicit visibility filter. For example, `.filter({ visible: false })` at the end of a locator selects hidden elements even when this option is enabled. Intermediate locators and inner locators used in [locator.filter()](/api/class-locator.mdx#locator-filter) are not automatically filtered. This does not change the accessibility rules of [page.getByRole()](/api/class-page.mdx#page-get-by-role) or the behavior of selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
   - `logger` [Logger] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-launch-persistent-context-option-logger"/><a href="#browser-type-launch-persistent-context-option-logger" class="list-anchor">#</a>
     
     :::warning[Deprecated]
diff --git a/nodejs/docs/api/class-frame.mdx b/nodejs/docs/api/class-frame.mdx
index cc4be9c24e..d41ef7518d 100644
--- a/nodejs/docs/api/class-frame.mdx
+++ b/nodejs/docs/api/class-frame.mdx
@@ -413,6 +413,8 @@ await page.getByAltText('Playwright logo').click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/nodejs/docs/api/class-framelocator.mdx b/nodejs/docs/api/class-framelocator.mdx
index c42f2d175b..5366015f0c 100644
--- a/nodejs/docs/api/class-framelocator.mdx
+++ b/nodejs/docs/api/class-framelocator.mdx
@@ -115,6 +115,8 @@ await page.getByAltText('Playwright logo').click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/nodejs/docs/api/class-fullconfig.mdx b/nodejs/docs/api/class-fullconfig.mdx
index 97fdf9bb56..48c7992d75 100644
--- a/nodejs/docs/api/class-fullconfig.mdx
+++ b/nodejs/docs/api/class-fullconfig.mdx
@@ -444,7 +444,7 @@ fullConfig.version
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.10</font><x-search>fullConfig.webServer</x-search>
 
-See [testConfig.webServer](/api/class-testconfig.mdx#test-config-web-server).
+See [testConfig.webServer](/api/class-testconfig.mdx#test-config-web-server). This property is `null` in merged reports because server configuration is not serialized.
 
 **Usage**
 
diff --git a/nodejs/docs/api/class-fullproject.mdx b/nodejs/docs/api/class-fullproject.mdx
index 1c5641c7f2..ccfa4f19b9 100644
--- a/nodejs/docs/api/class-fullproject.mdx
+++ b/nodejs/docs/api/class-fullproject.mdx
@@ -154,7 +154,7 @@ fullProject.repeatEach
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.10</font><x-search>fullProject.retries</x-search>
 
-See [testProject.retries](/api/class-testproject.mdx#test-project-retries).
+See [testProject.retries](/api/class-testproject.mdx#test-project-retries). When retries are configured as a list, this is the largest `count` in the list.
 
 **Usage**
 
@@ -284,6 +284,23 @@ fullProject.use
 **Type**
 - [Fixtures]
 
+---
+
+### webServer {/* #full-project-web-server */}
+
+<font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.66</font><x-search>fullProject.webServer</x-search>
+
+The servers configured in [testProject.webServer](/api/class-testproject.mdx#test-project-web-server), normalized to an array. Does not include top-level servers. This property is an empty array in merged reports because server configuration is not serialized.
+
+**Usage**
+
+```js
+fullProject.webServer
+```
+
+**Type**
+- [Array]&lt;[Object]&gt;
+
 
 [APIRequest]: /api/class-apirequest.mdx "APIRequest"
 [APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
diff --git a/nodejs/docs/api/class-locator.mdx b/nodejs/docs/api/class-locator.mdx
index 5ead31e794..b42d715cb2 100644
--- a/nodejs/docs/api/class-locator.mdx
+++ b/nodejs/docs/api/class-locator.mdx
@@ -1234,6 +1234,8 @@ await page.getByAltText('Playwright logo').click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/nodejs/docs/api/class-page.mdx b/nodejs/docs/api/class-page.mdx
index 4b4b2d62cd..fa23df668b 100644
--- a/nodejs/docs/api/class-page.mdx
+++ b/nodejs/docs/api/class-page.mdx
@@ -968,6 +968,8 @@ await page.getByAltText('Playwright logo').click();
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/nodejs/docs/api/class-test.mdx b/nodejs/docs/api/class-test.mdx
index c0ef8362a2..2fc689e108 100644
--- a/nodejs/docs/api/class-test.mdx
+++ b/nodejs/docs/api/class-test.mdx
@@ -600,9 +600,15 @@ Learn more about the execution modes [here](../test-parallel.mdx).
   - `mode` "default" | "parallel" | "serial" *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-describe-configure-option-mode"/><a href="#test-describe-configure-option-mode" class="list-anchor">#</a>
     
     Execution mode. Learn more about the execution modes [here](../test-parallel.mdx).
-  - `retries` [number] *(optional)* <font size="2">Added in: v1.28</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-describe-configure-option-retries"/><a href="#test-describe-configure-option-retries" class="list-anchor">#</a>
+  - `retries` [number] | [Array]&lt;[Object]&gt; *(optional)* <font size="2">Added in: v1.28</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-describe-configure-option-retries"/><a href="#test-describe-configure-option-retries" class="list-anchor">#</a>
+    - `count` [number]
+      
+      The maximum number of retries given to a failed test when this entry applies.
+    - `condition` [RegExp] *(optional)*
+      
+      Regular expression matched against the error messages of the failed attempt. An entry without a condition always applies.
     
-    The number of retries for each test.
+    The number of retries for each test. Set to a list to make the number of retries depend on the error, see [testConfig.retries](/api/class-testconfig.mdx#test-config-retries).
   - `timeout` [number] *(optional)* <font size="2">Added in: v1.28</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="test-describe-configure-option-timeout"/><a href="#test-describe-configure-option-timeout" class="list-anchor">#</a>
     
     Timeout for each test in milliseconds. Overrides [testProject.timeout](/api/class-testproject.mdx#test-project-timeout) and [testConfig.timeout](/api/class-testconfig.mdx#test-config-timeout).
diff --git a/nodejs/docs/api/class-testcase.mdx b/nodejs/docs/api/class-testcase.mdx
index cf65d7ad36..3bbd70b280 100644
--- a/nodejs/docs/api/class-testcase.mdx
+++ b/nodejs/docs/api/class-testcase.mdx
@@ -206,7 +206,7 @@ testCase.results
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.10</font><x-search>testCase.retries</x-search>
 
-The maximum number of retries given to this test in the configuration.
+The maximum number of retries given to this test in the configuration. With conditional retries, this is updated after each failed attempt to the number of retries that applies to that failure.
 
 Learn more about [test retries](../test-retries.mdx#retries).
 
diff --git a/nodejs/docs/api/class-testconfig.mdx b/nodejs/docs/api/class-testconfig.mdx
index 06215ad7f1..08d69ba826 100644
--- a/nodejs/docs/api/class-testconfig.mdx
+++ b/nodejs/docs/api/class-testconfig.mdx
@@ -662,6 +662,8 @@ testConfig.respectGitIgnore
 
 The maximum number of retry attempts given to failed tests. By default failing tests are not retried. Learn more about [test retries](../test-retries.mdx#retries).
 
+When set to a list, the number of retries depends on the error. After each failed attempt, Playwright takes the largest `count` among the entries that apply, and retries the test when it has run fewer times than that. The latest failed attempt decides: a test that first fails with a matching error and then with a different one only gets the retries of the latter. Worker crashes and timeouts are matched by their error message like any other failure.
+
 **Usage**
 
 ```js title="playwright.config.ts"
@@ -672,8 +674,27 @@ export default defineConfig({
 });
 ```
 
+Retry any failure once, and up to three times when the browser or the worker crashed:
+
+```js title="playwright.config.ts"
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  retries: [
+    { count: 1 },
+    { count: 3, condition: /Target crashed|worker process exited unexpectedly/ },
+  ],
+});
+```
+
 **Type**
-- [number]
+- [number] | [Array]&lt;[Object]&gt;
+  - `count` [number]
+    
+    The maximum number of retries given to a failed test when this entry applies.
+  - `condition` [RegExp] *(optional)*
+    
+    Regular expression matched against the error messages of the failed attempt. An entry without a condition always applies.
 
 ---
 
@@ -1050,6 +1071,8 @@ export default defineConfig({
 
 Launch a development web server (or multiple) during the tests.
 
+Top-level servers start before `globalSetup` and stop after `globalTeardown`, regardless of project selection. To start servers only for particular projects, use [testProject.webServer](/api/class-testproject.mdx#test-project-web-server).
+
 **Usage**
 
 ```js title="playwright.config.ts"
diff --git a/nodejs/docs/api/class-testinfo.mdx b/nodejs/docs/api/class-testinfo.mdx
index 8baec33e45..bc9399053f 100644
--- a/nodejs/docs/api/class-testinfo.mdx
+++ b/nodejs/docs/api/class-testinfo.mdx
@@ -14,7 +14,7 @@ import { test, expect } from '@playwright/test';
 
 test('basic test', async ({ page }, testInfo) => {
   expect(testInfo.title).toBe('basic test');
-  await page.screenshot(testInfo.outputPath('screenshot.png'));
+  await page.screenshot({ path: testInfo.outputPath('screenshot.png') });
 });
 ```
 
diff --git a/nodejs/docs/api/class-testoptions.mdx b/nodejs/docs/api/class-testoptions.mdx
index 478dbc4e27..c13710e49e 100644
--- a/nodejs/docs/api/class-testoptions.mdx
+++ b/nodejs/docs/api/class-testoptions.mdx
@@ -698,6 +698,29 @@ export default defineConfig({
 
 ---
 
+### locateOnlyVisible {/* #test-options-locate-only-visible */}
+
+<font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.66</font><x-search>testOptions.locateOnlyVisible</x-search>
+
+Whether to restrict all locators in this context to [visible](../actionability.mdx#visible) elements. Defaults to `false`. When enabled, actions, assertions and queries behave as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended to the end of the locator chain, unless its last part is an explicit visibility filter. For example, `.filter({ visible: false })` at the end of a locator selects hidden elements even when this option is enabled. Intermediate locators and inner locators used in [locator.filter()](/api/class-locator.mdx#locator-filter) are not automatically filtered. This does not change the accessibility rules of [page.getByRole()](/api/class-page.mdx#page-get-by-role) or the behavior of selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).
+
+**Usage**
+
+```js title="playwright.config.ts"
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  use: {
+    locateOnlyVisible: true,
+  },
+});
+```
+
+**Type**
+- [boolean]
+
+---
+
 ### navigationTimeout {/* #test-options-navigation-timeout */}
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.10</font><x-search>testOptions.navigationTimeout</x-search>
diff --git a/nodejs/docs/api/class-testproject.mdx b/nodejs/docs/api/class-testproject.mdx
index 48d042f45c..7fc912683e 100644
--- a/nodejs/docs/api/class-testproject.mdx
+++ b/nodejs/docs/api/class-testproject.mdx
@@ -9,7 +9,7 @@ import HTMLCard from '@site/src/components/HTMLCard';
 
 Playwright Test supports running multiple test projects at the same time. This is useful for running tests in multiple configurations. For example, consider running tests against multiple browsers. This type describes format of a project in the configuration file, to access resolved configuration parameters at run time use [FullProject].
 
-`TestProject` encapsulates configuration specific to a single project. Projects are configured in [testConfig.projects](/api/class-testconfig.mdx#test-config-projects) specified in the [configuration file](../test-configuration.mdx). Note that all properties of [TestProject] are available in the top-level [TestConfig], in which case they are shared between all projects.
+`TestProject` encapsulates configuration specific to a single project. Projects are configured in [testConfig.projects](/api/class-testconfig.mdx#test-config-projects) specified in the [configuration file](../test-configuration.mdx). Note that all properties of [TestProject] are available in the top-level [TestConfig], in which case they are shared between all projects. The exception is [testProject.webServer](/api/class-testproject.mdx#test-project-web-server): top-level servers are started separately, for the whole run.
 
 Here is an example configuration that runs every test in Chromium, Firefox and WebKit, both Desktop and Mobile versions.
 
@@ -428,6 +428,8 @@ testProject.respectGitIgnore
 
 The maximum number of retry attempts given to failed tests. Learn more about [test retries](../test-retries.mdx#retries).
 
+Set to a list to make the number of retries depend on the error, see [testConfig.retries](/api/class-testconfig.mdx#test-config-retries).
+
 Use [test.describe.configure()](/api/class-test.mdx#test-describe-configure) to change the number of retries for a specific file or a group of tests.
 
 Use [testConfig.retries](/api/class-testconfig.mdx#test-config-retries) to change this option for all projects.
@@ -439,7 +441,13 @@ testProject.retries
 ```
 
 **Type**
-- [number]
+- [number] | [Array]&lt;[Object]&gt;
+  - `count` [number]
+    
+    The maximum number of retries given to a failed test when this entry applies.
+  - `condition` [RegExp] *(optional)*
+    
+    Regular expression matched against the error messages of the failed attempt. An entry without a condition always applies.
 
 ---
 
@@ -777,6 +785,49 @@ testProject.use
 
 ---
 
+### webServer {/* #test-project-web-server */}
+
+<font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.66</font><x-search>testProject.webServer</x-search>
+
+Launch a development web server (or multiple) for this project. Accepts the same options as [testConfig.webServer](/api/class-testconfig.mdx#test-config-web-server).
+
+Project servers are added to the top-level servers, not inherited from them or used to replace them. They start after `globalSetup` and stop before its returned teardown function and `globalTeardown`. In the command line, project selection controls which servers start, including servers for dependencies and teardown projects. Test filters and sharding do not affect server startup. Listing tests does not start project servers. In UI mode and VS Code, all project servers start with global setup and stay alive across test runs until global teardown or configuration reload.
+
+[fullProject.webServer](/api/class-fullproject.mdx#full-project-web-server) exposes these settings as an array, including in `globalSetup`. Project servers are not available during `globalSetup` or `globalTeardown`.
+
+For a single server with `port` and no `url`, the project's [testOptions.baseURL](/api/class-testoptions.mdx#test-options-base-url) defaults to `http://localhost:<port>`. An explicitly configured `baseURL` takes precedence. For arrays or servers with `url`, configure `baseURL` explicitly.
+
+**Usage**
+
+```js title="playwright.config.ts"
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  projects: [
+    {
+      name: 'local',
+      webServer: {
+        command: 'npm run start',
+        url: 'http://localhost:3000',
+        reuseExistingServer: !process.env.CI,
+      },
+      use: { baseURL: 'http://localhost:3000' },
+    },
+    {
+      name: 'production',
+      use: { baseURL: 'https://production.example' },
+    },
+  ],
+});
+```
+
+Running `npx playwright test --project=production` does not start the local server.
+
+**Type**
+- [Object] | [Array]&lt;[Object]&gt;
+
+---
+
 ### workers {/* #test-project-workers */}
 
 <font size="2" style={{position: "relative", top: "-20px"}}>Added in: v1.52</font><x-search>testProject.workers</x-search>
diff --git a/nodejs/docs/ci.mdx b/nodejs/docs/ci.mdx
index 1eaa867417..cffde6c851 100644
--- a/nodejs/docs/ci.mdx
+++ b/nodejs/docs/ci.mdx
@@ -117,7 +117,7 @@ jobs:
     name: 'Playwright Tests'
     runs-on: ubuntu-latest
     container:
-      image: mcr.microsoft.com/playwright:v1.64.1-noble
+      image: mcr.microsoft.com/playwright:v1.65.0-noble
       options: --user 1001
     steps:
       - uses: actions/checkout@v6
@@ -349,7 +349,7 @@ trigger:
 
 pool:
   vmImage: ubuntu-latest
-container: mcr.microsoft.com/playwright:v1.64.1-noble
+container: mcr.microsoft.com/playwright:v1.65.0-noble
 
 steps:
 - task: UseNode@1
@@ -373,7 +373,7 @@ Running Playwright on CircleCI is very similar to running on GitHub Actions. In
 executors:
   pw-noble-development:
     docker:
-      - image: mcr.microsoft.com/playwright:v1.64.1-noble
+      - image: mcr.microsoft.com/playwright:v1.65.0-noble
 ```
 
 Note: When using the docker agent definition, you are specifying the resource class of where playwright runs to the 'medium' tier [here](https://circleci.com/docs/configuration-reference?#docker-execution-environment). The default behavior of Playwright is to set the number of workers to the detected core count (2 in the case of the medium tier). Overriding the number of workers to greater than this number will cause unnecessary timeouts and failures.
@@ -396,7 +396,7 @@ Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](
 
 ```groovy
 pipeline {
-   agent { docker { image 'mcr.microsoft.com/playwright:v1.64.1-noble' } }
+   agent { docker { image 'mcr.microsoft.com/playwright:v1.65.0-noble' } }
    stages {
       stage('e2e-tests') {
          steps {
@@ -413,7 +413,7 @@ pipeline {
 Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.mdx)).
 
 ```yml
-image: mcr.microsoft.com/playwright:v1.64.1-noble
+image: mcr.microsoft.com/playwright:v1.65.0-noble
 ```
 
 ### GitLab CI
@@ -426,7 +426,7 @@ stages:
 
 tests:
   stage: test
-  image: mcr.microsoft.com/playwright:v1.64.1-noble
+  image: mcr.microsoft.com/playwright:v1.65.0-noble
   script:
   ...
 ```
@@ -441,7 +441,7 @@ stages:
 
 tests:
   stage: test
-  image: mcr.microsoft.com/playwright:v1.64.1-noble
+  image: mcr.microsoft.com/playwright:v1.65.0-noble
   parallel: 7
   script:
     - npm ci
@@ -456,7 +456,7 @@ stages:
 
 tests:
   stage: test
-  image: mcr.microsoft.com/playwright:v1.64.1-noble
+  image: mcr.microsoft.com/playwright:v1.65.0-noble
   parallel:
     matrix:
       - PROJECT: ['chromium', 'webkit']
@@ -472,7 +472,7 @@ To run Playwright tests on Google Cloud Build, use our public Docker image ([see
 
 ```yml
 steps:
-- name: mcr.microsoft.com/playwright:v1.64.1-noble
+- name: mcr.microsoft.com/playwright:v1.65.0-noble
   script:
   ...
   env:
@@ -490,7 +490,7 @@ type: docker
 
 steps:
   - name: test
-    image: mcr.microsoft.com/playwright:v1.64.1-noble
+    image: mcr.microsoft.com/playwright:v1.65.0-noble
     commands:
       - npx playwright test
 ```
diff --git a/nodejs/docs/docker.mdx b/nodejs/docs/docker.mdx
index 0460f99a25..2707d7042d 100644
--- a/nodejs/docs/docker.mdx
+++ b/nodejs/docs/docker.mdx
@@ -22,7 +22,7 @@ This Docker image is intended to be used for testing and development purposes on
 ### Pull the image
 
 ```bash
-docker pull mcr.microsoft.com/playwright:v1.64.1-noble
+docker pull mcr.microsoft.com/playwright:v1.65.0-noble
 ```
 
 ### Run the image
@@ -34,7 +34,7 @@ By default, the Docker image will use the `root` user to run the browsers. This
 On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers.
 
 ```bash
-docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.64.1-noble /bin/bash
+docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.65.0-noble /bin/bash
 ```
 
 #### Crawling and scraping
@@ -42,7 +42,7 @@ docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.64.1-noble /bin/b
 On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it.
 
 ```bash
-docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:v1.64.1-noble /bin/bash
+docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:v1.65.0-noble /bin/bash
 ```
 
 [`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/main/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions:
@@ -82,7 +82,7 @@ You can run Playwright Server in Docker while keeping your tests running on the
 Start the Playwright Server in Docker:
 
 ```bash
-docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.64.1-noble /bin/sh -c "npx -y playwright@1.64.1 run-server --port 3000 --host 0.0.0.0"
+docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.65.0-noble /bin/sh -c "npx -y playwright@1.65.0 run-server --port 3000 --host 0.0.0.0"
 ```
 
 #### Connecting to the Server
@@ -105,7 +105,7 @@ const browser = await playwright['chromium'].connect('ws://127.0.0.1:3000/');
 If you need to access local servers from within the Docker container:
 
 ```bash
-docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.64.1-noble /bin/sh -c "npx -y playwright@1.64.1 run-server --port 3000 --host 0.0.0.0"
+docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.65.0-noble /bin/sh -c "npx -y playwright@1.65.0 run-server --port 3000 --host 0.0.0.0"
 ```
 
 This makes `hostmachine` point to the host's localhost. Your tests should use `hostmachine` instead of `localhost` when accessing local servers.
@@ -121,7 +121,7 @@ For Docker and GitHub Codespaces environments, you can view and generate tests u
 
 ```json
 {
-  "image": "mcr.microsoft.com/playwright:v1.64.1-noble",
+  "image": "mcr.microsoft.com/playwright:v1.65.0-noble",
   "forwardPorts": [6080],
   "features": {
     "desktop-lite": {
@@ -138,10 +138,10 @@ Once this is enabled you can open the port specified in a new browser tab and yo
 See [all available image tags].
 
 We currently publish images with the following tags:
-- `:v1.64.1` - Playwright v1.64.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
-- `:v1.64.1-noble` - Playwright v1.64.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
-- `:v1.64.1-jammy` - Playwright v1.64.1 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish).
-- `:v1.64.1-resolute` - Playwright v1.64.1 release docker image based on Ubuntu 26.04 LTS (Resolute Raccoon).
+- `:v1.65.0` - Playwright v1.65.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
+- `:v1.65.0-noble` - Playwright v1.65.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
+- `:v1.65.0-jammy` - Playwright v1.65.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish).
+- `:v1.65.0-resolute` - Playwright v1.65.0 release docker image based on Ubuntu 26.04 LTS (Resolute Raccoon).
 
 :::note
 
@@ -166,7 +166,7 @@ To run Playwright inside Docker, you need to have Node.js, [Playwright browsers]
 ```Dockerfile
 FROM node:26-bookworm
 
-RUN npx -y playwright@1.64.1 install --with-deps
+RUN npx -y playwright@1.65.0 install --with-deps
 ```
 
 
diff --git a/nodejs/docs/getting-started-cli.mdx b/nodejs/docs/getting-started-cli.mdx
deleted file mode 100644
index 8cef8bffe5..0000000000
--- a/nodejs/docs/getting-started-cli.mdx
+++ /dev/null
@@ -1,445 +0,0 @@
----
-id: getting-started-cli
-title: "Coding agents"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-Playwright comes with `playwright-cli`, a command-line interface for browser automation designed for coding agents. It provides token-efficient browser control through concise CLI commands and installable skills, making it ideal for agents that need to balance browser automation with large codebases and reasoning within limited context windows.
-
-### `playwright-cli` vs Playwright MCP
-- **`playwright-cli`** is best for **coding agents** (Claude Code, GitHub Copilot, etc.) that favor token-efficient, skill-based workflows. CLI commands avoid loading large tool schemas and verbose accessibility trees into the model context.
-- **MCP** is best for specialized agentic loops that benefit from persistent state and iterative reasoning over page structure, such as exploratory automation or long-running autonomous workflows. See the [MCP getting started guide](./getting-started-mcp.mdx).
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- A coding agent: Claude Code, GitHub Copilot, or similar
-
-## Installation
-
-Install `playwright-cli` globally:
-
-```bash
-npm install -g @playwright/cli@latest
-playwright-cli --help
-```
-
-Alternatively, install `@playwright/cli` as a local dependency and use `npx`:
-
-```bash
-npm install -D @playwright/cli@latest
-npx playwright cli --help
-```
-
-### Installing skills
-
-Coding agents like Claude Code and GitHub Copilot can use locally installed skills for richer context about available commands:
-
-```bash
-playwright-cli install --skills
-```
-
-To share the skills across all your projects, add the `-g` flag to install them into your home directory (`~/.claude/skills` or, with `--skills=agents`, `~/.agents/skills`):
-
-```bash
-playwright-cli install --skills -g
-```
-
-### Skills-less operation
-
-You can also point your agent at the CLI directly and let it discover commands on its own:
-
-```txt
-Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
-Check playwright-cli --help for available commands.
-```
-
-## First Steps
-
-### Interactive demo
-
-Try asking your coding agent:
-
-```txt
-Use playwright skills to test https://demo.playwright.dev/todomvc/.
-Take screenshots for all successful and failing scenarios.
-```
-
-### Manual walkthrough
-
-You can also run commands manually to see how the CLI works:
-
-```bash
-playwright-cli open https://demo.playwright.dev/todomvc/ --headed
-playwright-cli type "Buy groceries"
-playwright-cli press Enter
-playwright-cli type "Water flowers"
-playwright-cli press Enter
-playwright-cli check e21
-playwright-cli screenshot
-```
-
-After each command, the CLI outputs a snapshot of the current page state:
-
-```txt
-### Page
-- Page URL: https://demo.playwright.dev/todomvc/#/
-- Page Title: React • TodoMVC
-### Snapshot
-[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
-```
-
-## Core Commands
-
-### Interacting with pages
-
-```bash
-playwright-cli open [url]               # open browser, optionally navigate to url
-playwright-cli goto <url>               # navigate to a url
-playwright-cli click <ref> [button]     # click an element
-playwright-cli type <text>              # type text into editable element
-playwright-cli fill <ref> <text>        # fill text into editable element
-playwright-cli select <ref> <value>     # select an option in a dropdown
-playwright-cli check <ref>              # check a checkbox or radio button
-playwright-cli uncheck <ref>            # uncheck a checkbox
-playwright-cli hover <ref>              # hover over element
-playwright-cli drag <startRef> <endRef> # drag and drop between elements
-playwright-cli upload <files...>        # upload one or multiple files
-playwright-cli close                    # close the page
-```
-
-### Targeting elements
-
-Use element refs from snapshots to target elements:
-
-```bash
-playwright-cli snapshot                 # get snapshot with element refs
-playwright-cli click e15                # click using a ref
-```
-
-You can also use CSS or role selectors:
-
-```bash
-playwright-cli click "#main > button.submit"
-playwright-cli click "role=button[name=Submit]"
-playwright-cli click "#footer >> role=button[name=Submit]"
-```
-
-### Screenshots and snapshots
-
-```bash
-playwright-cli snapshot                 # capture page snapshot
-playwright-cli snapshot --filename=f    # save snapshot to specific file
-playwright-cli screenshot               # screenshot of the current page
-playwright-cli screenshot [ref]         # screenshot of a specific element
-playwright-cli screenshot --filename=f  # save with specific filename
-playwright-cli screenshot --hires       # capture using device pixels
-playwright-cli pdf                      # save page as PDF
-```
-
-### Navigation
-
-```bash
-playwright-cli go-back                  # go back
-playwright-cli go-forward               # go forward
-playwright-cli reload                   # reload the page
-```
-
-### Keyboard and mouse
-
-```bash
-playwright-cli press <key>              # press a key (e.g. Enter, ArrowLeft)
-playwright-cli keydown <key>            # key down
-playwright-cli keyup <key>              # key up
-playwright-cli mousemove <x> <y>        # move mouse
-playwright-cli mousedown [button]       # mouse button down
-playwright-cli mouseup [button]         # mouse button up
-playwright-cli mousewheel <dx> <dy>     # scroll
-```
-
-### Tabs
-
-```bash
-playwright-cli tab-list                 # list all tabs
-playwright-cli tab-new [url]            # create a new tab
-playwright-cli tab-select <index>       # select a tab
-playwright-cli tab-close [index]        # close a tab
-```
-
-### Network
-
-```bash
-playwright-cli requests                 # list network requests since page load
-playwright-cli request <num>            # show full details of a single request
-playwright-cli route <pattern> [opts]   # mock network requests
-playwright-cli route-list               # list active routes
-playwright-cli unroute [pattern]        # remove routes
-```
-
-### Storage
-
-```bash
-playwright-cli state-save [filename]    # save storage state (cookies, localStorage)
-playwright-cli state-load <filename>    # load storage state
-
-# Cookies
-playwright-cli cookie-list [--domain]   # list cookies
-playwright-cli cookie-get <name>        # get a cookie
-playwright-cli cookie-set <name> <val>  # set a cookie
-playwright-cli cookie-delete <name>     # delete a cookie
-playwright-cli cookie-clear             # clear all cookies
-
-# localStorage
-playwright-cli localstorage-list        # list entries
-playwright-cli localstorage-get <key>   # get value
-playwright-cli localstorage-set <k> <v> # set value
-playwright-cli localstorage-delete <k>  # delete entry
-playwright-cli localstorage-clear       # clear all
-```
-
-### DevTools
-
-```bash
-playwright-cli console [min-level]      # list console messages
-playwright-cli eval <func> [ref]        # evaluate JavaScript on page
-playwright-cli run-code <code>          # run Playwright code snippet
-playwright-cli tracing-start            # start trace recording
-playwright-cli tracing-stop             # stop trace recording
-playwright-cli video-start              # start video recording
-playwright-cli video-chapter <title>    # add chapter marker to video
-playwright-cli video-stop --filename=f  # stop video recording
-```
-
-### WebMCP
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools a page registers are listed at the top of the page snapshot, and they can be called directly:
-
-```bash
-playwright-cli webmcp-list                       # list tools registered by the page
-playwright-cli webmcp-call <name> [--params]     # call one, passing a JSON object
-```
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Sessions
-
-The CLI keeps the browser profile in memory by default — cookies and storage state are preserved between calls within a session but lost when the browser closes. Use `--persistent` to save the profile to disk.
-
-### Named sessions
-
-Run multiple browser instances for different projects:
-
-```bash
-playwright-cli open https://playwright.dev
-playwright-cli -s=example open https://example.com --persistent
-playwright-cli list                     # list all sessions
-```
-
-You can configure your coding agent to use a specific session:
-
-```bash
-PLAYWRIGHT_CLI_SESSION=todo-app claude .
-```
-
-### Session management
-
-```bash
-playwright-cli list                     # list all sessions
-playwright-cli close-all                # close all browsers
-playwright-cli kill-all                 # forcefully kill all browser processes
-playwright-cli -s=name delete-data      # delete user data for a named session
-```
-
-A headless session shuts itself down after an hour without commands, so a session an agent forgot to close does not keep a browser running. Headed and attached browsers are never closed automatically. Change the timeout with `open --idle-timeout=<ms>` or `timeouts.idle` in the config file, and pass `0` to disable it.
-
-## Monitoring
-
-Use `playwright-cli show` to open a visual dashboard for observing and controlling all running browser sessions:
-
-```bash
-playwright-cli show
-```
-
-The dashboard provides:
-- **Session grid** — all active sessions grouped by workspace, each with a live screencast preview, session name, current URL, and page title. Click any session to zoom in.
-- **Session detail** — a live view of the selected session with tab bar, navigation controls, and full remote control. Click into the viewport to take over mouse and keyboard; press Escape to release.
-
-## Configuration
-
-### Headed mode
-
-The CLI runs headless by default. To see the browser:
-
-```bash
-playwright-cli open https://playwright.dev --headed
-```
-
-### Browser selection
-
-```bash
-playwright-cli open --browser=chrome    # use specific browser
-playwright-cli open --browser=firefox
-playwright-cli open --browser=webkit
-playwright-cli open --browser=msedge
-```
-
-### Configuration file
-
-For advanced settings, use a JSON config file:
-
-```bash
-playwright-cli --config path/to/config.json open example.com
-```
-
-The CLI also loads `.playwright/cli.config.json` automatically if present. The config file supports browser options, context options, network rules, timeouts, and more. Run `playwright-cli --help` for the full list of options.
-
-### Browser extension
-
-Connect to your existing browser tabs instead of launching a new browser:
-
-```bash
-playwright-cli attach --extension
-```
-
-This requires the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md) to be installed.
-
-## Quick Reference
-
-| Action                    | Command                                             |
-| ------------------------- | --------------------------------------------------- |
-| **Install CLI**           | `npm install -g @playwright/cli@latest`             |
-| **Install skills**        | `playwright-cli install --skills`                   |
-| **Open a page**           | `playwright-cli open https://example.com`           |
-| **Click an element**      | `playwright-cli click e15`                          |
-| **Type text**             | `playwright-cli type "hello world"`                 |
-| **Take a screenshot**     | `playwright-cli screenshot`                         |
-| **Get page snapshot**     | `playwright-cli snapshot`                           |
-| **Run headed**            | `playwright-cli open https://example.com --headed`  |
-| **Use Firefox**           | `playwright-cli open --browser=firefox`             |
-| **Monitor sessions**      | `playwright-cli show`                               |
-| **List page WebMCP tools** | `playwright-cli webmcp-list`                       |
-
-## What's Next
-- [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
-- [Run your tests on CI](./ci-intro.mdx)
-- [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserServer]: /api/class-browserserver.mdx "BrowserServer"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Coverage]: /api/class-coverage.mdx "Coverage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Disposable]: /api/class-disposable.mdx "Disposable"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[GenericAssertions]: /api/class-genericassertions.mdx "GenericAssertions"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Logger]: /api/class-logger.mdx "Logger"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[SnapshotAssertions]: /api/class-snapshotassertions.mdx "SnapshotAssertions"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Electron]: /api/class-electron.mdx "Electron"
-[ElectronApplication]: /api/class-electronapplication.mdx "ElectronApplication"
-[Android]: /api/class-android.mdx "Android"
-[AndroidDevice]: /api/class-androiddevice.mdx "AndroidDevice"
-[AndroidInput]: /api/class-androidinput.mdx "AndroidInput"
-[AndroidSocket]: /api/class-androidsocket.mdx "AndroidSocket"
-[AndroidWebView]: /api/class-androidwebview.mdx "AndroidWebView"
-[Fixtures]: /api/class-fixtures.mdx "Fixtures"
-[FullConfig]: /api/class-fullconfig.mdx "FullConfig"
-[FullProject]: /api/class-fullproject.mdx "FullProject"
-[Location]: /api/class-location.mdx "Location"
-[Test]: /api/class-test.mdx "Test"
-[TestConfig]: /api/class-testconfig.mdx "TestConfig"
-[TestInfo]: /api/class-testinfo.mdx "TestInfo"
-[TestInfoError]: /api/class-testinfoerror.mdx "TestInfoError"
-[TestOptions]: /api/class-testoptions.mdx "TestOptions"
-[TestProject]: /api/class-testproject.mdx "TestProject"
-[TestStepInfo]: /api/class-teststepinfo.mdx "TestStepInfo"
-[WorkerInfo]: /api/class-workerinfo.mdx "WorkerInfo"
-[Reporter]: /api/class-reporter.mdx "Reporter"
-[Suite]: /api/class-suite.mdx "Suite"
-[TestCase]: /api/class-testcase.mdx "TestCase"
-[TestError]: /api/class-testerror.mdx "TestError"
-[TestResult]: /api/class-testresult.mdx "TestResult"
-[TestRun]: /api/class-testrun.mdx "TestRun"
-[TestStep]: /api/class-teststep.mdx "TestStep"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[AbortSignal]: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal "AbortSignal"
-[Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array "Array"
-[boolean]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type "Boolean"
-[Buffer]: https://nodejs.org/api/buffer.html#buffer_class_buffer "Buffer"
-[ChildProcess]: https://nodejs.org/api/child_process.html "ChildProcess"
-[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date "Date"
-[Error]: https://nodejs.org/api/errors.html#errors_class_error "Error"
-[EventEmitter]: https://nodejs.org/api/events.html#events_class_eventemitter "EventEmitter"
-[function]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function "Function"
-[FormData]: https://developer.mozilla.org/en-US/docs/Web/API/FormData "FormData"
-[Map]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map "Map"
-[Metadata]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object "Object&lt;string, any&gt;"
-[null]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/null "null"
-[number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type "Number"
-[Object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object "Object"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[Readable]: https://nodejs.org/api/stream.html#stream_class_stream_readable "Readable"
-[ReadStream]: https://nodejs.org/api/fs.html#class-fsreadstream "ReadStream"
-[RegExp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp "RegExp"
-[string]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type "string"
-[void]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined "void"
-[URL]: https://nodejs.org/api/url.html "URL"
-[URLPattern]: https://developer.mozilla.org/en-US/docs/Web/API/URLPattern "URLPattern"
-[URLSearchParams]: https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams "URLSearchParams"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/nodejs/docs/getting-started-mcp.mdx b/nodejs/docs/getting-started-mcp.mdx
deleted file mode 100644
index d164140b0a..0000000000
--- a/nodejs/docs/getting-started-mcp.mdx
+++ /dev/null
@@ -1,372 +0,0 @@
----
-id: getting-started-mcp
-title: "Playwright MCP"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-The Playwright MCP server provides browser automation capabilities through the [Model Context Protocol](https://modelcontextprotocol.io), enabling LLMs to interact with web pages using structured accessibility snapshots. It works with VS Code, Cursor, Windsurf, Claude Desktop, and any other MCP client — no vision models required.
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- An MCP client: VS Code, Cursor, Windsurf, Claude Code, Claude Desktop, or similar
-
-## Getting Started
-
-### Installation
-
-Add the Playwright MCP server to your client using the standard configuration:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
-```
-
-#### VS Code
-
-Click one of the buttons below to install directly:
-
-[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D)
-
-Or install via the VS Code CLI:
-
-```bash
-code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
-```
-
-#### Cursor
-
-[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=Playwright&config=eyJjb21tYW5kIjoibnB4IEBwbGF5d3JpZ2h0L21jcEBsYXRlc3QifQ%3D%3D)
-
-Or go to `Cursor Settings` → `MCP` → `Add new MCP Server` and use command type with `npx @playwright/mcp@latest`.
-
-#### Claude Code
-
-```bash
-claude mcp add playwright npx @playwright/mcp@latest
-```
-
-#### Claude Desktop
-
-Follow the MCP install [guide](https://modelcontextprotocol.io/quickstart/user) and use the standard config above.
-
-#### Other clients
-
-The standard configuration works with most MCP clients, including Windsurf, Cline, Goose, Kiro, Codex, Copilot CLI, and others. Consult your client's MCP documentation for where to place the config.
-
-### First interaction
-
-Once the server is connected, ask your AI assistant to interact with a web page:
-
-```txt
-Navigate to https://demo.playwright.dev/todomvc and add a few todo items.
-```
-
-The assistant will use Playwright MCP tools to open the browser, navigate to the page, and interact with elements — all through structured accessibility snapshots rather than screenshots.
-
-## Core Features
-
-### Accessibility snapshots
-
-Playwright MCP operates on the page's accessibility tree, not pixels. When a tool runs, it returns a structured snapshot showing the page elements, their roles, and text content. The LLM uses element references from these snapshots to interact with the page:
-
-```txt
-- heading "todos" [level=1]
-- textbox "What needs to be done?" [ref=e5]
-- listitem:
-  - checkbox "Toggle Todo" [ref=e10]
-  - text: "Buy groceries"
-```
-
-The LLM reads this snapshot and uses `ref=e5` to type into the textbox or `ref=e10` to check the checkbox.
-
-### Interacting with pages
-
-Playwright MCP provides tools for all common browser interactions:
--   **Navigation**: Open URLs, go back/forward, reload pages.
--   **Clicking and typing**: Click elements, type text, fill forms, select dropdowns.
--   **Screenshots**: Capture the current page or specific elements for visual verification.
--   **Keyboard and mouse**: Press keys, hover, drag and drop.
--   **Dialogs**: Accept or dismiss browser dialogs.
--   **Tabs**: Create, close, and switch between browser tabs.
-
-### Running Playwright code
-
-For complex interactions that go beyond individual tool calls, use the `browser_run_code_unsafe` tool to execute Playwright scripts directly. This tool runs arbitrary JavaScript in the Playwright server process and is RCE-equivalent — only enable it for trusted MCP clients:
-
-```txt
-Run this Playwright code to verify the todo count:
-async (page) => {
-  const count = await page.getByTestId('todo-count').textContent();
-  return count;
-}
-```
-
-### Network monitoring and mocking
-
-Inspect network traffic and mock API responses:
--   **View network requests**: List all requests made since page load.
--   **Mock routes**: Set up URL pattern matching to return custom responses.
--   **Console messages**: Access browser console output for debugging.
-
-### Storage state
-
-Save and restore browser state including cookies and localStorage:
--   **Save state**: Persist authentication and session data to a file.
--   **Restore state**: Load previously saved state into a new session.
--   **Cookie management**: List, get, set, and delete individual cookies.
-
-### WebMCP tools
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools of the current tab are offered as MCP tools named `webmcp_<tool>`.
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Configuration
-
-### Headed mode
-
-By default, Playwright MCP runs the browser in headed mode so you can see what's happening. To run headless:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headless"
-      ]
-    }
-  }
-}
-```
-
-### Browser selection
-
-Choose which browser to use:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--browser=firefox"
-      ]
-    }
-  }
-}
-```
-
-Supported values: `chrome`, `firefox`, `webkit`, `msedge`.
-
-### User profile
-
-Playwright MCP supports three profile modes:
--   **Persistent (default)**: Login state and cookies are preserved between sessions. The profile is stored in `ms-playwright/mcp-{channel}-{workspace-hash}` in your platform's cache directory, so different projects get separate profiles automatically. Override with `--user-data-dir`.
--   **Isolated**: Each session starts fresh. Pass `--isolated` to enable. You can load initial state with `--storage-state`.
--   **Browser extension**: Connect to your existing browser tabs with the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md). Pass `--extension` to enable.
-
-### Idle timeout
-
-A page that keeps animating or rendering costs CPU for as long as the browser is open, and an agent session can last hours. A headless browser launched by the server is therefore closed after an hour without tool calls. Headed browsers, and browsers attached over `--cdp-endpoint` or `--extension`, are never closed automatically. Pass `--idle-timeout` to set the timeout in milliseconds for any mode, or `0` to disable it:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--idle-timeout=300000"
-      ]
-    }
-  }
-}
-```
-
-When no tool call has completed for that long, the browser is closed, headed or not, the same way as if you had closed it by hand. The next tool call launches a new browser, so the agent navigates again. The timer never fires while a tool call is running.
--   With `--isolated`, cookies and storage kept in memory are lost on an idle close. Use the persistent profile or `--storage-state` to keep them. Each client has its own timer: the context of an idle client is closed while other clients keep working, and the browser is closed once no client has a context.
--   With `--cdp-endpoint` or `--extension`, the browser is not owned by the server, so there is no default timeout, and an explicit one only disconnects from it, leaving its pages open. With `--extension`, the next tool call goes through the connect flow again.
--   With `--shared-browser-context`, the timer spans all clients: a client that is idle while others keep working keeps its tabs and state, and the shared browser is closed only once every client has been idle for the timeout.
-
-### Configuration file
-
-For advanced configuration, use a JSON config file:
-
-```bash
-npx @playwright/mcp@latest --config path/to/config.json
-```
-
-The config file supports browser options, context options, network rules, timeouts, and more. See the [Playwright MCP repository](https://github.com/microsoft/playwright-mcp/blob/main/config.d.ts) for the full schema.
-
-### Standalone server
-
-When running a headed browser on a system without a display or from IDE worker processes, start the MCP server separately with HTTP transport:
-
-```bash
-npx @playwright/mcp@latest --port 8931
-```
-
-HTTP sessions use a five-second heartbeat timeout. If your MCP client or proxy does not answer server-initiated pings, set `PLAYWRIGHT_MCP_PING_TIMEOUT_MS` to a longer timeout in milliseconds. Set it to `0` to disable the heartbeat.
-
-Then point your MCP client to the HTTP endpoint:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "url": "http://localhost:8931/mcp"
-    }
-  }
-}
-```
-
-## Quick Reference
-
-| Action                    | How to do it                                                  |
-| ------------------------- | ------------------------------------------------------------- |
-| **Install server**        | Add standard config to your MCP client                        |
-| **Navigate to a page**    | Ask: "Go to https://example.com"                              |
-| **Click an element**      | Ask: "Click the Submit button"                                |
-| **Fill a form**           | Ask: "Fill in the email field with test@example.com"          |
-| **Take a screenshot**     | Ask: "Take a screenshot of the page"                          |
-| **Run Playwright code**   | Ask: "Run this Playwright code: ..."                          |
-| **Mock an API**           | Ask: "Mock the /api/users endpoint to return ..."             |
-| **Use headed mode**       | Default. Pass `--headless` to disable                         |
-| **Choose a browser**      | Pass `--browser=firefox` in args                              |
-
-## What's Next
--   [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
--   [Run your tests on CI](./ci-intro.mdx)
--   [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserServer]: /api/class-browserserver.mdx "BrowserServer"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Coverage]: /api/class-coverage.mdx "Coverage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Disposable]: /api/class-disposable.mdx "Disposable"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[GenericAssertions]: /api/class-genericassertions.mdx "GenericAssertions"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Logger]: /api/class-logger.mdx "Logger"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[PlaywrightAssertions]: /api/class-playwrightassertions.mdx "PlaywrightAssertions"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[SnapshotAssertions]: /api/class-snapshotassertions.mdx "SnapshotAssertions"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Electron]: /api/class-electron.mdx "Electron"
-[ElectronApplication]: /api/class-electronapplication.mdx "ElectronApplication"
-[Android]: /api/class-android.mdx "Android"
-[AndroidDevice]: /api/class-androiddevice.mdx "AndroidDevice"
-[AndroidInput]: /api/class-androidinput.mdx "AndroidInput"
-[AndroidSocket]: /api/class-androidsocket.mdx "AndroidSocket"
-[AndroidWebView]: /api/class-androidwebview.mdx "AndroidWebView"
-[Fixtures]: /api/class-fixtures.mdx "Fixtures"
-[FullConfig]: /api/class-fullconfig.mdx "FullConfig"
-[FullProject]: /api/class-fullproject.mdx "FullProject"
-[Location]: /api/class-location.mdx "Location"
-[Test]: /api/class-test.mdx "Test"
-[TestConfig]: /api/class-testconfig.mdx "TestConfig"
-[TestInfo]: /api/class-testinfo.mdx "TestInfo"
-[TestInfoError]: /api/class-testinfoerror.mdx "TestInfoError"
-[TestOptions]: /api/class-testoptions.mdx "TestOptions"
-[TestProject]: /api/class-testproject.mdx "TestProject"
-[TestStepInfo]: /api/class-teststepinfo.mdx "TestStepInfo"
-[WorkerInfo]: /api/class-workerinfo.mdx "WorkerInfo"
-[Reporter]: /api/class-reporter.mdx "Reporter"
-[Suite]: /api/class-suite.mdx "Suite"
-[TestCase]: /api/class-testcase.mdx "TestCase"
-[TestError]: /api/class-testerror.mdx "TestError"
-[TestResult]: /api/class-testresult.mdx "TestResult"
-[TestRun]: /api/class-testrun.mdx "TestRun"
-[TestStep]: /api/class-teststep.mdx "TestStep"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[AbortSignal]: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal "AbortSignal"
-[Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array "Array"
-[boolean]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type "Boolean"
-[Buffer]: https://nodejs.org/api/buffer.html#buffer_class_buffer "Buffer"
-[ChildProcess]: https://nodejs.org/api/child_process.html "ChildProcess"
-[Date]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date "Date"
-[Error]: https://nodejs.org/api/errors.html#errors_class_error "Error"
-[EventEmitter]: https://nodejs.org/api/events.html#events_class_eventemitter "EventEmitter"
-[function]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function "Function"
-[FormData]: https://developer.mozilla.org/en-US/docs/Web/API/FormData "FormData"
-[Map]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map "Map"
-[Metadata]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object "Object&lt;string, any&gt;"
-[null]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/null "null"
-[number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type "Number"
-[Object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object "Object"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[Readable]: https://nodejs.org/api/stream.html#stream_class_stream_readable "Readable"
-[ReadStream]: https://nodejs.org/api/fs.html#class-fsreadstream "ReadStream"
-[RegExp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp "RegExp"
-[string]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type "string"
-[void]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/undefined "void"
-[URL]: https://nodejs.org/api/url.html "URL"
-[URLPattern]: https://developer.mozilla.org/en-US/docs/Web/API/URLPattern "URLPattern"
-[URLSearchParams]: https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams "URLSearchParams"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/nodejs/docs/release-notes.mdx b/nodejs/docs/release-notes.mdx
index b723cdb792..3c24a3c2da 100644
--- a/nodejs/docs/release-notes.mdx
+++ b/nodejs/docs/release-notes.mdx
@@ -84,6 +84,7 @@ export default defineConfig({
 - Proxy credentials are no longer sent to websites. The credentials in the [proxy](/api/class-browsertype.mdx#browser-type-launch-option-proxy) option now answer only proxy challenges. To authenticate on a website, use [httpCredentials](/api/class-browser.mdx#browser-new-context-option-http-credentials).
 - Text that the browser does not render, such as text that is not assigned to a slot or text directly inside a closed `<details>`, is no longer part of accessible names and aria snapshots. This can change the results of [page.getByRole()](/api/class-page.mdx#page-get-by-role) with a name, [locator.ariaSnapshot()](/api/class-locator.mdx#locator-aria-snapshot) and [expect(locator).toMatchAriaSnapshot()](/api/class-locatorassertions.mdx#locator-assertions-to-match-aria-snapshot).
 - String and `URLSearchParams` values of the `params` option in [APIRequestContext] requests are now appended to the query that the URL already has, instead of replacing it.
+- [APIRequestContext] now matches `application/json` content types case-insensitively and with parameters, such as `application/json;charset=UTF-8`, when serializing string `data`. Previously, only the exact value `application/json` triggered JSON encoding. With these content types, a string that does not parse as JSON is now JSON-encoded, including quotes and escaping, instead of being sent as is. This changes malformed JSON bodies and can invalidate signatures computed over the original string. Pass `data: Buffer.from(body, 'utf8')` to send exact bytes without JSON encoding. Strings that already parse as JSON and `Buffer` data are unchanged.
 - `.css`, `.less` and `.scss` imports in test files now load as empty modules instead of being removed, so the imported file must exist.
 - The blob reporter again deletes the content of its output directory before it writes the report. Playwright 1.64 kept reports with other names.
 - Test locations of imported calls such as `test(` in CommonJS output now point to the start of the callee, for example `a.spec.ts:3:7` instead of `a.spec.ts:3:11`. This is the same as in ESM.
@@ -93,7 +94,7 @@ export default defineConfig({
 * 🐳 [Docker images](./docker.mdx) now include Node.js 26 instead of Node.js 24, and the latest patch of Chromium on the same branch.
 
 ### Browser Versions
-- Chromium 158.0.8127.2
+- Chromium 158.0.8127.18
 - Mozilla Firefox 159.0
 - WebKit 27.2
 
@@ -119,9 +120,9 @@ const result = await page.webmcp.callTool('add', { a: 2, b: 40 });
 console.log(result.content[0].text); // "42"
 ```
 
-[Playwright MCP](./getting-started-mcp.mdx) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+[Playwright MCP](https://playwright.dev/mcp/introduction) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
 
-[`playwright-cli`](./getting-started-cli.mdx) exposes them as well:
+[`playwright-cli`](https://playwright.dev/agent-cli/introduction) exposes them as well:
 
 ```bash
 playwright-cli webmcp-list
@@ -159,7 +160,7 @@ export default defineConfig({
 - New [style](/api/class-screencast.mdx#screencast-show-actions-option-style) option takes CSS declarations for the `point` marker, the target `highlight` and the action `title`. It replaces the `fontSize` option, which is now deprecated.
 - The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
 - Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better quality.
-- All video options are also available in [Playwright MCP](./getting-started-mcp.mdx) and [`playwright-cli`](./getting-started-cli.mdx).
+- All video options are also available in [Playwright MCP](https://playwright.dev/mcp/introduction) and [`playwright-cli`](https://playwright.dev/agent-cli/introduction).
 
 ### 🎯 Test runner
 - New [testProject.default](/api/class-testproject.mdx#test-project-default) option keeps a project in the config without running it by default. You can configure every browser you care about, and let a plain `npx playwright test` run just your favourite one:
@@ -460,7 +461,7 @@ export default defineConfig({
 - [page.addInitScript()](/api/class-page.mdx#page-add-init-script) / [browserContext.addInitScript()](/api/class-browsercontext.mdx#browser-context-add-init-script) now accept functions as init-script arguments.
 
 #### Command line & MCP
-- Playwright now bundles the [Playwright MCP](./getting-started-mcp.mdx) server and [`playwright-cli`](./getting-started-cli.mdx), runnable via `npx playwright mcp` and `npx playwright cli`.
+- Playwright now bundles the [Playwright MCP](https://playwright.dev/mcp/introduction) server and [`playwright-cli`](https://playwright.dev/agent-cli/introduction), runnable via `npx playwright mcp` and `npx playwright cli`.
 
 #### Reporters
 - The HTML report's **Merge files** grouping — previously only a UI toggle — can now be enabled from the config with the new `mergeFiles` reporter option:
diff --git a/nodejs/docs/test-retries.mdx b/nodejs/docs/test-retries.mdx
index b647c87475..fb89fd6773 100644
--- a/nodejs/docs/test-retries.mdx
+++ b/nodejs/docs/test-retries.mdx
@@ -130,6 +130,25 @@ test.describe(() => {
 });
 ```
 
+### Conditional retries
+
+The number of retries can depend on the error. Give a list of entries, each with a `count` and an optional `condition` regular expression. After each failed attempt, the largest `count` among the entries whose condition matches an error message of that attempt applies. An entry without a condition always applies.
+
+```js title="playwright.config.ts"
+import { defineConfig } from '@playwright/test';
+
+export default defineConfig({
+  retries: [
+    // Retry any failure once.
+    { count: 1 },
+    // Retry up to three times when the browser or the worker crashed.
+    { count: 3, condition: /Target crashed|worker process exited unexpectedly/ },
+  ],
+});
+```
+
+Worker crashes and timeouts are matched by their error message like any other failure. The latest failed attempt decides: a test that first crashes and then fails on an assertion only gets the retries of the assertion failure.
+
 ## Serial mode
 
 Use [test.describe.serial()](/api/class-test.mdx#test-describe-serial) to group dependent tests to ensure they will always run together and in order. If one of the tests fails, all subsequent tests are skipped. All tests in the group are retried together.
diff --git a/nodejs/docs/test-webserver.mdx b/nodejs/docs/test-webserver.mdx
index 39a63efa71..9347ae684b 100644
--- a/nodejs/docs/test-webserver.mdx
+++ b/nodejs/docs/test-webserver.mdx
@@ -10,6 +10,8 @@ import HTMLCard from '@site/src/components/HTMLCard';
 
 Playwright comes with a `webServer` option in the config file which gives you the ability to launch a local dev server before running your tests. This is ideal for when writing your tests during development and when you don't have a staging or production url to test against.
 
+To start a server only when a particular project runs, configure [testProject.webServer](/api/class-testproject.mdx#test-project-web-server) inside that project. Top-level servers start regardless of the selected projects. Put servers shared by multiple projects at the top level.
+
 ## Configuring a web server
 
 Use the `webServer` property in your Playwright config to launch a development web server during the tests.
diff --git a/python/docs/api/class-frame.mdx b/python/docs/api/class-frame.mdx
index bc639f370c..9494159903 100644
--- a/python/docs/api/class-frame.mdx
+++ b/python/docs/api/class-frame.mdx
@@ -632,6 +632,8 @@ await page.get_by_alt_text("Playwright logo").click()
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/python/docs/api/class-framelocator.mdx b/python/docs/api/class-framelocator.mdx
index 3daf7ad513..e926d0d98e 100644
--- a/python/docs/api/class-framelocator.mdx
+++ b/python/docs/api/class-framelocator.mdx
@@ -203,6 +203,8 @@ await page.get_by_alt_text("Playwright logo").click()
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/python/docs/api/class-locator.mdx b/python/docs/api/class-locator.mdx
index dfac6022a6..b79d53aaa2 100644
--- a/python/docs/api/class-locator.mdx
+++ b/python/docs/api/class-locator.mdx
@@ -1480,6 +1480,8 @@ await page.get_by_alt_text("Playwright logo").click()
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/python/docs/api/class-page.mdx b/python/docs/api/class-page.mdx
index cf5cbbe7c7..2c1f9d856e 100644
--- a/python/docs/api/class-page.mdx
+++ b/python/docs/api/class-page.mdx
@@ -1746,6 +1746,8 @@ await page.get_by_alt_text("Playwright logo").click()
 
 Allows locating input elements by the text of the associated `<label>` or `aria-labelledby` element, or by the `aria-label` attribute.
 
+Associated `<label>` elements are also supported for form-associated custom elements.
+
 **Usage**
 
 For example, this method will find inputs by label "Username" and "Password" in the following DOM:
diff --git a/python/docs/ci.mdx b/python/docs/ci.mdx
index 9d6a5a2478..a48a5bbb99 100644
--- a/python/docs/ci.mdx
+++ b/python/docs/ci.mdx
@@ -82,7 +82,7 @@ jobs:
     name: 'Playwright Tests'
     runs-on: ubuntu-latest
     container:
-      image: mcr.microsoft.com/playwright/python:v1.64.1-noble
+      image: mcr.microsoft.com/playwright/python:v1.65.0-noble
       options: --user 1001
     steps:
       - uses: actions/checkout@v6
@@ -172,7 +172,7 @@ trigger:
 
 pool:
   vmImage: ubuntu-latest
-container: mcr.microsoft.com/playwright/python:v1.64.1-noble
+container: mcr.microsoft.com/playwright/python:v1.65.0-noble
 
 steps:
 - task: UsePythonVersion@0
@@ -196,7 +196,7 @@ Running Playwright on CircleCI is very similar to running on GitHub Actions. In
 executors:
   pw-noble-development:
     docker:
-      - image: mcr.microsoft.com/playwright/python:v1.64.1-noble
+      - image: mcr.microsoft.com/playwright/python:v1.65.0-noble
 ```
 
 Note: When using the docker agent definition, you are specifying the resource class of where playwright runs to the 'medium' tier [here](https://circleci.com/docs/configuration-reference?#docker-execution-environment). The default behavior of Playwright is to set the number of workers to the detected core count (2 in the case of the medium tier). Overriding the number of workers to greater than this number will cause unnecessary timeouts and failures.
@@ -207,7 +207,7 @@ Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](
 
 ```groovy
 pipeline {
-   agent { docker { image 'mcr.microsoft.com/playwright/python:v1.64.1-noble' } }
+   agent { docker { image 'mcr.microsoft.com/playwright/python:v1.65.0-noble' } }
    stages {
       stage('e2e-tests') {
          steps {
@@ -224,7 +224,7 @@ pipeline {
 Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.mdx)).
 
 ```yml
-image: mcr.microsoft.com/playwright/python:v1.64.1-noble
+image: mcr.microsoft.com/playwright/python:v1.65.0-noble
 ```
 
 ### GitLab CI
@@ -237,7 +237,7 @@ stages:
 
 tests:
   stage: test
-  image: mcr.microsoft.com/playwright/python:v1.64.1-noble
+  image: mcr.microsoft.com/playwright/python:v1.65.0-noble
   script:
   ...
 ```
diff --git a/python/docs/clock.mdx b/python/docs/clock.mdx
index f74a1d6e21..7cb4afbf9a 100644
--- a/python/docs/clock.mdx
+++ b/python/docs/clock.mdx
@@ -227,7 +227,7 @@ await page.get_by_role("button").click()
 await page.clock.fast_forward("05:00")
 
 # Check that the user was logged out automatically.
-await expect(page.getByText("You have been logged out due to inactivity.")).toBeVisible()
+await expect(page.get_by_text("You have been logged out due to inactivity.")).to_be_visible()
 ```
 
 </TabItem>
diff --git a/python/docs/docker.mdx b/python/docs/docker.mdx
index 27f5cfc0b2..79d3c391a5 100644
--- a/python/docs/docker.mdx
+++ b/python/docs/docker.mdx
@@ -22,7 +22,7 @@ This Docker image is intended to be used for testing and development purposes on
 ### Pull the image
 
 ```bash
-docker pull mcr.microsoft.com/playwright/python:v1.64.1-noble
+docker pull mcr.microsoft.com/playwright/python:v1.65.0-noble
 ```
 
 ### Run the image
@@ -34,7 +34,7 @@ By default, the Docker image will use the `root` user to run the browsers. This
 On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers.
 
 ```bash
-docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.64.1-noble /bin/bash
+docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.65.0-noble /bin/bash
 ```
 
 #### Crawling and scraping
@@ -42,7 +42,7 @@ docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.64.1-noble
 On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it.
 
 ```bash
-docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/python:v1.64.1-noble /bin/bash
+docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/python:v1.65.0-noble /bin/bash
 ```
 
 [`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/main/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions:
@@ -82,7 +82,7 @@ You can run Playwright Server in Docker while keeping your tests running on the
 Start the Playwright Server in Docker:
 
 ```bash
-docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.64.1-noble /bin/sh -c "npx -y playwright@1.64.1 run-server --port 3000 --host 0.0.0.0"
+docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.65.0-noble /bin/sh -c "npx -y playwright@1.65.0 run-server --port 3000 --host 0.0.0.0"
 ```
 
 #### Connecting to the Server
@@ -122,7 +122,7 @@ async with async_playwright() as p:
 If you need to access local servers from within the Docker container:
 
 ```bash
-docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.64.1-noble /bin/sh -c "npx -y playwright@1.64.1 run-server --port 3000 --host 0.0.0.0"
+docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.65.0-noble /bin/sh -c "npx -y playwright@1.65.0 run-server --port 3000 --host 0.0.0.0"
 ```
 
 This makes `hostmachine` point to the host's localhost. Your tests should use `hostmachine` instead of `localhost` when accessing local servers.
@@ -138,7 +138,7 @@ For Docker and GitHub Codespaces environments, you can view and generate tests u
 
 ```json
 {
-  "image": "mcr.microsoft.com/playwright:v1.64.1-noble",
+  "image": "mcr.microsoft.com/playwright:v1.65.0-noble",
   "forwardPorts": [6080],
   "features": {
     "desktop-lite": {
@@ -155,10 +155,10 @@ Once this is enabled you can open the port specified in a new browser tab and yo
 See [all available image tags].
 
 We currently publish images with the following tags:
-- `:v1.64.1` - Playwright v1.64.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
-- `:v1.64.1-noble` - Playwright v1.64.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
-- `:v1.64.1-jammy` - Playwright v1.64.1 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish).
-- `:v1.64.1-resolute` - Playwright v1.64.1 release docker image based on Ubuntu 26.04 LTS (Resolute Raccoon).
+- `:v1.65.0` - Playwright v1.65.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
+- `:v1.65.0-noble` - Playwright v1.65.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat).
+- `:v1.65.0-jammy` - Playwright v1.65.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish).
+- `:v1.65.0-resolute` - Playwright v1.65.0 release docker image based on Ubuntu 26.04 LTS (Resolute Raccoon).
 
 :::note
 
@@ -183,7 +183,7 @@ To run Playwright inside Docker, you need to have Python, [Playwright browsers](
 ```Dockerfile
 FROM python:3.12-bookworm
 
-RUN pip install playwright==@1.64.1 && \
+RUN pip install playwright==@1.65.0 && \
     playwright install --with-deps
 ```
 
diff --git a/python/docs/getting-started-cli.mdx b/python/docs/getting-started-cli.mdx
deleted file mode 100644
index 9da3f45a5c..0000000000
--- a/python/docs/getting-started-cli.mdx
+++ /dev/null
@@ -1,409 +0,0 @@
----
-id: getting-started-cli
-title: "Coding agents"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-Playwright comes with `playwright-cli`, a command-line interface for browser automation designed for coding agents. It provides token-efficient browser control through concise CLI commands and installable skills, making it ideal for agents that need to balance browser automation with large codebases and reasoning within limited context windows.
-
-### `playwright-cli` vs Playwright MCP
-- **`playwright-cli`** is best for **coding agents** (Claude Code, GitHub Copilot, etc.) that favor token-efficient, skill-based workflows. CLI commands avoid loading large tool schemas and verbose accessibility trees into the model context.
-- **MCP** is best for specialized agentic loops that benefit from persistent state and iterative reasoning over page structure, such as exploratory automation or long-running autonomous workflows. See the [MCP getting started guide](./getting-started-mcp.mdx).
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- A coding agent: Claude Code, GitHub Copilot, or similar
-
-## Installation
-
-Install `playwright-cli` globally:
-
-```bash
-npm install -g @playwright/cli@latest
-playwright-cli --help
-```
-
-Alternatively, install `@playwright/cli` as a local dependency and use `npx`:
-
-```bash
-npm install -D @playwright/cli@latest
-npx playwright cli --help
-```
-
-### Installing skills
-
-Coding agents like Claude Code and GitHub Copilot can use locally installed skills for richer context about available commands:
-
-```bash
-playwright-cli install --skills
-```
-
-To share the skills across all your projects, add the `-g` flag to install them into your home directory (`~/.claude/skills` or, with `--skills=agents`, `~/.agents/skills`):
-
-```bash
-playwright-cli install --skills -g
-```
-
-### Skills-less operation
-
-You can also point your agent at the CLI directly and let it discover commands on its own:
-
-```txt
-Test the "add todo" flow on https://demo.playwright.dev/todomvc using playwright-cli.
-Check playwright-cli --help for available commands.
-```
-
-## First Steps
-
-### Interactive demo
-
-Try asking your coding agent:
-
-```txt
-Use playwright skills to test https://demo.playwright.dev/todomvc/.
-Take screenshots for all successful and failing scenarios.
-```
-
-### Manual walkthrough
-
-You can also run commands manually to see how the CLI works:
-
-```bash
-playwright-cli open https://demo.playwright.dev/todomvc/ --headed
-playwright-cli type "Buy groceries"
-playwright-cli press Enter
-playwright-cli type "Water flowers"
-playwright-cli press Enter
-playwright-cli check e21
-playwright-cli screenshot
-```
-
-After each command, the CLI outputs a snapshot of the current page state:
-
-```txt
-### Page
-- Page URL: https://demo.playwright.dev/todomvc/#/
-- Page Title: React • TodoMVC
-### Snapshot
-[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
-```
-
-## Core Commands
-
-### Interacting with pages
-
-```bash
-playwright-cli open [url]               # open browser, optionally navigate to url
-playwright-cli goto <url>               # navigate to a url
-playwright-cli click <ref> [button]     # click an element
-playwright-cli type <text>              # type text into editable element
-playwright-cli fill <ref> <text>        # fill text into editable element
-playwright-cli select <ref> <value>     # select an option in a dropdown
-playwright-cli check <ref>              # check a checkbox or radio button
-playwright-cli uncheck <ref>            # uncheck a checkbox
-playwright-cli hover <ref>              # hover over element
-playwright-cli drag <startRef> <endRef> # drag and drop between elements
-playwright-cli upload <files...>        # upload one or multiple files
-playwright-cli close                    # close the page
-```
-
-### Targeting elements
-
-Use element refs from snapshots to target elements:
-
-```bash
-playwright-cli snapshot                 # get snapshot with element refs
-playwright-cli click e15                # click using a ref
-```
-
-You can also use CSS or role selectors:
-
-```bash
-playwright-cli click "#main > button.submit"
-playwright-cli click "role=button[name=Submit]"
-playwright-cli click "#footer >> role=button[name=Submit]"
-```
-
-### Screenshots and snapshots
-
-```bash
-playwright-cli snapshot                 # capture page snapshot
-playwright-cli snapshot --filename=f    # save snapshot to specific file
-playwright-cli screenshot               # screenshot of the current page
-playwright-cli screenshot [ref]         # screenshot of a specific element
-playwright-cli screenshot --filename=f  # save with specific filename
-playwright-cli screenshot --hires       # capture using device pixels
-playwright-cli pdf                      # save page as PDF
-```
-
-### Navigation
-
-```bash
-playwright-cli go-back                  # go back
-playwright-cli go-forward               # go forward
-playwright-cli reload                   # reload the page
-```
-
-### Keyboard and mouse
-
-```bash
-playwright-cli press <key>              # press a key (e.g. Enter, ArrowLeft)
-playwright-cli keydown <key>            # key down
-playwright-cli keyup <key>              # key up
-playwright-cli mousemove <x> <y>        # move mouse
-playwright-cli mousedown [button]       # mouse button down
-playwright-cli mouseup [button]         # mouse button up
-playwright-cli mousewheel <dx> <dy>     # scroll
-```
-
-### Tabs
-
-```bash
-playwright-cli tab-list                 # list all tabs
-playwright-cli tab-new [url]            # create a new tab
-playwright-cli tab-select <index>       # select a tab
-playwright-cli tab-close [index]        # close a tab
-```
-
-### Network
-
-```bash
-playwright-cli requests                 # list network requests since page load
-playwright-cli request <num>            # show full details of a single request
-playwright-cli route <pattern> [opts]   # mock network requests
-playwright-cli route-list               # list active routes
-playwright-cli unroute [pattern]        # remove routes
-```
-
-### Storage
-
-```bash
-playwright-cli state-save [filename]    # save storage state (cookies, localStorage)
-playwright-cli state-load <filename>    # load storage state
-
-# Cookies
-playwright-cli cookie-list [--domain]   # list cookies
-playwright-cli cookie-get <name>        # get a cookie
-playwright-cli cookie-set <name> <val>  # set a cookie
-playwright-cli cookie-delete <name>     # delete a cookie
-playwright-cli cookie-clear             # clear all cookies
-
-# localStorage
-playwright-cli localstorage-list        # list entries
-playwright-cli localstorage-get <key>   # get value
-playwright-cli localstorage-set <k> <v> # set value
-playwright-cli localstorage-delete <k>  # delete entry
-playwright-cli localstorage-clear       # clear all
-```
-
-### DevTools
-
-```bash
-playwright-cli console [min-level]      # list console messages
-playwright-cli eval <func> [ref]        # evaluate JavaScript on page
-playwright-cli run-code <code>          # run Playwright code snippet
-playwright-cli tracing-start            # start trace recording
-playwright-cli tracing-stop             # stop trace recording
-playwright-cli video-start              # start video recording
-playwright-cli video-chapter <title>    # add chapter marker to video
-playwright-cli video-stop --filename=f  # stop video recording
-```
-
-### WebMCP
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools a page registers are listed at the top of the page snapshot, and they can be called directly:
-
-```bash
-playwright-cli webmcp-list                       # list tools registered by the page
-playwright-cli webmcp-call <name> [--params]     # call one, passing a JSON object
-```
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Sessions
-
-The CLI keeps the browser profile in memory by default — cookies and storage state are preserved between calls within a session but lost when the browser closes. Use `--persistent` to save the profile to disk.
-
-### Named sessions
-
-Run multiple browser instances for different projects:
-
-```bash
-playwright-cli open https://playwright.dev
-playwright-cli -s=example open https://example.com --persistent
-playwright-cli list                     # list all sessions
-```
-
-You can configure your coding agent to use a specific session:
-
-```bash
-PLAYWRIGHT_CLI_SESSION=todo-app claude .
-```
-
-### Session management
-
-```bash
-playwright-cli list                     # list all sessions
-playwright-cli close-all                # close all browsers
-playwright-cli kill-all                 # forcefully kill all browser processes
-playwright-cli -s=name delete-data      # delete user data for a named session
-```
-
-A headless session shuts itself down after an hour without commands, so a session an agent forgot to close does not keep a browser running. Headed and attached browsers are never closed automatically. Change the timeout with `open --idle-timeout=<ms>` or `timeouts.idle` in the config file, and pass `0` to disable it.
-
-## Monitoring
-
-Use `playwright-cli show` to open a visual dashboard for observing and controlling all running browser sessions:
-
-```bash
-playwright-cli show
-```
-
-The dashboard provides:
-- **Session grid** — all active sessions grouped by workspace, each with a live screencast preview, session name, current URL, and page title. Click any session to zoom in.
-- **Session detail** — a live view of the selected session with tab bar, navigation controls, and full remote control. Click into the viewport to take over mouse and keyboard; press Escape to release.
-
-## Configuration
-
-### Headed mode
-
-The CLI runs headless by default. To see the browser:
-
-```bash
-playwright-cli open https://playwright.dev --headed
-```
-
-### Browser selection
-
-```bash
-playwright-cli open --browser=chrome    # use specific browser
-playwright-cli open --browser=firefox
-playwright-cli open --browser=webkit
-playwright-cli open --browser=msedge
-```
-
-### Configuration file
-
-For advanced settings, use a JSON config file:
-
-```bash
-playwright-cli --config path/to/config.json open example.com
-```
-
-The CLI also loads `.playwright/cli.config.json` automatically if present. The config file supports browser options, context options, network rules, timeouts, and more. Run `playwright-cli --help` for the full list of options.
-
-### Browser extension
-
-Connect to your existing browser tabs instead of launching a new browser:
-
-```bash
-playwright-cli attach --extension
-```
-
-This requires the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md) to be installed.
-
-## Quick Reference
-
-| Action                    | Command                                             |
-| ------------------------- | --------------------------------------------------- |
-| **Install CLI**           | `npm install -g @playwright/cli@latest`             |
-| **Install skills**        | `playwright-cli install --skills`                   |
-| **Open a page**           | `playwright-cli open https://example.com`           |
-| **Click an element**      | `playwright-cli click e15`                          |
-| **Type text**             | `playwright-cli type "hello world"`                 |
-| **Take a screenshot**     | `playwright-cli screenshot`                         |
-| **Get page snapshot**     | `playwright-cli snapshot`                           |
-| **Run headed**            | `playwright-cli open https://example.com --headed`  |
-| **Use Firefox**           | `playwright-cli open --browser=firefox`             |
-| **Monitor sessions**      | `playwright-cli show`                               |
-| **List page WebMCP tools** | `playwright-cli webmcp-list`                       |
-
-## What's Next
-- [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
-- [Run your tests on CI](./ci-intro.mdx)
-- [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Disposable]: /api/class-disposable.mdx "Disposable"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[Error]: /api/class-error.mdx "Error"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[Any]: https://docs.python.org/3/library/typing.html#typing.Any "Any"
-[bool]: https://docs.python.org/3/library/stdtypes.html "bool"
-[bytes]: https://docs.python.org/3/library/stdtypes.html#bytes "bytes"
-[Callable]: https://docs.python.org/3/library/typing.html#typing.Callable "Callable"
-[EventContextManager]: https://docs.python.org/3/reference/datamodel.html#context-managers "Event context manager"
-[EventEmitter]: https://pyee.readthedocs.io/en/latest/#pyee.BaseEventEmitter "EventEmitter"
-[Exception]: https://docs.python.org/3/library/exceptions.html#Exception "Exception"
-[Dict]: https://docs.python.org/3/library/typing.html#typing.Dict "Dict"
-[float]: https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex "float"
-[int]: https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex "int"
-[List]: https://docs.python.org/3/library/typing.html#typing.List "List"
-[NoneType]: https://docs.python.org/3/library/constants.html#None "None"
-[Pattern]: https://docs.python.org/3/library/re.html "Pattern"
-[URL]: https://en.wikipedia.org/wiki/URL "URL"
-[pathlib.Path]: https://realpython.com/python-pathlib/ "pathlib.Path"
-[str]: https://docs.python.org/3/library/stdtypes.html#text-sequence-type-str "str"
-[Union]: https://docs.python.org/3/library/typing.html#typing.Union "Union"
-[datetime]: https://docs.python.org/3/library/datetime.html#datetime.datetime "datetime"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/python/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/python/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-python/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/python/docs/getting-started-mcp.mdx b/python/docs/getting-started-mcp.mdx
deleted file mode 100644
index 11eeca46bd..0000000000
--- a/python/docs/getting-started-mcp.mdx
+++ /dev/null
@@ -1,336 +0,0 @@
----
-id: getting-started-mcp
-title: "Playwright MCP"
----
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-import HTMLCard from '@site/src/components/HTMLCard';
-
-## Introduction
-
-The Playwright MCP server provides browser automation capabilities through the [Model Context Protocol](https://modelcontextprotocol.io), enabling LLMs to interact with web pages using structured accessibility snapshots. It works with VS Code, Cursor, Windsurf, Claude Desktop, and any other MCP client — no vision models required.
-
-## Prerequisites
-
-Before you begin, make sure you have the following installed:
-- [Node.js](https://nodejs.org/) 20 or newer
-- An MCP client: VS Code, Cursor, Windsurf, Claude Code, Claude Desktop, or similar
-
-## Getting Started
-
-### Installation
-
-Add the Playwright MCP server to your client using the standard configuration:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest"
-      ]
-    }
-  }
-}
-```
-
-#### VS Code
-
-Click one of the buttons below to install directly:
-
-[<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code" />](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D) [<img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5" />](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522%2540playwright%252Fmcp%2540latest%2522%255D%257D)
-
-Or install via the VS Code CLI:
-
-```bash
-code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'
-```
-
-#### Cursor
-
-[<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />](https://cursor.com/en/install-mcp?name=Playwright&config=eyJjb21tYW5kIjoibnB4IEBwbGF5d3JpZ2h0L21jcEBsYXRlc3QifQ%3D%3D)
-
-Or go to `Cursor Settings` → `MCP` → `Add new MCP Server` and use command type with `npx @playwright/mcp@latest`.
-
-#### Claude Code
-
-```bash
-claude mcp add playwright npx @playwright/mcp@latest
-```
-
-#### Claude Desktop
-
-Follow the MCP install [guide](https://modelcontextprotocol.io/quickstart/user) and use the standard config above.
-
-#### Other clients
-
-The standard configuration works with most MCP clients, including Windsurf, Cline, Goose, Kiro, Codex, Copilot CLI, and others. Consult your client's MCP documentation for where to place the config.
-
-### First interaction
-
-Once the server is connected, ask your AI assistant to interact with a web page:
-
-```txt
-Navigate to https://demo.playwright.dev/todomvc and add a few todo items.
-```
-
-The assistant will use Playwright MCP tools to open the browser, navigate to the page, and interact with elements — all through structured accessibility snapshots rather than screenshots.
-
-## Core Features
-
-### Accessibility snapshots
-
-Playwright MCP operates on the page's accessibility tree, not pixels. When a tool runs, it returns a structured snapshot showing the page elements, their roles, and text content. The LLM uses element references from these snapshots to interact with the page:
-
-```txt
-- heading "todos" [level=1]
-- textbox "What needs to be done?" [ref=e5]
-- listitem:
-  - checkbox "Toggle Todo" [ref=e10]
-  - text: "Buy groceries"
-```
-
-The LLM reads this snapshot and uses `ref=e5` to type into the textbox or `ref=e10` to check the checkbox.
-
-### Interacting with pages
-
-Playwright MCP provides tools for all common browser interactions:
--   **Navigation**: Open URLs, go back/forward, reload pages.
--   **Clicking and typing**: Click elements, type text, fill forms, select dropdowns.
--   **Screenshots**: Capture the current page or specific elements for visual verification.
--   **Keyboard and mouse**: Press keys, hover, drag and drop.
--   **Dialogs**: Accept or dismiss browser dialogs.
--   **Tabs**: Create, close, and switch between browser tabs.
-
-### Running Playwright code
-
-For complex interactions that go beyond individual tool calls, use the `browser_run_code_unsafe` tool to execute Playwright scripts directly. This tool runs arbitrary JavaScript in the Playwright server process and is RCE-equivalent — only enable it for trusted MCP clients:
-
-```txt
-Run this Playwright code to verify the todo count:
-async (page) => {
-  const count = await page.getByTestId('todo-count').textContent();
-  return count;
-}
-```
-
-### Network monitoring and mocking
-
-Inspect network traffic and mock API responses:
--   **View network requests**: List all requests made since page load.
--   **Mock routes**: Set up URL pattern matching to return custom responses.
--   **Console messages**: Access browser console output for debugging.
-
-### Storage state
-
-Save and restore browser state including cookies and localStorage:
--   **Save state**: Persist authentication and session data to a file.
--   **Restore state**: Load previously saved state into a new session.
--   **Cookie management**: List, get, set, and delete individual cookies.
-
-### WebMCP tools
-
-Pages can register their own tools for agents through the experimental [WebMCP](https://webmachinelearning.github.io/webmcp/) API. The tools of the current tab are offered as MCP tools named `webmcp_<tool>`.
-
-Tool names, descriptions, schemas and results are provided by the page, so treat them as untrusted input.
-
-## Configuration
-
-### Headed mode
-
-By default, Playwright MCP runs the browser in headed mode so you can see what's happening. To run headless:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--headless"
-      ]
-    }
-  }
-}
-```
-
-### Browser selection
-
-Choose which browser to use:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--browser=firefox"
-      ]
-    }
-  }
-}
-```
-
-Supported values: `chrome`, `firefox`, `webkit`, `msedge`.
-
-### User profile
-
-Playwright MCP supports three profile modes:
--   **Persistent (default)**: Login state and cookies are preserved between sessions. The profile is stored in `ms-playwright/mcp-{channel}-{workspace-hash}` in your platform's cache directory, so different projects get separate profiles automatically. Override with `--user-data-dir`.
--   **Isolated**: Each session starts fresh. Pass `--isolated` to enable. You can load initial state with `--storage-state`.
--   **Browser extension**: Connect to your existing browser tabs with the [Playwright Extension](https://github.com/microsoft/playwright/blob/main/packages/extension/README.md). Pass `--extension` to enable.
-
-### Idle timeout
-
-A page that keeps animating or rendering costs CPU for as long as the browser is open, and an agent session can last hours. A headless browser launched by the server is therefore closed after an hour without tool calls. Headed browsers, and browsers attached over `--cdp-endpoint` or `--extension`, are never closed automatically. Pass `--idle-timeout` to set the timeout in milliseconds for any mode, or `0` to disable it:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": [
-        "@playwright/mcp@latest",
-        "--idle-timeout=300000"
-      ]
-    }
-  }
-}
-```
-
-When no tool call has completed for that long, the browser is closed, headed or not, the same way as if you had closed it by hand. The next tool call launches a new browser, so the agent navigates again. The timer never fires while a tool call is running.
--   With `--isolated`, cookies and storage kept in memory are lost on an idle close. Use the persistent profile or `--storage-state` to keep them. Each client has its own timer: the context of an idle client is closed while other clients keep working, and the browser is closed once no client has a context.
--   With `--cdp-endpoint` or `--extension`, the browser is not owned by the server, so there is no default timeout, and an explicit one only disconnects from it, leaving its pages open. With `--extension`, the next tool call goes through the connect flow again.
--   With `--shared-browser-context`, the timer spans all clients: a client that is idle while others keep working keeps its tabs and state, and the shared browser is closed only once every client has been idle for the timeout.
-
-### Configuration file
-
-For advanced configuration, use a JSON config file:
-
-```bash
-npx @playwright/mcp@latest --config path/to/config.json
-```
-
-The config file supports browser options, context options, network rules, timeouts, and more. See the [Playwright MCP repository](https://github.com/microsoft/playwright-mcp/blob/main/config.d.ts) for the full schema.
-
-### Standalone server
-
-When running a headed browser on a system without a display or from IDE worker processes, start the MCP server separately with HTTP transport:
-
-```bash
-npx @playwright/mcp@latest --port 8931
-```
-
-HTTP sessions use a five-second heartbeat timeout. If your MCP client or proxy does not answer server-initiated pings, set `PLAYWRIGHT_MCP_PING_TIMEOUT_MS` to a longer timeout in milliseconds. Set it to `0` to disable the heartbeat.
-
-Then point your MCP client to the HTTP endpoint:
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "url": "http://localhost:8931/mcp"
-    }
-  }
-}
-```
-
-## Quick Reference
-
-| Action                    | How to do it                                                  |
-| ------------------------- | ------------------------------------------------------------- |
-| **Install server**        | Add standard config to your MCP client                        |
-| **Navigate to a page**    | Ask: "Go to https://example.com"                              |
-| **Click an element**      | Ask: "Click the Submit button"                                |
-| **Fill a form**           | Ask: "Fill in the email field with test@example.com"          |
-| **Take a screenshot**     | Ask: "Take a screenshot of the page"                          |
-| **Run Playwright code**   | Ask: "Run this Playwright code: ..."                          |
-| **Mock an API**           | Ask: "Mock the /api/users endpoint to return ..."             |
-| **Use headed mode**       | Default. Pass `--headless` to disable                         |
-| **Choose a browser**      | Pass `--browser=firefox` in args                              |
-
-## What's Next
--   [Write tests using web-first assertions, page fixtures, and locators](./writing-tests.mdx)
--   [Run your tests on CI](./ci-intro.mdx)
--   [Learn more about the Trace Viewer](./trace-viewer.mdx)
-
-
-[APIRequest]: /api/class-apirequest.mdx "APIRequest"
-[APIRequestContext]: /api/class-apirequestcontext.mdx "APIRequestContext"
-[APIResponse]: /api/class-apiresponse.mdx "APIResponse"
-[APIResponseAssertions]: /api/class-apiresponseassertions.mdx "APIResponseAssertions"
-[Browser]: /api/class-browser.mdx "Browser"
-[BrowserContext]: /api/class-browsercontext.mdx "BrowserContext"
-[BrowserType]: /api/class-browsertype.mdx "BrowserType"
-[CDPSession]: /api/class-cdpsession.mdx "CDPSession"
-[Clock]: /api/class-clock.mdx "Clock"
-[ConsoleMessage]: /api/class-consolemessage.mdx "ConsoleMessage"
-[Credentials]: /api/class-credentials.mdx "Credentials"
-[Debugger]: /api/class-debugger.mdx "Debugger"
-[Dialog]: /api/class-dialog.mdx "Dialog"
-[Disposable]: /api/class-disposable.mdx "Disposable"
-[Download]: /api/class-download.mdx "Download"
-[ElementHandle]: /api/class-elementhandle.mdx "ElementHandle"
-[Error]: /api/class-error.mdx "Error"
-[FileChooser]: /api/class-filechooser.mdx "FileChooser"
-[FormData]: /api/class-formdata.mdx "FormData"
-[Frame]: /api/class-frame.mdx "Frame"
-[FrameLocator]: /api/class-framelocator.mdx "FrameLocator"
-[JSHandle]: /api/class-jshandle.mdx "JSHandle"
-[Keyboard]: /api/class-keyboard.mdx "Keyboard"
-[Locator]: /api/class-locator.mdx "Locator"
-[LocatorAssertions]: /api/class-locatorassertions.mdx "LocatorAssertions"
-[Mouse]: /api/class-mouse.mdx "Mouse"
-[Page]: /api/class-page.mdx "Page"
-[PageAssertions]: /api/class-pageassertions.mdx "PageAssertions"
-[Playwright]: /api/class-playwright.mdx "Playwright"
-[Request]: /api/class-request.mdx "Request"
-[Response]: /api/class-response.mdx "Response"
-[Route]: /api/class-route.mdx "Route"
-[Screencast]: /api/class-screencast.mdx "Screencast"
-[Selectors]: /api/class-selectors.mdx "Selectors"
-[TimeoutError]: /api/class-timeouterror.mdx "TimeoutError"
-[Touchscreen]: /api/class-touchscreen.mdx "Touchscreen"
-[Tracing]: /api/class-tracing.mdx "Tracing"
-[Video]: /api/class-video.mdx "Video"
-[WebError]: /api/class-weberror.mdx "WebError"
-[WebMCP]: /api/class-webmcp.mdx "WebMCP"
-[WebSocket]: /api/class-websocket.mdx "WebSocket"
-[WebSocketRoute]: /api/class-websocketroute.mdx "WebSocketRoute"
-[WebStorage]: /api/class-webstorage.mdx "WebStorage"
-[Worker]: /api/class-worker.mdx "Worker"
-[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
-[EvaluationArgument]: /evaluating.mdx#evaluation-argument "EvaluationArgument"
-[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
-[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
-[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
-[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
-[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
-[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
-[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
-[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
-
-[Any]: https://docs.python.org/3/library/typing.html#typing.Any "Any"
-[bool]: https://docs.python.org/3/library/stdtypes.html "bool"
-[bytes]: https://docs.python.org/3/library/stdtypes.html#bytes "bytes"
-[Callable]: https://docs.python.org/3/library/typing.html#typing.Callable "Callable"
-[EventContextManager]: https://docs.python.org/3/reference/datamodel.html#context-managers "Event context manager"
-[EventEmitter]: https://pyee.readthedocs.io/en/latest/#pyee.BaseEventEmitter "EventEmitter"
-[Exception]: https://docs.python.org/3/library/exceptions.html#Exception "Exception"
-[Dict]: https://docs.python.org/3/library/typing.html#typing.Dict "Dict"
-[float]: https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex "float"
-[int]: https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex "int"
-[List]: https://docs.python.org/3/library/typing.html#typing.List "List"
-[NoneType]: https://docs.python.org/3/library/constants.html#None "None"
-[Pattern]: https://docs.python.org/3/library/re.html "Pattern"
-[URL]: https://en.wikipedia.org/wiki/URL "URL"
-[pathlib.Path]: https://realpython.com/python-pathlib/ "pathlib.Path"
-[str]: https://docs.python.org/3/library/stdtypes.html#text-sequence-type-str "str"
-[Union]: https://docs.python.org/3/library/typing.html#typing.Union "Union"
-[datetime]: https://docs.python.org/3/library/datetime.html#datetime.datetime "datetime"
-
-[all available image tags]: https://mcr.microsoft.com/en-us/product/playwright/python/about "all available image tags"
-[Microsoft Artifact Registry]: https://mcr.microsoft.com/en-us/product/playwright/python/about "Microsoft Artifact Registry"
-[Dockerfile.noble]: https://github.com/microsoft/playwright-python/blob/main/utils/docker/Dockerfile.noble "Dockerfile.noble"
diff --git a/python/docs/release-notes.mdx b/python/docs/release-notes.mdx
index 0368875062..6a6a0bb973 100644
--- a/python/docs/release-notes.mdx
+++ b/python/docs/release-notes.mdx
@@ -32,7 +32,7 @@ print(str(normalized))
 - String values of the `params` option in [APIRequestContext] requests are now appended to the query that the URL already has, instead of replacing it.
 
 ### Browser Versions
-- Chromium 158.0.8127.2
+- Chromium 158.0.8127.18
 - Mozilla Firefox 159.0
 - WebKit 27.2
 
@@ -58,9 +58,9 @@ result = page.webmcp.call_tool("add", {"a": 2, "b": 40})
 print(result["content"][0]["text"])  # "42"
 ```
 
-[Playwright MCP](./getting-started-mcp.mdx) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
+[Playwright MCP](https://playwright.dev/mcp/introduction) also supports WebMCP by default, with page-defined tools offered to the agent as `webmcp_<tool>`. Pass `--no-webmcp` to opt out.
 
-[`playwright-cli`](./getting-started-cli.mdx) exposes them as well:
+[`playwright-cli`](https://playwright.dev/agent-cli/introduction) exposes them as well:
 
 ```bash
 playwright-cli webmcp-list
@@ -86,7 +86,7 @@ page.screencast.show_actions(
 - New [style](/api/class-screencast.mdx#screencast-show-actions-option-style) option takes CSS declarations for the `point` marker, the target `highlight` and the action `title`. It replaces the `font_size` option, which is now deprecated.
 - The cursor stays visible at the last action point, survives navigations and travels along a natural, eased path.
 - Videos are encoded with VP9 instead of VP8, which takes less CPU and produces smaller files of the same or better quality.
-- All video options are also available in [Playwright MCP](./getting-started-mcp.mdx) and [`playwright-cli`](./getting-started-cli.mdx).
+- All video options are also available in [Playwright MCP](https://playwright.dev/mcp/introduction) and [`playwright-cli`](https://playwright.dev/agent-cli/introduction).
 
 ### 🪆 Locator.within()
 
@@ -1056,7 +1056,7 @@ This version was also tested against the following stable channels:
   locator = page.locator("iframe[name='embedded']")
   # ...
   frame_locator = locator.content_frame
-  frame_locator.getByRole("button").click()
+  frame_locator.get_by_role("button").click()
   ```
   
 - New method [frame_locator.owner](/api/class-framelocator.mdx#frame-locator-owner) converts a [FrameLocator] object to a [Locator]. This can be useful when you have a [FrameLocator] object obtained somewhere, and later on would like to interact with the `iframe` element.