diff --git a/dotnet/docs/api/class-consolemessage.mdx b/dotnet/docs/api/class-consolemessage.mdx index 5c26fa33df..b58a1775ee 100644 --- a/dotnet/docs/api/class-consolemessage.mdx +++ b/dotnet/docs/api/class-consolemessage.mdx @@ -102,6 +102,23 @@ ConsoleMessage.Text --- +### Timestamp {#console-message-timestamp} + +Added in: v1.59consoleMessage.Timestamp + +The timestamp of the console message in milliseconds since the Unix epoch. + +**Usage** + +```csharp +ConsoleMessage.Timestamp +``` + +**Returns** +- [float]# + +--- + ### Type {#console-message-type} Added before v1.9consoleMessage.Type diff --git a/dotnet/docs/aria-snapshots.mdx b/dotnet/docs/aria-snapshots.mdx index c87364b6f6..5acd541b69 100644 --- a/dotnet/docs/aria-snapshots.mdx +++ b/dotnet/docs/aria-snapshots.mdx @@ -17,8 +17,10 @@ await page.GotoAsync("https://playwright.dev/"); await Expect(page.Locator("banner")).ToMatchAriaSnapshotAsync(@" - banner: - heading ""Playwright enables reliable end-to-end testing for modern web apps."" [level=1] - - link ""Get started"" - - link ""Star microsoft/playwright on GitHub"" + - link ""Get started"": + - /url: /docs/intro + - link ""Star microsoft/playwright on GitHub"": + - /url: https://github.com/microsoft/playwright - link /[\\d]+k\\+ stargazers on GitHub/ "); ``` @@ -117,9 +119,7 @@ You can perform partial matches on nodes by omitting attributes or accessible na ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button ``` @@ -133,9 +133,7 @@ For elements with ARIA attributes like `checked` or `disabled`, omitting these a ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - checkbox ``` @@ -153,9 +151,7 @@ Similarly, you can partially match children in lists or groups by omitting speci ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -174,9 +170,7 @@ By default, a template containing the subset of children will be matched: ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -194,9 +188,9 @@ The `/children` property can be used to control how child elements are matched: ``` -*aria snapshot will fail due to Feature C not being in the template* +Following snapshot will fail due to Feature C not being in the template: -```yaml +```yaml title="aria snapshot" - list - /children: equal - listitem: Feature A @@ -211,9 +205,7 @@ Regular expressions allow flexible matching for elements with dynamic or variabl

Issues 12

``` -*aria snapshot with regular expression* - -```yaml +```yaml title="aria snapshot" - heading /Issues \d+/ ``` @@ -251,9 +243,7 @@ Headings can include a `level` attribute indicating their heading level.

Subtitle

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - heading "Title" [level=1] - heading "Subtitle" [level=2] ``` @@ -266,9 +256,7 @@ Standalone or descriptive text elements appear as text nodes.
Sample accessible name
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - text: Sample accessible name ``` @@ -280,24 +268,32 @@ Multiline text, such as paragraphs, is normalized in the aria snapshot.

