Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 3 additions & 4 deletions dotnet/docs/actionability.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Here is the complete list of actionability checks performed for each action:
| [Locator.ScreenshotAsync()](/api/class-locator.mdx#locator-screenshot) | Yes | Yes | - | - | - | - |
| [Locator.FillAsync()](/api/class-locator.mdx#locator-fill) | Yes | - | - | Yes | Yes | Yes |
| [Locator.ClearAsync()](/api/class-locator.mdx#locator-clear) | Yes | - | - | Yes | Yes | Yes |
| [Locator.SelectOptionAsync()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | - |
| [Locator.SelectOptionAsync()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | Yes |
| [Locator.SelectTextAsync()](/api/class-locator.mdx#locator-select-text) | Yes | - | - | - | - | - |
| [Locator.ScrollIntoViewIfNeededAsync()](/api/class-locator.mdx#locator-scroll-into-view-if-needed) | - | Yes | - | - | - | - |
| [Locator.BlurAsync()](/api/class-locator.mdx#locator-blur) | - | - | - | - | - | - |
Expand Down Expand Up @@ -111,11 +111,10 @@ Element is **readonly** when:

## Not Inert

Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with, and are excluded from the accessibility tree.
Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with.

Element is **inert** when:
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element;
- a modal `<dialog>` is open, and the element is not a part of that dialog.
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element.

## Receives Events

Expand Down
2 changes: 1 addition & 1 deletion dotnet/docs/api/class-browsertype.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ var page = defaultContext.Pages[0];
Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely upon the file system being the same between Playwright and the Browser.
- `NoDefaults` [bool]? *(optional)* <font size="2">Added in: v1.60</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-connect-over-cdp-option-no-defaults"/><a href="#browser-type-connect-over-cdp-option-no-defaults" class="list-anchor">#</a>

When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, [AcceptDownloads](/api/class-browser.mdx#browser-new-context-option-accept-downloads) is left at the browser's setting, focus emulation is not enabled, and media emulation options (such as [ColorScheme](/api/class-browser.mdx#browser-new-context-option-color-scheme), [ReducedMotion](/api/class-browser.mdx#browser-new-context-option-reduced-motion), [ForcedColors](/api/class-browser.mdx#browser-new-context-option-forced-colors), and [Contrast](/api/class-browser.mdx#browser-new-context-option-contrast)) are not applied. Useful when attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New contexts created via [Browser.NewContextAsync()](/api/class-browser.mdx#browser-new-context) are not affected. Defaults to `false`.
When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, [AcceptDownloads](/api/class-browser.mdx#browser-new-context-option-accept-downloads) and font families are left at the browser's settings, focus emulation is not enabled, and media emulation options (such as [ColorScheme](/api/class-browser.mdx#browser-new-context-option-color-scheme), [ReducedMotion](/api/class-browser.mdx#browser-new-context-option-reduced-motion), [ForcedColors](/api/class-browser.mdx#browser-new-context-option-forced-colors), and [Contrast](/api/class-browser.mdx#browser-new-context-option-contrast)) are not applied. Useful when attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New contexts created via [Browser.NewContextAsync()](/api/class-browser.mdx#browser-new-context) are not affected. Defaults to `false`.
- `SlowMo` [float]? *(optional)* <font size="2">Added in: v1.11</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-connect-over-cdp-option-slow-mo"/><a href="#browser-type-connect-over-cdp-option-slow-mo" class="list-anchor">#</a>

Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on. Defaults to 0.
Expand Down
2 changes: 1 addition & 1 deletion dotnet/docs/api/class-locator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ Below is the HTML markup and the respective ARIA snapshot:
```

An AI-optimized snapshot, controlled by [Mode](/api/class-locator.mdx#locator-aria-snapshot-option-mode), is different from a default snapshot:
1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when no elements match. 3. Includes snapshots of `<iframe>`s inside the target.
1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when no elements match. 3. Includes snapshots of `<iframe>`s inside the target. 4. Can omit names that repeat printed descendants, such as a heading containing a link. Names that identify dialogs, landmarks, groups, tables and table headers are retained.

---

Expand Down
2 changes: 1 addition & 1 deletion dotnet/docs/auth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ Web apps use cookie-based or token-based authentication, where authenticated sta

Cookies, local storage, IndexedDB and virtual WebAuthn credentials (passkeys) can be used across different browsers. They depend on your application's authentication model which may require some combination of cookies, local storage, IndexedDB or passkeys.

The following code snippet retrieves state from an authenticated context and creates a new context with that state.
The following code snippet retrieves state from an authenticated context and creates a new context with that state. If your application stores authentication tokens in IndexedDB, such as Firebase Authentication, enable [IndexedDB](/api/class-browsercontext.mdx#browser-context-storage-state-option-indexed-db) when saving the state. IndexedDB is not included in the snapshot by default.

```csharp
// Save storage state into the file.
Expand Down
7 changes: 3 additions & 4 deletions java/docs/actionability.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Here is the complete list of actionability checks performed for each action:
| [Locator.screenshot()](/api/class-locator.mdx#locator-screenshot) | Yes | Yes | - | - | - | - |
| [Locator.fill()](/api/class-locator.mdx#locator-fill) | Yes | - | - | Yes | Yes | Yes |
| [Locator.clear()](/api/class-locator.mdx#locator-clear) | Yes | - | - | Yes | Yes | Yes |
| [Locator.selectOption()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | - |
| [Locator.selectOption()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | Yes |
| [Locator.selectText()](/api/class-locator.mdx#locator-select-text) | Yes | - | - | - | - | - |
| [Locator.scrollIntoViewIfNeeded()](/api/class-locator.mdx#locator-scroll-into-view-if-needed) | - | Yes | - | - | - | - |
| [Locator.blur()](/api/class-locator.mdx#locator-blur) | - | - | - | - | - | - |
Expand Down Expand Up @@ -111,11 +111,10 @@ Element is **readonly** when:

## Not Inert

Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with, and are excluded from the accessibility tree.
Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with.

Element is **inert** when:
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element;
- a modal `<dialog>` is open, and the element is not a part of that dialog.
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element.

## Receives Events

Expand Down
2 changes: 1 addition & 1 deletion java/docs/api/class-browsertype.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ Page page = defaultContext.pages().get(0);
Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely upon the file system being the same between Playwright and the Browser.
- `setNoDefaults` [boolean] *(optional)* <font size="2">Added in: v1.60</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-connect-over-cdp-option-no-defaults"/><a href="#browser-type-connect-over-cdp-option-no-defaults" class="list-anchor">#</a>

When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, [setAcceptDownloads](/api/class-browser.mdx#browser-new-context-option-accept-downloads) is left at the browser's setting, focus emulation is not enabled, and media emulation options (such as [setColorScheme](/api/class-browser.mdx#browser-new-context-option-color-scheme), [setReducedMotion](/api/class-browser.mdx#browser-new-context-option-reduced-motion), [setForcedColors](/api/class-browser.mdx#browser-new-context-option-forced-colors), and [setContrast](/api/class-browser.mdx#browser-new-context-option-contrast)) are not applied. Useful when attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New contexts created via [Browser.newContext()](/api/class-browser.mdx#browser-new-context) are not affected. Defaults to `false`.
When true, Playwright will not apply its default overrides to the existing default browser context. Specifically, [setAcceptDownloads](/api/class-browser.mdx#browser-new-context-option-accept-downloads) and font families are left at the browser's settings, focus emulation is not enabled, and media emulation options (such as [setColorScheme](/api/class-browser.mdx#browser-new-context-option-color-scheme), [setReducedMotion](/api/class-browser.mdx#browser-new-context-option-reduced-motion), [setForcedColors](/api/class-browser.mdx#browser-new-context-option-forced-colors), and [setContrast](/api/class-browser.mdx#browser-new-context-option-contrast)) are not applied. Useful when attaching to a user's daily-driver browser where these overrides would interfere with existing browser state. New contexts created via [Browser.newContext()](/api/class-browser.mdx#browser-new-context) are not affected. Defaults to `false`.
- `setSlowMo` [double] *(optional)* <font size="2">Added in: v1.11</font><a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="browser-type-connect-over-cdp-option-slow-mo"/><a href="#browser-type-connect-over-cdp-option-slow-mo" class="list-anchor">#</a>

Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on. Defaults to 0.
Expand Down
2 changes: 1 addition & 1 deletion java/docs/api/class-locator.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ Below is the HTML markup and the respective ARIA snapshot:
```

An AI-optimized snapshot, controlled by [setMode](/api/class-locator.mdx#locator-aria-snapshot-option-mode), is different from a default snapshot:
1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when no elements match. 3. Includes snapshots of `<iframe>`s inside the target.
1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when no elements match. 3. Includes snapshots of `<iframe>`s inside the target. 4. Can omit names that repeat printed descendants, such as a heading containing a link. Names that identify dialogs, landmarks, groups, tables and table headers are retained.

---

Expand Down
2 changes: 1 addition & 1 deletion java/docs/auth.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Web apps use cookie-based or token-based authentication, where authenticated sta

Cookies, local storage, IndexedDB and virtual WebAuthn credentials (passkeys) can be used across different browsers. They depend on your application's authentication model which may require some combination of cookies, local storage, IndexedDB or passkeys.

The following code snippet retrieves state from an authenticated context and creates a new context with that state.
The following code snippet retrieves state from an authenticated context and creates a new context with that state. If your application stores authentication tokens in IndexedDB, such as Firebase Authentication, enable [setIndexedDB](/api/class-browsercontext.mdx#browser-context-storage-state-option-indexed-db) when saving the state. IndexedDB is not included in the snapshot by default.

```java
// Save storage state into the file.
Expand Down
7 changes: 3 additions & 4 deletions nodejs/docs/actionability.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Here is the complete list of actionability checks performed for each action:
| [locator.screenshot()](/api/class-locator.mdx#locator-screenshot) | Yes | Yes | - | - | - | - |
| [locator.fill()](/api/class-locator.mdx#locator-fill) | Yes | - | - | Yes | Yes | Yes |
| [locator.clear()](/api/class-locator.mdx#locator-clear) | Yes | - | - | Yes | Yes | Yes |
| [locator.selectOption()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | - |
| [locator.selectOption()](/api/class-locator.mdx#locator-select-option) | Yes | - | - | Yes | - | Yes |
| [locator.selectText()](/api/class-locator.mdx#locator-select-text) | Yes | - | - | - | - | - |
| [locator.scrollIntoViewIfNeeded()](/api/class-locator.mdx#locator-scroll-into-view-if-needed) | - | Yes | - | - | - | - |
| [locator.blur()](/api/class-locator.mdx#locator-blur) | - | - | - | - | - | - |
Expand Down Expand Up @@ -111,11 +111,10 @@ Element is **readonly** when:

## Not Inert

Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with, and are excluded from the accessibility tree.
Element is considered not inert when it is **not** a part of an inert subtree. Inert elements cannot be focused, clicked or otherwise interacted with.

Element is **inert** when:
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element;
- a modal `<dialog>` is open, and the element is not a part of that dialog.
- it is an element with the [`inert`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/inert) attribute, or a descendant of such an element.

## Receives Events

Expand Down
7 changes: 7 additions & 0 deletions nodejs/docs/api/class-androiddevice.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -273,6 +273,13 @@ 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).
- `locatorOmitHidden` [boolean] *(optional)*<a aria-hidden="true" tabIndex="-1" class="list-anchor-link" id="android-device-launch-browser-option-locator-omit-hidden"/><a href="#android-device-launch-browser-option-locator-omit-hidden" class="list-anchor">#</a>

Whether locators omit hidden elements by default. Defaults to `false`. If set to `true`, each locator is resolved as if [locator.visible()](/api/class-locator.mdx#locator-visible) were appended: only the final matched element is checked for [visibility](../actionability.mdx#visible), not its intermediate ancestors. This affects actions, assertions, counts and element evaluation, but not selector-based methods such as [page.$()](/api/class-page.mdx#page-query-selector).

Pass `omitHidden: false` when creating a locator to opt out. The override is preserved by `filter()`, `first()`, `last()`, `nth()`, `and()`, `or()` and `describe()`. Creating a descendant locator uses the context default again, unless an override is supplied for that descendant. Explicit visibility filters are never removed. Role locators still apply their accessibility matching rules; use `getByRole(..., { includeHidden: true, omitHidden: false })` to include hidden elements when this context option is enabled.

With `true`, hidden elements are treated as missing by `toBeHidden()` and `waitFor({ state: 'hidden' })`. To check attachment of a hidden element, create the locator with `omitHidden: false`.
- `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]
Expand Down
Loading
Loading