Releases: microsoft/playwright-dotnet
v1.15.1
Highlights
This patch includes bug fixes for the following issues:
microsoft/playwright#8955 - [BUG] fix(inspector): stop on all snapshottable actions
microsoft/playwright#8999 - [BUG] fix: do not dedup header values
microsoft/playwright#9038 - [BUG] fix: restore support for slowmo connect option
Browser Versions
- Chromium 96.0.4641.0
- Mozilla Firefox 92.0
- WebKit 15.0
This version of Playwright was also tested against the following stable channels:
- Google Chrome 93
- Microsoft Edge 93
v1.15.0
🖱️ Mouse Wheel
By using Page.Mouse.WheelAsync you are now able to scroll vertically or horizontally.
📜 New Headers API
Previously it was not possible to get multiple header values of a response. This is now possible and additional helper functions are available:
- Request.AllHeadersAsync()
- Request.HeadersArrayAsync()
- Request.HeaderValueAsync(name: string)
- Response.AllHeadersAsync()
- Response.HeadersArrayAsync()
- Response.HeaderValueAsync(name: string)
- Response.HeaderValuesAsync(name: string)
🌈 Forced-Colors emulation
Its now possible to emulate the forced-colors CSS media feature by passing it in the context options or calling Page.EmulateMediaAsync().
New APIs
- Page.RouteAsync() accepts new
timesoption to specify how many times this route should be matched. - Page.SetCheckedAsync(selector: string, checked: Boolean) and Locator.SetCheckedAsync(selector: string, checked: Boolean) was introduced to set the checked state of a checkbox.
- Request.SizesAsync() Returns resource size information for given http request.
- Tracing.StartChunkAsync() - Start a new trace chunk.
- Tracing.StopChunkAsync() - Stops a new trace chunk.
Browser Versions
- Chromium 96.0.4641.0
- Mozilla Firefox 92.0
- WebKit 15.0
Important ⚠
- ⬆ .NET Core Apps 2.1 are no longer supported for our CLI tooling. As of August 31st, 2021, .NET Core 2.1 is no longer supported and will not receive any security updates. We've decided to move the CLI forward and require .NET Core 3.1 as a minimum.
This version of Playwright was also tested against the following stable channels:
- Google Chrome 93
- Microsoft Edge 93
Important ⚠
- ⬆ .NET Core Apps 2.1 are no longer supported for our CLI tooling. As of August 31st, 2021, .NET Core 2.1 is no longer supported and will not receive any security updates. We've decided to move the CLI forward and require .NET Core 3.1 as a minimum.
v1.14.1
Highlights
This patch includes bug fixes for the following issues:
microsoft/playwright#8287 - [BUG] webkit crashes intermittently: "file data stream has an unexpected number of bytes"
microsoft/playwright#8281 - [BUG] HTML report crashes if diff snapshot does not exists
microsoft/playwright#8230 - Using React Selectors with multiple React trees
microsoft/playwright#8366 - [BUG] Mark timeout in isVisible as deprecated and noop
Browser Versions
- Chromium 94.0.4595.0
- Mozilla Firefox 91.0
- WebKit 15.0
This version of Playwright was also tested against the following stable channels:
- Google Chrome 92
- Microsoft Edge 92
v1.14.0
⚡️ New "strict" mode
Selector ambiguity is a common problem in automation testing. "strict" mode
ensures that your selector points to a single element and throws otherwise.
Pass Strict = true into your action calls to opt in.
// This will throw if you have more than one button!
await page.ClickAsync("button", new () { Strict = true } );📍 New Locators API
Locator represents a view to the element(s) on the page. It captures the logic sufficient to retrieve the element at any given moment.
The difference between the Locator and ElementHandle is that the latter points to a particular element, while Locator captures the logic of how to retrieve that element.
Also, locators are "strict" by default!
var locator = page.Locator("button");
await locator.ClickAsync();Learn more in the documentation.
🧩 Experimental React and Vue selector engines
React and Vue selectors allow selecting elements by its component name and/or property values. The syntax is very similar to attribute selectors and supports all attribute selector operators.
await page.ClickAsync("_react=SubmitButton[enabled=true]");
await page.ClickAsync("_vue=submit-button[enabled=true]");Learn more in the react selectors documentation and the vue selectors documentation.
✨ New nth and visible selector engines
nthselector engine is equivalent to the:nth-matchpseudo class, but could be combined with other selector engines.visibleselector engine is equivalent to the:visiblepseudo class, but could be combined with other selector engines.
// select the first button among all buttons
await button.ClickAsync("button >> nth=0");
// or if you are using locators, you can use first(), nth() and last()
await page.Locator("button").First.ClickAsync();
// click a visible button
await button.ClickAsync("button >> visible=true");.NET Specific Features
- 🧪
SkipAttributeWe now have aNUnitattribute that can be used to skip various combinations of browser and/or platforms.
Browser Versions
- Chromium 94.0.4595.0
- Mozilla Firefox 91.0
- WebKit 15.0
This version of Playwright was also tested against the following stable channels:
- Google Chrome 92
- Microsoft Edge 92
v1.13.0
Playwright
- 🖖 Programmatic drag-and-drop support via the
Page.DragAndDropAsync()API. - 🔎 Enhanced HAR with body sizes for requests and responses. Use via
RecordHarPathoption inBrowser.NewContextAsync(). - 🔒 Assembly Signing for .NET assemblies is no longer done using
PublicSignbut using a full signing key, making it easier to use in projects requiring full-trust
Tools
- Playwright Trace Viewer now shows parameters, returned values and
console.log()calls.
New and Overhauled Guides
Browser Versions
- Chromium 93.0.4576.0
- Mozilla Firefox 90.0
- WebKit 14.2
New Playwright APIs
- new
BaseURLoption inBrowser.NewContextAsync()andBrowser.NewPageAsync() Response.SecurityDetailsAsync()andResponse.ServerAddrAsync()Page.DragAndDropAsync()andFrame.DragAndDropAsync()Download.CancelAsync()Page.InputValueAsync(),Frame.InputValueAsync()andElementHandle.InputValueAsync()- new
Forceoption inPage.FillAsync(),Frame.FillAsync(), andElementHandle.FillAsync() - new
Forceoption inPage.SelectOptionAsync(),Frame.SelectOptionAsync(), andElementHandle.SelectOptionAsync()
v1.12.2
Highlights
This patch release includes bugfixes for the following issues:
microsoft/playwright#7015 - [BUG] Firefox: strange undefined toJSON property on JS objects
microsoft/playwright#7048 - [BUG] Dialogs cannot be dismissed if tracing is on in Chromium or Webkit
microsoft/playwright#7058 - [BUG] Getting no video frame error for mobile chrome
Browser Versions
- Chromium 93.0.4530.0
- Mozilla Firefox 89.0
- WebKit 14.2
This version of Playwright was also tested against the following stable channels:
- Google Chrome 91
- Microsoft Edge 91
v1.12.1
Highlights
- Playwright for .NET v1.12 is now stable!
- The NuGet package has been renamed and is now available as Microsoft.Playwright.
- Ships with the codegen and trace viewer tools out-of-the-box
Browser Versions
- Chromium 93.0.4530.0
- Mozilla Firefox 89.0
- WebKit 14.2
This version of Playwright was also tested against the following stable channels:
- Google Chrome 91
- Microsoft Edge 91
Breaking Changes
This release is a major release for the .NET port. We've completely redone the API surface in order to ensure parity with the rest of the supported languages. Unfortunately, this meant we had to introduce some breaking changes. The following list points out the key ones:
- Installation of the browsers no longer happens automatically. Follow the steps in Getting started.
- Optional arguments have been replaced with an
optionsclass. Method calls should look closer to.LaunchAsync(new() { Headless = false }); - All
decimalarguments are nowfloat. IAccessibilitynow returns aJSONElement- The use of
System.Drawing.Pointwas dropped in favour of using our own, generatedPosition timeoutanddelayarguments are nowfloat.- The usage of the
Rectclass was replaced byElementHandleBoundingBoxResult. WaitForStatewas renamed toWaitForSelectorState.SelectOptionwas renamed toSelectOptionValue.EventArgs were removed in favor of the class theEventArgwas wrapping. For instancePage.Closeis now anEventHandler<IPage>andPage.Downloadis now anEventHandler<IDownload>.Modifierwas renamed toKeyboardModifier.LifecycleEventwas renamed toLoadState.- Arrays are now exposed as
ReadOnlyCollection.
Other Breaking Changes
IBrowserContext
Events
New event: EventHandler<IRequest> Request
New event: EventHandler<IRequest> RequestFailed
New event: EventHandler<IRequest> RequestFinished
New event: EventHandler<IResponse> Response
Properties
DefaultTimeouthas been replaced withSetDefaultTimeoutDefaultNavigationTimeouthas been replaced withSetDefaultNavigationTimeout
Methods
GetCookiesAsynchas been replaced withCookiesAsyncGetStorageStateAsynchas been replaced withStorageStateAsyncSetHttpCredentialsAsynchas been removed.WaitForEventAsynchas been replaced withWaitForPageAsyncandRunAndWaitForPageAsync.
IElementHandle
Methods
GetBoundingBoxAsynchas been replaced withBoundingBoxAsyncGetContentFrameAsynchas been replaced withContentFrameAsyncGetInnerHtmlAsynchas been replaced withInnerHTMLAsyncGetInnerTextAsynchas been replaced withInnerTextAsyncGetOwnerFrameAsynchas been replaced withOwnerFrameAsyncGetTextContentAsynchas been replaced withTextContentAsync
IFrame
Methods
GetContentAsynchas been replaced withContentAsyncGetFrameElementAsynchas been replaced withFrameElementAsyncGetInnerHtmlAsynchas been replaced withInnerHTMLAsyncGetInnerTextAsynchas been replaced withInnerTextAsyncGetTextContentAsynchas been replaced withTextContentAsyncGetTitleAsynchas been replaced withTitleAsyncGoToAsynchas been replaced withGotoAsync
IJSHandle
Methods
GetJsonValueAsynchas been replaced withJsonValueAsync
IPage
Events
Properties
DefaultTimeouthas been removed.DefaultNavigationTimeouthas been removed.Coveragehas been removed.
Methods
GetContentAsynchas been replaced withContentAsyncGetFramehas been replaced withFrameGetInnerHtmlAsynchas been replaced withInnerHTMLAsyncGetInnerTextAsynchas been replaced withInnerTextAsyncGetOpenerAsynchas been replaced withOpenerAsyncGetPdfAsynchas been replaced withPdfAsyncGetTextContentAsynchas been replaced withTextContentAsyncGetTitleAsynchas been replaced with TitleAsync``GoToAsynchas been replaced withGotoAsyncWaitForEventAsynchas been replaced with more specificWaitFor*overloads
IRequest
Methods
GetPostDataJsonhas been replaced withPostDataJSONGetResponseAsynchas been replaced withResponseAsync
IResponse
Methods
GetBodyAsynchas been replaced withBodyAsyncGetJsonAsynchas been replaced withJsonAsyncGetTextAsynchas been replaced withTextAsync
IVideo
Methods
GetPathAsynchas been replaced withPathAsync
IWebSocket
Methods
WaitForEventAsynchas been removed.
Removed Types
ICoveragehas been removed.IConnectionTransporthas been removed.ICDPSessionhas been removed.IChromiumBrowserhas been removed.IChromiumBrowserContexthas been removed.IChromiumBrowserTypehas been removed.
