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: fix incorrect defaults and broken samples in guides (#42611)
Ashraf Alia89041ef7872
diff --git a/docs/src/api/params.md b/docs/src/api/params.mdindex 02bd0483dc..5b6be94663 100644--- a/docs/src/api/params.md+++ b/docs/src/api/params.md@@ -1216,7 +1216,7 @@ Logger sink for Playwright logging.## browser-option-timeout- `timeout` <[float]>-Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0` to+Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0` todisable timeout.## browser-option-artifactsdirdiff --git a/docs/src/dialogs.md b/docs/src/dialogs.mdindex 0aaa69aade..9cffd0bcfd 100644--- a/docs/src/dialogs.md+++ b/docs/src/dialogs.md@@ -23,7 +23,7 @@ page.getByRole(AriaRole.BUTTON).click();```python asyncpage.on("dialog", lambda dialog: dialog.accept())-await page.get_by_role("button".click())+await page.get_by_role("button").click()``````python sync@@ -105,7 +105,7 @@ async def handle_dialog(dialog):assert dialog.type == 'beforeunload'await dialog.dismiss()-page.on('dialog', lambda: handle_dialog)+page.on('dialog', handle_dialog)await page.close(run_before_unload=True)```@@ -114,7 +114,7 @@ def handle_dialog(dialog):assert dialog.type == 'beforeunload'dialog.dismiss()-page.on('dialog', lambda: handle_dialog)+page.on('dialog', handle_dialog)page.close(run_before_unload=True)```diff --git a/docs/src/handles.md b/docs/src/handles.mdindex 1a1f368267..e170b60045 100644--- a/docs/src/handles.md+++ b/docs/src/handles.md@@ -168,7 +168,7 @@ int length = (int) page.evaluate("a => a.length", myArrayHandle);Map<String, Object> arg = new HashMap<>();arg.put("myArray", myArrayHandle);arg.put("newElement", 2);-page.evaluate("arg => arg.myArray.add(arg.newElement)", arg);+page.evaluate("arg => arg.myArray.push(arg.newElement)", arg);// Release the object when it is no longer needed.myArrayHandle.dispose();@@ -225,7 +225,7 @@ var myArrayHandle = await page.EvaluateHandleAsync(@"() => {var length = await page.EvaluateAsync<int>("a => a.length", myArrayHandle);// Add one more element to the array using the handle-await page.EvaluateAsync("arg => arg.myArray.add(arg.newElement)",+await page.EvaluateAsync("arg => arg.myArray.push(arg.newElement)",new { myArray = myArrayHandle, newElement = 2 });// Release the object when it is no longer needed.diff --git a/docs/src/input.md b/docs/src/input.mdindex 3b9d48d3ae..c7c834d579 100644--- a/docs/src/input.md+++ b/docs/src/input.md@@ -75,7 +75,7 @@ await page.GetByRole(AriaRole.Textbox).FillAsync("Peter");await page.GetByLabel("Birth date").FillAsync("2020-02-02");// Time input-await page.GetByLabel("Appointment time").FillAsync("13-15");+await page.GetByLabel("Appointment time").FillAsync("13:15");// Local datetime inputawait page.GetByLabel("Local time").FillAsync("2020-03-02T05:15");diff --git a/docs/src/service-workers-js-python.md b/docs/src/service-workers-js-python.mdindex 2721e5800c..842b6e10ff 100644--- a/docs/src/service-workers-js-python.md+++ b/docs/src/service-workers-js-python.md@@ -32,7 +32,7 @@ import { defineConfig } from '@playwright/test';export default defineConfig({use: {- serviceWorkers: 'allow'+ serviceWorkers: 'block'},});```diff --git a/docs/src/test-configuration-js.md b/docs/src/test-configuration-js.mdindex 6af98ffcc8..e97bdcfd79 100644--- a/docs/src/test-configuration-js.md+++ b/docs/src/test-configuration-js.md@@ -91,7 +91,7 @@ export default defineConfig({| Option | Description || :- | :- || [`property: TestConfig.testIgnore`] | Glob patterns or regular expressions that should be ignored when looking for the test files. For example, `'*test-assets'` |-| [`property: TestConfig.testMatch`] | Glob patterns or regular expressions that match test files. For example, `'*todo-tests/*.spec.ts'`. By default, Playwright runs <code>.*(test|spec)\.(js|ts|mjs)</code> files. |+| [`property: TestConfig.testMatch`] | Glob patterns or regular expressions that match test files. For example, `'*todo-tests/*.spec.ts'`. By default, Playwright runs <code>**/*.@(spec|test).?(c|m)[jt]s?(x)</code> files. |## Advanced Configurationdiff --git a/docs/src/test-parallel-js.md b/docs/src/test-parallel-js.mdindex 59ea2228bc..452dfd9b22 100644--- a/docs/src/test-parallel-js.md+++ b/docs/src/test-parallel-js.md@@ -243,7 +243,7 @@ export default defineConfig({## Worker index and parallel index-Each worker process is assigned two ids: a unique worker index that starts with 1, and a parallel index that is between `0` and `workers - 1`. When a worker is restarted, for example after a failure, the new worker process has the same `parallelIndex` and a new `workerIndex`.+Each worker process is assigned two ids: a unique worker index that starts with 0, and a parallel index that is between `0` and `workers - 1`. When a worker is restarted, for example after a failure, the new worker process has the same `parallelIndex` and a new `workerIndex`.You can read an index from environment variables `process.env.TEST_WORKER_INDEX` and `process.env.TEST_PARALLEL_INDEX`, or access them through [`property: TestInfo.workerIndex`] and [`property: TestInfo.parallelIndex`].diff --git a/docs/src/test-reporters-js.md b/docs/src/test-reporters-js.mdindex b0c32ad2ea..e58017f6c5 100644--- a/docs/src/test-reporters-js.md+++ b/docs/src/test-reporters-js.md@@ -347,7 +347,7 @@ Blob report supports following configuration options and environment variables:| Environment Variable Name | Reporter Config Option| Description | Default|---|---|---|---|| `PLAYWRIGHT_BLOB_OUTPUT_DIR` | `outputDir` | Directory to save the output. Existing content is deleted before writing the new report. | `blob-report`-| `PLAYWRIGHT_BLOB_OUTPUT_NAME` | `fileName` | Report file name. | `report-<project>-<hash>-<shard_number>.zip`+| `PLAYWRIGHT_BLOB_OUTPUT_NAME` | `fileName` | Report file name. | `report-<hash>-<shard_number>.zip`| `PLAYWRIGHT_BLOB_OUTPUT_FILE` | `outputFile` | Full path to the output file. If defined, `outputDir` and `fileName` will be ignored. | `undefined`### JSON reporterdiff --git a/packages/playwright-client/types/types.d.ts b/packages/playwright-client/types/types.d.tsindex b14199edc3..d585c5a189 100644--- a/packages/playwright-client/types/types.d.ts+++ b/packages/playwright-client/types/types.d.ts@@ -17991,7 +17991,7 @@ export interface BrowserType<Unused = {}> {strictSelectors?: boolean;/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;@@ -18190,7 +18190,7 @@ export interface BrowserType<Unused = {}> {};/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;@@ -25498,7 +25498,7 @@ export interface LaunchOptions {slowMo?: number;/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.tsindex b14199edc3..d585c5a189 100644--- a/packages/playwright-core/types/types.d.ts+++ b/packages/playwright-core/types/types.d.ts@@ -17991,7 +17991,7 @@ export interface BrowserType<Unused = {}> {strictSelectors?: boolean;/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;@@ -18190,7 +18190,7 @@ export interface BrowserType<Unused = {}> {};/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;@@ -25498,7 +25498,7 @@ export interface LaunchOptions {slowMo?: number;/**- * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `30000` (30 seconds). Pass `0`+ * Maximum time in milliseconds to wait for the browser instance to start. Defaults to `180000` (3 minutes). Pass `0`* to disable timeout.*/timeout?: number;