Line 1
Line 2

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - paragraph: Line 1 Line 2 ``` ### Links -Links display their text or composed content from pseudo-elements. +Links display their text or composed content from pseudo-elements. The link’s destination may be matched using the `/url` property. ```html Read more about Accessibility ``` -*aria snapshot* +```yaml title="aria snapshot" +- link "Read more about Accessibility": + - /url: "#more-info" +``` -```yaml -- link "Read more about Accessibility" +The value of `/url` may also be a regular expression: + +```html +YouTube channel +``` + +```yaml title="aria snapshot" +- link: + - /url: /https://www.youtube.com/channel/.*/ ``` ### Text boxes @@ -308,9 +304,7 @@ Input elements of type `text` show their `value` attribute content. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - textbox: Enter your name ``` @@ -325,9 +319,7 @@ Ordered and unordered lists include their list items. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - list "Main Features": - listitem: Feature 1 - listitem: Feature 2 @@ -344,9 +336,7 @@ Groups capture nested elements, such as `
` elements with summary conten
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - group: Summary ``` @@ -360,9 +350,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - checkbox [checked] ``` @@ -372,9 +360,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button "Toggle" [pressed=true] ``` diff --git a/dotnet/docs/release-notes.mdx b/dotnet/docs/release-notes.mdx index 896cf321bc..8c3b993994 100644 --- a/dotnet/docs/release-notes.mdx +++ b/dotnet/docs/release-notes.mdx @@ -155,7 +155,7 @@ This version was also tested against the following stable channels: await Expect(Page.GetByRole(AriaRole.Listitem, new() { Name = "Ship v1.52" })).ToContainClassAsync("done"); ``` -- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and `/url` for links. +- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and [`/url`](./aria-snapshots.mdx#links) for links. ```csharp await Expect(locator).ToMatchAriaSnapshotAsync(@" diff --git a/java/docs/api/class-consolemessage.mdx b/java/docs/api/class-consolemessage.mdx index b614793046..e85adc7a33 100644 --- a/java/docs/api/class-consolemessage.mdx +++ b/java/docs/api/class-consolemessage.mdx @@ -103,6 +103,23 @@ ConsoleMessage.text(); --- +### timestamp {#console-message-timestamp} + +Added in: v1.59consoleMessage.timestamp + +The timestamp of the console message in milliseconds since the Unix epoch. + +**Usage** + +```java +ConsoleMessage.timestamp(); +``` + +**Returns** +- [double]# + +--- + ### type {#console-message-type} Added before v1.9consoleMessage.type diff --git a/java/docs/aria-snapshots.mdx b/java/docs/aria-snapshots.mdx index df92b9876c..cc00021916 100644 --- a/java/docs/aria-snapshots.mdx +++ b/java/docs/aria-snapshots.mdx @@ -17,8 +17,10 @@ page.navigate("https://playwright.dev/"); assertThat(page.locator("banner")).matchesAriaSnapshot(""" - banner: - heading /Playwright enables reliable end-to-end/ [level=1] - - link "Get started" - - link "Star microsoft/playwright on GitHub" + - link "Get started": + - /url: /docs/intro + - link "Star microsoft/playwright on GitHub": + - /url: https://github.com/microsoft/playwright - link /[\\d]+k\\+ stargazers on GitHub/ """); ``` @@ -117,9 +119,7 @@ You can perform partial matches on nodes by omitting attributes or accessible na ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button ``` @@ -133,9 +133,7 @@ For elements with ARIA attributes like `checked` or `disabled`, omitting these a ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - checkbox ``` @@ -153,9 +151,7 @@ Similarly, you can partially match children in lists or groups by omitting speci ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -174,9 +170,7 @@ By default, a template containing the subset of children will be matched: ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -194,9 +188,9 @@ The `/children` property can be used to control how child elements are matched: ``` -*aria snapshot will fail due to Feature C not being in the template* +Following snapshot will fail due to Feature C not being in the template: -```yaml +```yaml title="aria snapshot" - list - /children: equal - listitem: Feature A @@ -211,9 +205,7 @@ Regular expressions allow flexible matching for elements with dynamic or variabl

Issues 12

``` -*aria snapshot with regular expression* - -```yaml +```yaml title="aria snapshot" - heading /Issues \d+/ ``` @@ -251,9 +243,7 @@ Headings can include a `level` attribute indicating their heading level.

Subtitle

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - heading "Title" [level=1] - heading "Subtitle" [level=2] ``` @@ -266,9 +256,7 @@ Standalone or descriptive text elements appear as text nodes.
Sample accessible name
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - text: Sample accessible name ``` @@ -280,24 +268,32 @@ Multiline text, such as paragraphs, is normalized in the aria snapshot.

Line 1
Line 2

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - paragraph: Line 1 Line 2 ``` ### Links -Links display their text or composed content from pseudo-elements. +Links display their text or composed content from pseudo-elements. The link’s destination may be matched using the `/url` property. ```html Read more about Accessibility ``` -*aria snapshot* +```yaml title="aria snapshot" +- link "Read more about Accessibility": + - /url: "#more-info" +``` -```yaml -- link "Read more about Accessibility" +The value of `/url` may also be a regular expression: + +```html +YouTube channel +``` + +```yaml title="aria snapshot" +- link: + - /url: /https://www.youtube.com/channel/.*/ ``` ### Text boxes @@ -308,9 +304,7 @@ Input elements of type `text` show their `value` attribute content. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - textbox: Enter your name ``` @@ -325,9 +319,7 @@ Ordered and unordered lists include their list items. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - list "Main Features": - listitem: Feature 1 - listitem: Feature 2 @@ -344,9 +336,7 @@ Groups capture nested elements, such as `
` elements with summary conten
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - group: Summary ``` @@ -360,9 +350,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - checkbox [checked] ``` @@ -372,9 +360,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button "Toggle" [pressed=true] ``` diff --git a/java/docs/release-notes.mdx b/java/docs/release-notes.mdx index 37a88051f8..3afe664231 100644 --- a/java/docs/release-notes.mdx +++ b/java/docs/release-notes.mdx @@ -153,7 +153,7 @@ This version was also tested against the following stable channels: assertThat(page.getByRole(AriaRole.LISTITEM, new Page.GetByRoleOptions().setName("Ship v1.52"))).containsClass("done"); ``` -- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and `/url` for links. +- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and [`/url`](./aria-snapshots.mdx#links) for links. ```java assertThat(locator).toMatchAriaSnapshot(""" diff --git a/nodejs/docs/api/class-consolemessage.mdx b/nodejs/docs/api/class-consolemessage.mdx index 8a2f614185..68b4bbe095 100644 --- a/nodejs/docs/api/class-consolemessage.mdx +++ b/nodejs/docs/api/class-consolemessage.mdx @@ -111,6 +111,23 @@ consoleMessage.text(); --- +### timestamp {#console-message-timestamp} + +Added in: v1.59consoleMessage.timestamp + +The timestamp of the console message in milliseconds since the Unix epoch. + +**Usage** + +```js +consoleMessage.timestamp(); +``` + +**Returns** +- [number]# + +--- + ### type {#console-message-type} Added before v1.9consoleMessage.type diff --git a/nodejs/docs/aria-snapshots.mdx b/nodejs/docs/aria-snapshots.mdx index 6925c19c29..565b975be0 100644 --- a/nodejs/docs/aria-snapshots.mdx +++ b/nodejs/docs/aria-snapshots.mdx @@ -17,8 +17,10 @@ await page.goto('https://playwright.dev/'); await expect(page.getByRole('banner')).toMatchAriaSnapshot(` - banner: - heading /Playwright enables reliable end-to-end/ [level=1] - - link "Get started" - - link "Star microsoft/playwright on GitHub" + - link "Get started": + - /url: /docs/intro + - link "Star microsoft/playwright on GitHub": + - /url: https://github.com/microsoft/playwright - link /[\\d]+k\\+ stargazers on GitHub/ `); ``` @@ -117,9 +119,7 @@ You can perform partial matches on nodes by omitting attributes or accessible na ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button ``` @@ -133,9 +133,7 @@ For elements with ARIA attributes like `checked` or `disabled`, omitting these a ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - checkbox ``` @@ -153,9 +151,7 @@ Similarly, you can partially match children in lists or groups by omitting speci ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -174,9 +170,7 @@ By default, a template containing the subset of children will be matched: ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -194,9 +188,9 @@ The `/children` property can be used to control how child elements are matched: ``` -*aria snapshot will fail due to Feature C not being in the template* +Following snapshot will fail due to Feature C not being in the template: -```yaml +```yaml title="aria snapshot" - list - /children: equal - listitem: Feature A @@ -211,9 +205,7 @@ Regular expressions allow flexible matching for elements with dynamic or variabl

Issues 12

``` -*aria snapshot with regular expression* - -```yaml +```yaml title="aria snapshot" - heading /Issues \d+/ ``` @@ -306,9 +298,7 @@ Headings can include a `level` attribute indicating their heading level.

Subtitle

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - heading "Title" [level=1] - heading "Subtitle" [level=2] ``` @@ -321,9 +311,7 @@ Standalone or descriptive text elements appear as text nodes.
Sample accessible name
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - text: Sample accessible name ``` @@ -335,24 +323,32 @@ Multiline text, such as paragraphs, is normalized in the aria snapshot.

Line 1
Line 2

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - paragraph: Line 1 Line 2 ``` ### Links -Links display their text or composed content from pseudo-elements. +Links display their text or composed content from pseudo-elements. The link’s destination may be matched using the `/url` property. ```html Read more about Accessibility ``` -*aria snapshot* +```yaml title="aria snapshot" +- link "Read more about Accessibility": + - /url: "#more-info" +``` -```yaml -- link "Read more about Accessibility" +The value of `/url` may also be a regular expression: + +```html +YouTube channel +``` + +```yaml title="aria snapshot" +- link: + - /url: /https://www.youtube.com/channel/.*/ ``` ### Text boxes @@ -363,9 +359,7 @@ Input elements of type `text` show their `value` attribute content. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - textbox: Enter your name ``` @@ -380,9 +374,7 @@ Ordered and unordered lists include their list items. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - list "Main Features": - listitem: Feature 1 - listitem: Feature 2 @@ -399,9 +391,7 @@ Groups capture nested elements, such as `
` elements with summary conten
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - group: Summary ``` @@ -415,9 +405,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - checkbox [checked] ``` @@ -427,9 +415,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button "Toggle" [pressed=true] ``` diff --git a/nodejs/docs/release-notes.mdx b/nodejs/docs/release-notes.mdx index a636c69934..d2f959f783 100644 --- a/nodejs/docs/release-notes.mdx +++ b/nodejs/docs/release-notes.mdx @@ -267,7 +267,7 @@ This version was also tested against the following stable channels: await expect(page.getByRole('listitem', { name: 'Ship v1.52' })).toContainClass('done'); ``` -- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and `/url` for links. +- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and [`/url`](./aria-snapshots.mdx#links) for links. ```ts await expect(locator).toMatchAriaSnapshot(` diff --git a/python/docs/api/class-consolemessage.mdx b/python/docs/api/class-consolemessage.mdx index 4ea4500ed7..ee67154ec2 100644 --- a/python/docs/api/class-consolemessage.mdx +++ b/python/docs/api/class-consolemessage.mdx @@ -141,6 +141,23 @@ console_message.text --- +### timestamp {#console-message-timestamp} + +Added in: v1.59consoleMessage.timestamp + +The timestamp of the console message in milliseconds since the Unix epoch. + +**Usage** + +```python +console_message.timestamp +``` + +**Returns** +- [float]# + +--- + ### type {#console-message-type} Added before v1.9consoleMessage.type diff --git a/python/docs/aria-snapshots.mdx b/python/docs/aria-snapshots.mdx index 7029c7d60e..5fe52216fb 100644 --- a/python/docs/aria-snapshots.mdx +++ b/python/docs/aria-snapshots.mdx @@ -27,8 +27,10 @@ page.goto('https://playwright.dev/') expect(page.query_selector('banner')).to_match_aria_snapshot(""" - banner: - heading /Playwright enables reliable end-to-end/ [level=1] - - link "Get started" - - link "Star microsoft/playwright on GitHub" + - link "Get started": + - /url: /docs/intro + - link "Star microsoft/playwright on GitHub": + - /url: https://github.com/microsoft/playwright - link /[\\d]+k\\+ stargazers on GitHub/ """) ``` @@ -41,8 +43,10 @@ await page.goto('https://playwright.dev/') await expect(page.query_selector('banner')).to_match_aria_snapshot(""" - banner: - heading /Playwright enables reliable end-to-end/ [level=1] - - link "Get started" - - link "Star microsoft/playwright on GitHub" + - link "Get started": + - /url: /docs/intro + - link "Star microsoft/playwright on GitHub": + - /url: https://github.com/microsoft/playwright - link /[\\d]+k\\+ stargazers on GitHub/ """) ``` @@ -166,9 +170,7 @@ You can perform partial matches on nodes by omitting attributes or accessible na ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button ``` @@ -182,9 +184,7 @@ For elements with ARIA attributes like `checked` or `disabled`, omitting these a ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - checkbox ``` @@ -202,9 +202,7 @@ Similarly, you can partially match children in lists or groups by omitting speci ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -223,9 +221,7 @@ By default, a template containing the subset of children will be matched: ``` -*aria snapshot for partial match* - -```yaml +```yaml title="aria snapshot (partial match)" - list - listitem: Feature B ``` @@ -243,9 +239,9 @@ The `/children` property can be used to control how child elements are matched: ``` -*aria snapshot will fail due to Feature C not being in the template* +Following snapshot will fail due to Feature C not being in the template: -```yaml +```yaml title="aria snapshot" - list - /children: equal - listitem: Feature A @@ -260,9 +256,7 @@ Regular expressions allow flexible matching for elements with dynamic or variabl

Issues 12

``` -*aria snapshot with regular expression* - -```yaml +```yaml title="aria snapshot" - heading /Issues \d+/ ``` @@ -321,9 +315,7 @@ Headings can include a `level` attribute indicating their heading level.

Subtitle

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - heading "Title" [level=1] - heading "Subtitle" [level=2] ``` @@ -336,9 +328,7 @@ Standalone or descriptive text elements appear as text nodes.
Sample accessible name
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - text: Sample accessible name ``` @@ -350,24 +340,32 @@ Multiline text, such as paragraphs, is normalized in the aria snapshot.

Line 1
Line 2

``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - paragraph: Line 1 Line 2 ``` ### Links -Links display their text or composed content from pseudo-elements. +Links display their text or composed content from pseudo-elements. The link’s destination may be matched using the `/url` property. ```html Read more about Accessibility ``` -*aria snapshot* +```yaml title="aria snapshot" +- link "Read more about Accessibility": + - /url: "#more-info" +``` -```yaml -- link "Read more about Accessibility" +The value of `/url` may also be a regular expression: + +```html +YouTube channel +``` + +```yaml title="aria snapshot" +- link: + - /url: /https://www.youtube.com/channel/.*/ ``` ### Text boxes @@ -378,9 +376,7 @@ Input elements of type `text` show their `value` attribute content. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - textbox: Enter your name ``` @@ -395,9 +391,7 @@ Ordered and unordered lists include their list items. ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - list "Main Features": - listitem: Feature 1 - listitem: Feature 2 @@ -414,9 +408,7 @@ Groups capture nested elements, such as `
` elements with summary conten
``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - group: Summary ``` @@ -430,9 +422,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - checkbox [checked] ``` @@ -442,9 +432,7 @@ Commonly used ARIA attributes, like `checked`, `disabled`, `expanded`, `level`, ``` -*aria snapshot* - -```yaml +```yaml title="aria snapshot" - button "Toggle" [pressed=true] ``` diff --git a/python/docs/release-notes.mdx b/python/docs/release-notes.mdx index 7c76c78291..dbe7ccce8c 100644 --- a/python/docs/release-notes.mdx +++ b/python/docs/release-notes.mdx @@ -155,7 +155,7 @@ This version was also tested against the following stable channels: expect(page.get_by_role('listitem', name='Ship v1.52')).to_contain_class('done') ``` -- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and `/url` for links. +- [Aria Snapshots](./aria-snapshots.mdx) got two new properties: [`/children`](./aria-snapshots.mdx#strict-matching) for strict matching and [`/url`](./aria-snapshots.mdx#links) for links. ```python expect(locator).to_match_aria_snapshot("""