Edit

Prerelease SDK 1.0.2357-prerelease, for Runtime 122 (Jan. 30, 2024)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Jan. 30, 2024.

NuGet package for WebView2 SDK 1.0.2357-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 122.0.2357.0 or later; see Runtime 122.0.2365.46 (Feb. 26, 2024).

Detailed contents:

Experimental APIs (Phase 1: Experimental in Prerelease)

The following Experimental APIs have been added in this Prerelease SDK.

Runtime selection

Added the Runtime selection feature to support more prerelease testing and flighting scenarios. You can specify ReleaseChannels to choose which channels are searched for during environment creation, and ChannelSearchKind to select a search order.

Hit-testing results on regions

Added a new API to provide hit-testing results on the regions that a WebView2 contains. This API is useful for visually hosted applications that want to handle mouse events on the non-client area of the WebView2 window.

Promotions to Phase 2 (Stable in Prerelease)

The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.

IsBrowserAcceleratorKeyEnabled property

CoreWebView2AcceleratorKeyPressedEventArgs has a new IsBrowserAcceleratorKeyEnabled property to allow you to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:

The previous phase isn't in the release notes.

Frame Process Info API

The Frame Process Info API, including GetProcessExtendedInfos, provides a snapshot collection of all frames that are actively running in the associated renderer process. This API enables the host application to detect which part of WebView2 is consuming resources such as memory or CPU usage.

Previous phase: Frame Process Info API in Prerelease SDK 1.0.2106-prerelease, for Runtime 119 (Sep. 20, 2023).

ExecuteScriptWithResult provides exception info, and TryGetResultAsString

ExecuteScriptWithResult provides exception information if the script failed. TryGetResultAsString gets the script execution result as a string rather than as JSON, to make it more convenient to interact with string results:

The previous phase isn't in the release notes.

CreateFromComICoreWebView2 to allow .NET to interact with a C++ control

CreateFromComICoreWebView2 wraps an existing ICoreWebView2 object in a CoreWebView2 instance, to allow .NET devs to interact with an control that was created in C++.

The previous phase isn't in the release notes.

Support for browser extensions in WebView2, for WinRT

To support browser extensions in WebView2, added GetBrowserExtensions for WinRT:

Previous phase: Support for browser extensions in WebView2 in Prerelease SDK 1.0.1988-prerelease, for Runtime 117 (Jul. 24, 2023) - multi-platform.

WebResourceRequested for workers

Added support for WebResourceRequested for workers, which allows setting filters in order to receive WebResourceRequested events for service workers, shared workers, and different origin iframes.

Previous phase: WebResourceRequested for workers in Prerelease SDK 1.0.1340-prerelease, for Runtime 105 (Aug. 8, 2022).

Bug fixes

  • Fixed an issue where the WebView2 control in .NET was failing to find the WebView2Loader.dll on UNC paths. (Issue #4081)

  • Fixed some issues causing instances of InvalidOperationException in .NET controls, that weren't helpful to developers. (Issue #4272)

See also