Edit

Release Notes for the WebView2 SDK

  • Article

These Release Notes provide information about new features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK.

1.0.2420.47

Release Date: March 25, 2024

NuGet package for WebView2 SDK 1.0.2420.47

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 123.0.2420.47 or higher.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

  • 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.
  • Added the FailureSourceModulePath property to the ProcessFailedEventArgs type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited with STATUS_INVALID_IMAGE_HASH.

Bug fixes

SDK-only
  • The .NET assemblies for WinForms and WPF are now shipped with optimization enabled. (Issue #4409)

1.0.2470-prerelease

Release Date: March 25, 2024

NuGet package for WebView2 SDK 1.0.2470-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires WebView2 Runtime version 124.0.2470.0 or higher.

Experimental APIs

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

  • Support for the Fluent Style Overlay Scrollbar.
  • Updated the WebMessageObjects API to allow injecting DOM objects into WebView2 content that's constructed via the app and via the CoreWebView2.PostWebMessage API in the other direction. Added a new web object type to represent a file system handle that can be posted to the web content to provide it with filesystem access.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

  • 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.
  • Added the FailureSourceModulePath property to the ProcessFailedEventArgs type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited with STATUS_INVALID_IMAGE_HASH.

Bug fixes

Runtime-only
  • Fixed a reliability regression that could crash the application process when an old version of WebView2 client DLL is unloaded.
  • Ensured that the WebView2 temporary download folder is unique per user data folder, and doesn't interfere with other apps or the browser.

1.0.2365.46

Release Date: February 26, 2024

NuGet package for WebView2 SDK 1.0.2365.46

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 122.0.2365.46 or higher.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

  • 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.
  • To support browser extensions in WebView2, added GetBrowserExtensions for WinRT:

Bug fixes

Runtime-only

  • Fixed a regression that affected handling of the NewWindowRequested event when the new window is set to be the source WebView. (Issue #4250)

  • Fixed a bug where closing a WebView that has an embedded PDF viewer could lead to a crash. (Issue #3832)

  • Fixed a regression where mouse-clicks stopped working when the application enabled SetWindowDisplayAffinity. (Issue #4325)

1.0.2415-prerelease

Release Date: February 26, 2024

NuGet package for WebView2 SDK 1.0.2415-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 123.0.2415.0 or higher.

Breaking changes

  • The behavior of the InitiatingOrigin property of CoreWebView2LaunchingExternalUriSchemeEventArgs has changed. If the InitiatingOrigin is an opaque origin, the InitiatingOrigin that's reported in the event args is its precursor origin. The precursor origin is the origin that created the opaque origin. For example, if a frame that's at example.com opens a subframe that has a different opaque origin, the subframe's precursor origin is example.com.
  • The members of the CoreWebView2TextureStreamErrorKind enum have been renamed:

Old member names:

New member names:

Experimental APIs

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

  • The CoreWebView2ControllerOptions class now has an AllowHostInputProcessing property, which allows user input messages (keyboard, mouse, touch, and pen) to pass through the browser window to be received by an app process window.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

  • 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.

Bug fixes

Runtime-only

  • Fixed the camera or mic not being able to open in Google Meet or Microsoft Teams meetings when the permission request is set to "not persisted" (that is, SavesInProfile = false). (Issue #3592)

  • Fixed appending an empty --edge-webview-custom-scheme command-line switch in a WebView2 browser process.

  • Disabled the global UserDataFolder registry key, so that this registry key can only be applied per-app.

  • Fixed the NewWindowRequested event not being fired when opened by a browser extension. (Issue #3841)

  • Fixed the NewWindowRequested event not being fired when opening a view source. (Issue #4162)

  • Fixed an issue to fire StateChanged and BytesReceivedChanged events when a download involves navigation.

  • Fixed a bug where the BeforeUnload dialog caused the WebView2 window to unexpectedly jump position. (Issue #4350)

  • Fixed an issue where PrintAsync prints a blank page if it is called too soon, before the PDF is fully loaded. (Issue #3779)

1.0.2277.86

Release Date: February 5, 2024

NuGet package for WebView2 SDK 1.0.2277.86

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 121.0.2277.86 or higher.

Breaking changes

Important

Breaking Change: Navigations to about:blank are now cancellable via the NavigationStarting event. To revert to the old behavior, disable the msWebView2CancellableAboutNavigations feature flag.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

  • 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:

Bug fixes

Runtime-only

  • Ensured that the spellcheck language matches put_Language programmatically. The customized context menu is also updated with correct spellchecks. (Runtime-only)

  • Fixed a bug that stopped raising the NavigationCompleted event for some websites that load AV1-encoded videos. (Runtime-only) (Issue #3801)

  • Fixed an issue where host-process COM resources would be released during WebView tear-down. (Runtime-only) (Issue #4226)

  • Fixed a bug that broke loading some social media apps such as Facebook, Twitter, and Linkedin. This change is Runtime-specific. (Runtime-only) (Issue #4281)

1.0.2357-prerelease

Release Date: January 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 higher.

Experimental APIs

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

  • Added the Runtime selection feature to support more prerelease testing and flighting scenarios. Developers can specify ReleaseChannels to choose which channels are searched for during environment creation, and ChannelSearchKind to select a search order.
  • 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

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

  • 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 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:
  • 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:
  • CreateFromComICoreWebView2 wraps an existing ICoreWebView2 object in a CoreWebView2 instance, to allow .NET devs to interact with an control that was created in C++.
  • To support browser extensions in WebView2, added GetBrowserExtensions for WinRT:
  • 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.

Bug fixes

Runtime-only

  • Fixed a bug where closing a WebView control that has an embedded PDF viewer could lead to a crash. (Runtime-only) (Issue #3832)

  • Fixed issues with stacking of child-process taskbar icons. (Runtime-only) (Issue #3245)

  • Fixed a bug that sent an unnecessary network request for Edge Cloud Config Service. (Runtime-only) (Issue #4180)

  • Updated the behavior of the app-region CSS property so that changes to its value trigger a page re-layout. (Runtime-only)

  • Fixed an issue where put_AreBrowserAcceleratorKeysEnabled wasn't able to update settings for WebView2 when no AcceleratorKeyPressed event handler is registered. (Runtime-only) (Issue #4278)

SDK-only

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

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

1.0.2210.55

Release Date: December 11, 2023

NuGet package for WebView2 SDK 1.0.2210.55

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 120.0.2210.55 or higher.

Breaking changes

Important

Breaking Change: If you're developing an unpackaged Win32 app using Fixed Version Runtime v120 or above and targeting Windows 10 devices, you need to run a couple of ACL shell commands (icacls), to avoid crashing, because of a new security feature implemented in WebView2. See [Breaking Change] Unpackaged Win32 app using Fixed Version v120+ on Win10 need ACL. The fix is in the article Distribute your app and the WebView2 Runtime, section Details about the Fixed Version runtime distribution mode, step "On Windows 10 devices, starting with Fixed Version 120, developers of unpackaged Win32 applications using Fixed Version are required to run the following commands."

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

  • Support for browser extensions in WebView2:
  • 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:
  • ICoreWebView2AcceleratorKeyPressedEventArgs has a new IsBrowserAcceleratorKeyEnabled property to allow developers to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
  • Added support for managing profile deletion:

Bug fixes

  • Added support for promise cancellation on host objects' async methods in WinRT JS projection. For information about AddHostObjectToScript, see Call native-side WinRT code from web-side code. (Runtime and SDK)

  • Disabled automatic HTTPS upgrades for WebView2 API navigations. (Runtime-only) (Issue #4104)

1.0.2151.40

Release Date: November 6, 2023

NuGet package for WebView2 SDK 1.0.2151.40

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 119.0.2151.40 or higher.

General Availability

Important

Announcement: Xbox WebView2 SDK is now Generally Available (GA) and is available on Xbox October 2310 version (231018-2200). For more details, see WebView2 for Xbox announcement.

Promotions

The following APIs have been promoted to Stable and are now included in this Release SDK.

  • Added source frame info to the NewWindowRequested event arguments, to identify the source of the request:
  • For WinRT, options have been added to manage custom scheme registration when creating a CoreWebView2Environment:

Bug fixes

  • Fixed a reliability issue where multiple WebView creations could lead to a crash. (Runtime-only) (Issue #3793)

1.0.2194-prerelease

Release Date: November 6, 2023

NuGet package for WebView2 SDK 1.0.2194-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 120.0.2194.0 or higher.

Promotions

The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.

  • Support for browser extensions in WebView2:

Bug fixes

  • Fixed an issue where WebView2 would sometimes render blurry content or no content after changing monitor scale or switching between RDP and docking modes. (Runtime-only)
  • Fixed an issue in TextServicesFoundation causing a crash when a WebView2 instance was destroyed. (Runtime-only)
  • Fixes a memory leak in .NET when web messages are sent from WebView2, but aren't read from the application side. (Runtime and SDK) (Issue #3794)
  • Fixed an issue causing the ScaleFactor setting to not work properly for all WebView2 Print APIs. (Runtime-only) (Issue #4082)

1.0.2088.41

Release Date: October 16, 2023

NuGet package for WebView2 SDK 1.0.2088.41

For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 118.0.2088.41 or higher.

Promotions

No additional APIs have been promoted to Stable and added in this Release SDK.

Bug fixes

  • Fixed an issue causing some UWP apps to be unable to input text. (Runtime-only) (Issue #3805)
  • Fixed an initialization failure for apps that were using the Windows PerProcessSystemDPIForceOff compatibility setting. (Runtime-only) (Issue #3692)
  • Fixed a Dialog Position Offset bug in WebView2. (Runtime-only) (Issue #3763)

1.0.2164-prerelease

Release Date: October 18, 2023

NuGet package for WebView2 SDK 1.0.2164-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 120.0.2164.0 or higher.

Experimental APIs

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

  • Added the FailureSourceModulePath property to the ProcessFailedEventArgs type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited with STATUS_INVALID_IMAGE_HASH.

Bug fixes

  • Added support for additional page settings (PageRange and PagesPerSheet) in the PrintToPDF API. (Runtime-only) (Issue #3719)
  • Navigation to an Extension Resource file was not handled correctly, and has now been fixed with the correct handling method. (Runtime-only) (Issue #3728)
  • Fixed an issue causing some UWP apps to be unable to input text. (Runtime-only) (Issue #3805)
  • Fixed an initialization failure for apps that were using the Windows PerProcessSystemDPIForceOff compatibility setting. (Runtime-only) (Issue #3692)
  • Removed monitors that were collecting data when the system default browser setting changes. (Runtime-only)
  • Fixed a Dialog Position Offset bug in WebView2. (Runtime-only) (Issue #3763)
  • Fixed a crash in the NewWindowRequested event if the NewWindow is set to null. (Runtime-only)

See also