Skip to content

Commit 7797511

Browse files
mxschmittmxschmitt
authored
chore(roll): roll Playwright to v1.49.0 (#3056)
1 parent 8f071a8 commit 7797511

29 files changed

+699
-116
lines changed

‎README.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@
33

44
| | Linux | macOS | Windows |
55
| :--- | :---: | :---: | :---: |
6-
| Chromium <!-- GEN:chromium-version -->130.0.6723.31<!-- GEN:stop --> | ✅ | ✅ | ✅ |
7-
| WebKit <!-- GEN:webkit-version -->18.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
8-
| Firefox <!-- GEN:firefox-version -->131.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
6+
| Chromium <!-- GEN:chromium-version -->131.0.6778.33<!-- GEN:stop --> | ✅ | ✅ | ✅ |
7+
| WebKit <!-- GEN:webkit-version -->18.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
8+
| Firefox <!-- GEN:firefox-version -->132.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
99

1010
Playwright for .NET is the official language port of [Playwright](https://playwright.dev), the library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) with a single API. Playwright is built to enable cross-browser web automation that is **ever-green**, **capable**, **reliable** and **fast**.
1111

‎src/Common/Version.props

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<PropertyGroup>
33
<AssemblyVersion>1.48.0</AssemblyVersion>
44
<PackageVersion>$(AssemblyVersion)</PackageVersion>
5-
<DriverVersion>1.48.1</DriverVersion>
5+
<DriverVersion>1.49.0</DriverVersion>
66
<ReleaseVersion>$(AssemblyVersion)</ReleaseVersion>
77
<FileVersion>$(AssemblyVersion)</FileVersion>
88
<NoDefaultExcludes>true</NoDefaultExcludes>

‎src/Playwright.Tests/PageAriaSnapshotTests.cs

+105
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
/*
2+
* MIT License
3+
*
4+
* Copyright (c) Microsoft Corporation.
5+
*
6+
* Permission is hereby granted, free of charge, to any person obtaining a copy
7+
* of this software and associated documentation files (the "Software"), to deal
8+
* in the Software without restriction, including without limitation the rights
9+
* to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
10+
* copies of the Software, and to permit persons to whom the Software is
11+
* furnished to do so, subject to the following conditions:
12+
*
13+
* The above copyright notice and this permission notice shall be included in all
14+
* copies or substantial portions of the Software.
15+
*
16+
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17+
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18+
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19+
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20+
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21+
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22+
* SOFTWARE.
23+
*/
24+
25+
namespace Microsoft.Playwright.Tests;
26+
27+
public class PageAriaSnapshotTests : PageTestEx
28+
{
29+
private string _unshift(string snapshot)
30+
{
31+
var lines = snapshot.Split('\n');
32+
var whitespacePrefixLength = 100;
33+
foreach (var line in lines)
34+
{
35+
if (string.IsNullOrWhiteSpace(line))
36+
continue;
37+
var match = System.Text.RegularExpressions.Regex.Match(line, @"^(\s*)");
38+
if (match.Success && match.Groups[1].Value.Length < whitespacePrefixLength)
39+
whitespacePrefixLength = match.Groups[1].Value.Length;
40+
break;
41+
}
42+
return string.Join('\n', lines.Where(t => !string.IsNullOrWhiteSpace(t)).Select(line => line.Substring(whitespacePrefixLength)));
43+
}
44+
45+
private async Task CheckAndMatchSnapshot(ILocator locator, string snapshot)
46+
{
47+
Assert.AreEqual(_unshift(snapshot), await locator.AriaSnapshotAsync());
48+
await Expect(locator).ToMatchAriaSnapshotAsync(snapshot);
49+
}
50+
51+
[PlaywrightTest("page-aria-snapshot.spec.ts", "should snapshot")]
52+
public async Task ShouldSnapshot()
53+
{
54+
await Page.SetContentAsync("<h1>title</h1>");
55+
await CheckAndMatchSnapshot(Page.Locator("body"), @"
56+
- heading ""title"" [level=1]
57+
");
58+
}
59+
60+
[PlaywrightTest("page-aria-snapshot.spec.ts", "should snapshot list")]
61+
public async Task ShouldSnapshotList()
62+
{
63+
await Page.SetContentAsync(@"
64+
<h1>title</h1>
65+
<h1>title 2</h1>
66+
");
67+
await CheckAndMatchSnapshot(Page.Locator("body"), @"
68+
- heading ""title"" [level=1]
69+
- heading ""title 2"" [level=1]
70+
");
71+
}
72+
73+
[PlaywrightTest("page-aria-snapshot.spec.ts", "should snapshot list with accessible name")]
74+
public async Task ShouldSnapshotListWithAccessibleName()
75+
{
76+
await Page.SetContentAsync(@"
77+
<ul aria-label=""my list"">
78+
<li>one</li>
79+
<li>two</li>
80+
</ul>
81+
");
82+
await CheckAndMatchSnapshot(Page.Locator("body"), @"
83+
- list ""my list"":
84+
- listitem: one
85+
- listitem: two
86+
");
87+
}
88+
89+
[PlaywrightTest("page-aria-snapshot.spec.ts", "should snapshot complex")]
90+
public async Task ShouldSnapshotComplex()
91+
{
92+
await Page.SetContentAsync(@"
93+
<ul>
94+
<li>
95+
<a href='about:blank'>link</a>
96+
</li>
97+
</ul>
98+
");
99+
await CheckAndMatchSnapshot(Page.Locator("body"), @"
100+
- list:
101+
- listitem:
102+
- link ""link""
103+
");
104+
}
105+
}

‎src/Playwright.Tests/PageRouteWebSocketTests.cs

+27
Original file line numberDiff line numberDiff line change
@@ -284,4 +284,31 @@ await AssertAreEqualWithRetriesAsync(() => Page.EvaluateAsync<string[]>("() => w
284284
"close code=3008 reason=oops wasClean=true",
285285
]);
286286
}
287+
288+
[PlaywrightTest("page-route-web-socket.spec.ts", "should work with baseURL")]
289+
public async Task ShouldWorkWithBaseURL()
290+
{
291+
var context = await Browser.NewContextAsync(new() { BaseURL = $"http://localhost:{Server.Port}" });
292+
var page = await context.NewPageAsync();
293+
294+
await page.RouteWebSocketAsync("/ws", ws =>
295+
{
296+
ws.OnMessage(message =>
297+
{
298+
ws.Send(message.Text);
299+
});
300+
});
301+
302+
await SetupWS(page, Server.Port, "blob");
303+
304+
await page.EvaluateAsync(@"async () => {
305+
await window.wsOpened;
306+
window.ws.send('echo');
307+
}");
308+
await AssertAreEqualWithRetriesAsync(() => page.EvaluateAsync<string[]>("() => window.log"), new[]
309+
{
310+
"open",
311+
$"message: data=echo origin=ws://localhost:{Server.Port} lastEventId=",
312+
});
313+
}
287314
}

‎src/Playwright.Tests/TracingTests.cs

+34
Original file line numberDiff line numberDiff line change
@@ -333,6 +333,40 @@ string[] ResourceNames(Dictionary<string, byte[]> resources)
333333
}
334334
}
335335

336+
[PlaywrightTest("tracing.spec.ts", "should show tracing.group in the action list with location")]
337+
public async Task ShouldShowTracingGroupInActionList()
338+
{
339+
using var tracesDir = new TempDirectory();
340+
await Context.Tracing.StartAsync();
341+
var page = await Context.NewPageAsync();
342+
343+
await Context.Tracing.GroupAsync("outer group");
344+
await page.GotoAsync("data:text/html,<!DOCTYPE html><body><div>Hello world</div></body>");
345+
await Context.Tracing.GroupAsync("inner group 1");
346+
await page.Locator("body").ClickAsync();
347+
await Context.Tracing.GroupEndAsync();
348+
await Context.Tracing.GroupAsync("inner group 2");
349+
await Expect(page.GetByText("Hello")).ToBeVisibleAsync();
350+
await Context.Tracing.GroupEndAsync();
351+
await Context.Tracing.GroupEndAsync();
352+
353+
var tracePath = Path.Combine(tracesDir.Path, "trace.zip");
354+
await Context.Tracing.StopAsync(new() { Path = tracePath });
355+
356+
var (events, resources) = ParseTrace(tracePath);
357+
var actions = GetActions(events);
358+
359+
Assert.AreEqual(new[] {
360+
"BrowserContext.NewPageAsync",
361+
"outer group",
362+
"Page.GotoAsync",
363+
"inner group 1",
364+
"Locator.ClickAsync",
365+
"inner group 2",
366+
"LocatorAssertions.ToBeVisibleAsync"
367+
}, actions);
368+
}
369+
336370
private static (IReadOnlyList<TraceEventEntry> Events, Dictionary<string, byte[]> Resources) ParseTrace(string path)
337371
{
338372
Dictionary<string, byte[]> resources = new();

‎src/Playwright/API/Generated/IClock.cs

+22-2
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,12 @@ public partial interface IClock
185185
/// Makes <c>Date.now</c> and <c>new Date()</c> return fixed fake time at all times,
186186
/// keeps all the timers running.
187187
/// </para>
188+
/// <para>
189+
/// Use this method for simple scenarios where you only need to test with a predefined
190+
/// time. For more advanced scenarios, use <see cref="IClock.InstallAsync"/> instead.
191+
/// Read docs on <a href="https://playwright.dev/dotnet/docs/clock">clock emulation</a>
192+
/// to learn more.
193+
/// </para>
188194
/// <para>**Usage**</para>
189195
/// <code>
190196
/// await page.Clock.SetFixedTimeAsync(DateTime.Now);<br/>
@@ -200,6 +206,12 @@ public partial interface IClock
200206
/// Makes <c>Date.now</c> and <c>new Date()</c> return fixed fake time at all times,
201207
/// keeps all the timers running.
202208
/// </para>
209+
/// <para>
210+
/// Use this method for simple scenarios where you only need to test with a predefined
211+
/// time. For more advanced scenarios, use <see cref="IClock.InstallAsync"/> instead.
212+
/// Read docs on <a href="https://playwright.dev/dotnet/docs/clock">clock emulation</a>
213+
/// to learn more.
214+
/// </para>
203215
/// <para>**Usage**</para>
204216
/// <code>
205217
/// await page.Clock.SetFixedTimeAsync(DateTime.Now);<br/>
@@ -211,7 +223,11 @@ public partial interface IClock
211223
Task SetFixedTimeAsync(DateTime time);
212224

213225
/// <summary>
214-
/// <para>Sets current system time but does not trigger any timers.</para>
226+
/// <para>
227+
/// Sets system time, but does not trigger any timers. Use this to test how the web
228+
/// page reacts to a time shift, for example switching from summer to winter time, or
229+
/// changing time zones.
230+
/// </para>
215231
/// <para>**Usage**</para>
216232
/// <code>
217233
/// await page.Clock.SetSystemTimeAsync(DateTime.Now);<br/>
@@ -223,7 +239,11 @@ public partial interface IClock
223239
Task SetSystemTimeAsync(string time);
224240

225241
/// <summary>
226-
/// <para>Sets current system time but does not trigger any timers.</para>
242+
/// <para>
243+
/// Sets system time, but does not trigger any timers. Use this to test how the web
244+
/// page reacts to a time shift, for example switching from summer to winter time, or
245+
/// changing time zones.
246+
/// </para>
227247
/// <para>**Usage**</para>
228248
/// <code>
229249
/// await page.Clock.SetSystemTimeAsync(DateTime.Now);<br/>

‎src/Playwright/API/Generated/IKeyboard.cs

+1-6
Original file line numberDiff line numberDiff line change
@@ -60,12 +60,7 @@ namespace Microsoft.Playwright;
6060
/// await page.Keyboard.PressAsync("Shift+A");
6161
/// </code>
6262
/// <para>An example to trigger select-all with the keyboard</para>
63-
/// <code>
64-
/// // on Windows and Linux<br/>
65-
/// await page.Keyboard.PressAsync("Control+A");<br/>
66-
/// // on macOS<br/>
67-
/// await page.Keyboard.PressAsync("Meta+A");
68-
/// </code>
63+
/// <code>await page.Keyboard.PressAsync("ControlOrMeta+A");</code>
6964
/// </summary>
7065
public partial interface IKeyboard
7166
{

‎src/Playwright/API/Generated/ILocator.cs

+29
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,35 @@ public partial interface ILocator
125125
/// <param name="locator">Additional locator to match.</param>
126126
ILocator And(ILocator locator);
127127

128+
/// <summary>
129+
/// <para>
130+
/// Captures the aria snapshot of the given element. Read more about <a href="https://playwright.dev/dotnet/docs/aria-snapshots">aria
131+
/// snapshots</a> and <see cref="ILocatorAssertions.ToMatchAriaSnapshotAsync"/> for
132+
/// the corresponding assertion.
133+
/// </para>
134+
/// <para>**Usage**</para>
135+
/// <code>await page.GetByRole(AriaRole.Link).AriaSnapshotAsync();</code>
136+
/// <para>**Details**</para>
137+
/// <para>
138+
/// This method captures the aria snapshot of the given element. The snapshot is a string
139+
/// that represents the state of the element and its children. The snapshot can be used
140+
/// to assert the state of the element in the test, or to compare it to state in the
141+
/// future.
142+
/// </para>
143+
/// <para>
144+
/// The ARIA snapshot is represented using <a href="https://yaml.org/spec/1.2.2/">YAML</a>
145+
/// markup language:
146+
/// </para>
147+
/// <list type="bullet">
148+
/// <item><description>The keys of the objects are the roles and optional accessible names of the elements.</description></item>
149+
/// <item><description>The values are either text content or an array of child elements.</description></item>
150+
/// <item><description>Generic static text can be represented with the <c>text</c> key.</description></item>
151+
/// </list>
152+
/// <para>Below is the HTML markup and the respective ARIA snapshot:</para>
153+
/// </summary>
154+
/// <param name="options">Call options</param>
155+
Task<string> AriaSnapshotAsync(LocatorAriaSnapshotOptions? options = default);
156+
128157
/// <summary>
129158
/// <para>
130159
/// Calls <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/blur">blur</a>

‎src/Playwright/API/Generated/ILocatorAssertions.cs

+19
Original file line numberDiff line numberDiff line change
@@ -936,6 +936,25 @@ public partial interface ILocatorAssertions
936936
/// <param name="values">Expected options currently selected.</param>
937937
/// <param name="options">Call options</param>
938938
Task ToHaveValuesAsync(IEnumerable<Regex> values, LocatorAssertionsToHaveValuesOptions? options = default);
939+
940+
/// <summary>
941+
/// <para>
942+
/// Asserts that the target element matches the given <a href="https://playwright.dev/dotnet/docs/aria-snapshots">accessibility
943+
/// snapshot</a>.
944+
/// </para>
945+
/// <para>**Usage**</para>
946+
/// <code>
947+
/// await page.GotoAsync("https://demo.playwright.dev/todomvc/");<br/>
948+
/// await Expect(page.Locator("body")).ToMatchAriaSnapshotAsync(@"<br/>
949+
/// - heading ""todos""<br/>
950+
/// - textbox ""What needs to be done?""<br/>
951+
/// ");
952+
/// </code>
953+
/// </summary>
954+
/// <param name="expected">
955+
/// </param>
956+
/// <param name="options">Call options</param>
957+
Task ToMatchAriaSnapshotAsync(string expected, LocatorAssertionsToMatchAriaSnapshotOptions? options = default);
939958
}
940959

941960
#nullable disable

‎src/Playwright/API/Generated/IPage.cs

+6-8
Original file line numberDiff line numberDiff line change
@@ -636,8 +636,6 @@ public partial interface IPage
636636
/// await page.EvaluateAsync("matchMedia('(prefers-color-scheme: dark)').matches");<br/>
637637
/// // → true<br/>
638638
/// await page.EvaluateAsync("matchMedia('(prefers-color-scheme: light)').matches");<br/>
639-
/// // → false<br/>
640-
/// await page.EvaluateAsync("matchMedia('(prefers-color-scheme: no-preference)').matches");<br/>
641639
/// // → false
642640
/// </code>
643641
/// </summary>
@@ -2187,8 +2185,8 @@ public partial interface IPage
21872185
/// </para>
21882186
/// <code>
21892187
/// await page.RouteWebSocketAsync("/ws", ws =&gt; {<br/>
2190-
/// ws.OnMessage(message =&gt; {<br/>
2191-
/// if (message == "request")<br/>
2188+
/// ws.OnMessage(frame =&gt; {<br/>
2189+
/// if (frame.Text == "request")<br/>
21922190
/// ws.Send("response");<br/>
21932191
/// });<br/>
21942192
/// });
@@ -2214,8 +2212,8 @@ public partial interface IPage
22142212
/// </para>
22152213
/// <code>
22162214
/// await page.RouteWebSocketAsync("/ws", ws =&gt; {<br/>
2217-
/// ws.OnMessage(message =&gt; {<br/>
2218-
/// if (message == "request")<br/>
2215+
/// ws.OnMessage(frame =&gt; {<br/>
2216+
/// if (frame.Text == "request")<br/>
22192217
/// ws.Send("response");<br/>
22202218
/// });<br/>
22212219
/// });
@@ -2241,8 +2239,8 @@ public partial interface IPage
22412239
/// </para>
22422240
/// <code>
22432241
/// await page.RouteWebSocketAsync("/ws", ws =&gt; {<br/>
2244-
/// ws.OnMessage(message =&gt; {<br/>
2245-
/// if (message == "request")<br/>
2242+
/// ws.OnMessage(frame =&gt; {<br/>
2243+
/// if (frame.Text == "request")<br/>
22462244
/// ws.Send("response");<br/>
22472245
/// });<br/>
22482246
/// });

‎src/Playwright/API/Generated/IRoute.cs

+4-5
Original file line numberDiff line numberDiff line change
@@ -85,11 +85,10 @@ public partial interface IRoute
8585
/// </code>
8686
/// <para>**Details**</para>
8787
/// <para>
88-
/// Note that any overrides such as <see cref="IRoute.ContinueAsync"/> or <see cref="IRoute.ContinueAsync"/>
89-
/// only apply to the request being routed. If this request results in a redirect, overrides
90-
/// will not be applied to the new redirected request. If you want to propagate a header
91-
/// through redirects, use the combination of <see cref="IRoute.FetchAsync"/> and <see
92-
/// cref="IRoute.FulfillAsync"/> instead.
88+
/// The <see cref="IRoute.ContinueAsync"/> option applies to both the routed request
89+
/// and any redirects it initiates. However, <see cref="IRoute.ContinueAsync"/>, <see
90+
/// cref="IRoute.ContinueAsync"/>, and <see cref="IRoute.ContinueAsync"/> only apply
91+
/// to the original request and are not carried over to redirected requests.
9392
/// </para>
9493
/// <para>
9594
/// <see cref="IRoute.ContinueAsync"/> will immediately send the request to the network,

0 commit comments

Comments
 (0)