Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
docs: Update outdated links & broken anchors (#35181)
Chrisdeaa714ab4e8
diff --git a/docs/src/accessibility-testing-java.md b/docs/src/accessibility-testing-java.mdindex 13f9c4e3e4..f0363672a2 100644--- a/docs/src/accessibility-testing-java.md+++ b/docs/src/accessibility-testing-java.md@@ -107,7 +107,7 @@ AxeResults accessibilityScanResults = new AxeBuilder(page)assertEquals(Collections.emptyList(), accessibilityScanResults.getViolations());```-You can find a complete listing of the rule tags axe-core supports in [the "Axe-core Tags" section of the axe API documentation](https://www.deque.com/axe/core-documentation/api-documentation/#axe-core-tags).+You can find a complete listing of the rule tags axe-core supports in [the "Axe-core Tags" section of the axe API documentation](https://www.deque.com/axe/core-documentation/api-documentation/#axecore-tags).## Handling known issuesdiff --git a/docs/src/accessibility-testing-js.md b/docs/src/accessibility-testing-js.mdindex 65db5ae55c..ea38e19e9f 100644--- a/docs/src/accessibility-testing-js.md+++ b/docs/src/accessibility-testing-js.md@@ -113,7 +113,7 @@ test('should not have any automatically detectable WCAG A or AA violations', asy});```-You can find a complete listing of the rule tags axe-core supports in [the "Axe-core Tags" section of the axe API documentation](https://www.deque.com/axe/core-documentation/api-documentation/#axe-core-tags).+You can find a complete listing of the rule tags axe-core supports in [the "Axe-core Tags" section of the axe API documentation](https://www.deque.com/axe/core-documentation/api-documentation/#axecore-tags).## Handling known issuesdiff --git a/docs/src/api-testing-python.md b/docs/src/api-testing-python.mdindex 68f2626111..ebfb5760a0 100644--- a/docs/src/api-testing-python.md+++ b/docs/src/api-testing-python.md@@ -114,7 +114,7 @@ def test_should_create_feature_request(api_request_context: APIRequestContext) -### Setup and teardown-These tests assume that repository exists. You probably want to create a new one before running tests and delete it afterwards. Use a [session fixture](https://docs.pytest.org/en/stable/fixture.html#fixture-scopes) for that. The part before `yield` is the before all and after is the after all.+These tests assume that repository exists. You probably want to create a new one before running tests and delete it afterwards. Use a [session fixture](https://docs.pytest.org/en/stable/how-to/fixtures.html#fixture-scopes) for that. The part before `yield` is the before all and after is the after all.```python# ...diff --git a/docs/src/api/class-accessibility.md b/docs/src/api/class-accessibility.mdindex 6164bb05dc..e5efc9b21f 100644--- a/docs/src/api/class-accessibility.md+++ b/docs/src/api/class-accessibility.md@@ -22,7 +22,7 @@ assistive technologies themselves. By default, Playwright tries to approximate t* deprecated: This method is deprecated. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe.- returns: <[null]|[Object]>- - `role` <[string]> The [role](https://www.w3.org/TR/wai-aria/#usage_intro).+ - `role` <[string]> The [role](https://www.w3.org/TR/wai-aria/#usage).- `name` <[string]> A human readable name for the node.- `value` <[string]|[float]> The current value of the node, if applicable.- `description` <[string]> An additional human readable description of the node, if applicable.diff --git a/docs/src/api/class-browsertype.md b/docs/src/api/class-browsertype.mdindex 29c323f002..8ab2e63f8b 100644--- a/docs/src/api/class-browsertype.md+++ b/docs/src/api/class-browsertype.md@@ -326,7 +326,7 @@ this context will automatically close the browser.Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for[Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and-[Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile).+[Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile).Note that Chromium's user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty string touse a temporary directory instead.diff --git a/docs/src/api/params.md b/docs/src/api/params.mdindex fd548c9c41..4c49370044 100644--- a/docs/src/api/params.md+++ b/docs/src/api/params.md@@ -1061,7 +1061,7 @@ Close the browser process on SIGHUP. Defaults to `true`.Whether to run browser in headless mode. More details for[Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and-[Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+[Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the[`option: BrowserType.launch.devtools`] option is `true`.## js-python-browser-option-firefoxuserprefsdiff --git a/docs/src/aria-snapshots.md b/docs/src/aria-snapshots.mdindex 2bbfd8a654..394da5bf76 100644--- a/docs/src/aria-snapshots.md+++ b/docs/src/aria-snapshots.md@@ -149,7 +149,7 @@ Each accessible element in the tree is represented as a YAML node:as `checked`, `disabled`, `expanded`, `level`, `pressed`, or `selected`.These values are derived from ARIA attributes or calculated based on HTML semantics. To inspect the accessibility tree-structure of a page, use the [Chrome DevTools Accessibility Pane](https://developer.chrome.com/docs/devtools/accessibility/reference#pane).+structure of a page, use the [Chrome DevTools Accessibility Tab](https://developer.chrome.com/docs/devtools/accessibility/reference#tab).## Snapshot matchingdiff --git a/docs/src/browsers.md b/docs/src/browsers.mdindex 4b13b35c4c..f0131b7d24 100644--- a/docs/src/browsers.md+++ b/docs/src/browsers.md@@ -520,7 +520,7 @@ with sync_playwright() as p:# Channel can be "chrome", "msedge", "chrome-beta", "msedge-beta" or "msedge-dev".browser = p.chromium.launch(channel="msedge")page = browser.new_page()- page.goto("http://playwright.dev")+ page.goto("https://playwright.dev")print(page.title())browser.close()```diff --git a/docs/src/ci-intro.md b/docs/src/ci-intro.mdindex ed7e2208fc..13313ba89c 100644--- a/docs/src/ci-intro.md+++ b/docs/src/ci-intro.md@@ -291,7 +291,7 @@ Downloading the HTML report as a zip file is not very convenient. However, we ca- `AZCOPY_SPA_CLIENT_SECRET`- `AZCOPY_TENANT_ID`- For a detailed guide on how to authorize a service principal using a client secret, refer to [this Microsoft documentation](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-authorize-azure-active-directory#authorize-a-service-principal-by-using-a-client-secret-1).+ For a detailed guide on how to authorize a service principal using a client secret, refer to [this Microsoft documentation](https://learn.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-authorize-azure-active-directory#authorize-a-service-principal-by-using-a-client-secret).1. Add a step that uploads the HTML report to Azure Storage.```yaml title=".github/workflows/playwright.yml"@@ -312,7 +312,7 @@ Downloading the HTML report as a zip file is not very convenient. However, we caThe contents of the `$web` storage container can be accessed from a browser by using the [public URL](https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-static-website-how-to?tabs=azure-portal#portal-find-url) of the website.:::note-This step will not work for pull requests created from a forked repository because such workflow [doesn't have access to the secrets](https://docs.github.com/en/actions/security-guides/encrypted-secrets#using-encrypted-secrets-in-a-workflow).+This step will not work for pull requests created from a forked repository because such workflow [doesn't have access to the secrets](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions#using-secrets-in-a-workflow).:::diff --git a/docs/src/intro-java.md b/docs/src/intro-java.mdindex 9a245c6a6d..13dff6f868 100644--- a/docs/src/intro-java.md+++ b/docs/src/intro-java.md@@ -32,7 +32,7 @@ public class App {try (Playwright playwright = Playwright.create()) {Browser browser = playwright.chromium().launch();Page page = browser.newPage();- page.navigate("http://playwright.dev");+ page.navigate("https://playwright.dev");System.out.println(page.title());}}diff --git a/docs/src/library-python.md b/docs/src/library-python.mdindex f9063ea13a..605cb9798f 100644--- a/docs/src/library-python.md+++ b/docs/src/library-python.md@@ -38,7 +38,7 @@ from playwright.sync_api import sync_playwrightwith sync_playwright() as p:browser = p.chromium.launch()page = browser.new_page()- page.goto("http://playwright.dev")+ page.goto("https://playwright.dev")print(page.title())browser.close()```@@ -53,7 +53,7 @@ async def main():async with async_playwright() as p:browser = await p.chromium.launch()page = await browser.new_page()- await page.goto("http://playwright.dev")+ await page.goto("https://playwright.dev")print(await page.title())await browser.close()diff --git a/docs/src/test-runners-python.md b/docs/src/test-runners-python.mdindex 22c9e420dd..a959735013 100644--- a/docs/src/test-runners-python.md+++ b/docs/src/test-runners-python.md@@ -263,7 +263,7 @@ See the [guides for CI providers](./ci.md) to deploy your tests to CI/CD.## Async FixturesIf you want to use async fixtures, you can use the [`pytest-playwright-asyncio`](https://pypi.org/project/pytest-playwright-asyncio/) plugin.-Make sure to use `pytest-asyncio>=0.24.0` and make your tests use of [`loop_scope=session`](https://pytest-asyncio.readthedocs.io/en/latest/how-to-guides/run_session_tests_in_same_loop.html).+Make sure to use `pytest-asyncio>=0.24.0` and make your tests use of [`loop_scope=session`](https://pytest-asyncio.readthedocs.io/en/stable/how-to-guides/run_session_tests_in_same_loop.html).```pythonimport pytestdiff --git a/docs/src/writing-tests-java.md b/docs/src/writing-tests-java.mdindex 7a05aca292..ed12d93915 100644--- a/docs/src/writing-tests-java.md+++ b/docs/src/writing-tests-java.md@@ -23,7 +23,7 @@ public class App {try (Playwright playwright = Playwright.create()) {Browser browser = playwright.chromium().launch();Page page = browser.newPage();- page.navigate("http://playwright.dev");+ page.navigate("https://playwright.dev");// Expect a title "to contain" a substring.assertThat(page).hasTitle(Pattern.compile("Playwright"));diff --git a/packages/playwright-client/types/types.d.ts b/packages/playwright-client/types/types.d.tsindex 2eb9af4926..1573308b56 100644--- a/packages/playwright-client/types/types.d.ts+++ b/packages/playwright-client/types/types.d.ts@@ -14712,9 +14712,9 @@ export interface BrowserType<Unused = {}> {* and returns the only context. Closing this context will automatically close the browser.* @param userDataDir Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for* [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's- * user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty- * string to use a temporary directory instead.+ * [Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile). Note that Chromium's user data+ * directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty string to use+ * a temporary directory instead.* @param options*/launchPersistentContext(userDataDir: string, options?: {@@ -14933,7 +14933,7 @@ export interface BrowserType<Unused = {}> {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/@@ -15327,7 +15327,7 @@ export interface BrowserType<Unused = {}> {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/@@ -21702,7 +21702,7 @@ export interface LaunchOptions {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.tsindex 2eb9af4926..1573308b56 100644--- a/packages/playwright-core/types/types.d.ts+++ b/packages/playwright-core/types/types.d.ts@@ -14712,9 +14712,9 @@ export interface BrowserType<Unused = {}> {* and returns the only context. Closing this context will automatically close the browser.* @param userDataDir Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for* [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md#introduction) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile). Note that Chromium's- * user data directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty- * string to use a temporary directory instead.+ * [Firefox](https://wiki.mozilla.org/Firefox/CommandLineOptions#User_profile). Note that Chromium's user data+ * directory is the **parent** directory of the "Profile Path" seen at `chrome://version`. Pass an empty string to use+ * a temporary directory instead.* @param options*/launchPersistentContext(userDataDir: string, options?: {@@ -14933,7 +14933,7 @@ export interface BrowserType<Unused = {}> {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/@@ -15327,7 +15327,7 @@ export interface BrowserType<Unused = {}> {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/@@ -21702,7 +21702,7 @@ export interface LaunchOptions {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*/diff --git a/packages/playwright/types/test.d.ts b/packages/playwright/types/test.d.tsindex 54725c0bc7..b3e0cb8595 100644--- a/packages/playwright/types/test.d.ts+++ b/packages/playwright/types/test.d.ts@@ -6144,7 +6144,7 @@ export interface PlaywrightWorkerOptions {/*** Whether to run browser in headless mode. More details for* [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and- * [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Headless_mode). Defaults to `true` unless the+ * [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the* [`devtools`](https://playwright.dev/docs/api/class-browsertype#browser-type-launch-option-devtools) option is* `true`.*