Edit

Share via

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

Release Date: June 19, 2024

NuGet package for WebView2 SDK 1.0.2592.51

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

Promotions

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

Bug fixes

Runtime-only
  • Disable BreakoutBoxPreferCaptureTimestampInVideoFrame for WebView2 TextureStream
  • Fixed a regression where WindowCloseRequested event only fires for first window.close() call.
  • Fixed a regression where typed arrays in WinRT JavaScript projection could not be handled as IDispatch in host.
  • Fixed a bug where autofill popup dismisses immediately and causes focus change
  • Fixed a bug where WebView2 fails to load because AppPolicyGetWindowingModel (Issue #4591)

1.0.2646-prerelease

Release Date: June 19, 2024

NuGet package for WebView2 SDK 1.0.2646-prerelease

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

General features

  • Added support for C#/WinRT .NET 6+.

Experimental features

  • Introduced the feature flag msWebView2EnableDownloadContentInWebResourceResponseReceived, an an Experimental feature (rather than as a Stable feature). When this flag is enabled, allows responses of navigations that become downloads to be available in WebResourceResponseReceived.

Experimental APIs

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

  • Added a new SaveFileSecurityCheckStarting event. As a developer, you can register a handler on this event to get the file path, filename extension, and document origin URI information. Then you can apply your own rules to do actions such as the following:
  • Allow saving the file without presenting a default file type policy security warning UI.
  • Cancel the saving.
  • Create your own UI to manage runtime file-type policies.
  • Added a new ScreenCaptureStarting event. This event is raised whenever the WebView2 and/or iframe that corresponds to the CoreWebView2Frame or any of its descendant iframes requests permission to use the Screen Capture API before the UI is shown. As a developer, you can then choose to block the UI from being displayed, or allow the UI to be displayed.
  • Added a new method to the CoreWebView2 .NET class that enables you to convert a CoreWebView2 between .NET and COM. Added a new WinRT interface that enables you to convert a CoreWebView2 between WinRT and COM. This allows you to interoperate between libraries that are written in different languages.

Promotions

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

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

Bug fixes

Runtime-only
  • Fixed a bug in owned-window activation logic for visual hosting.

1.0.2535.41

Release Date: May 28, 2024

NuGet package for WebView2 SDK 1.0.2535.41

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

Promotions

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

  • Support for the Fluent Style Overlay Scrollbar.

Bug fixes

Runtime-only
  • Fixed a bug where if the LaunchingExternalURIScheme event handler is attached, and the always remember checkbox is enabled, and the user selects this checkbox, the dialog is incorrectly displayed again.
  • Fixed an issue where text edit controls in visual hosting would duplicate IME input when losing and then regaining focus.
  • Fixed an issue where full-trust UWP apps couldn't display owned windows.
SDK-only
  • Fixed an issue in the SDK causing erroneous <Platform> values in the .NET project platforms list. (Issue #1755)

1.0.2584-prerelease

Release Date: May 28, 2024

NuGet package for WebView2 SDK 1.0.2584-prerelease

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

Experimental features

  • Introduced an option to cancel the initial navigation in WebView2, to improve startup performance. This change is disabled by default, and can be enabled by using the msWebView2CancelInitialNavigation feature flag.

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

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

Bug fixes

Runtime and SDK
  • Fixed a crash when .NET host object async methods return a null result. (Issue #4509)
Runtime-only
  • Fixed a WebView2 memory leak issue when the window is closed. (Issue #4286)
  • Fixed an issue where ignoreMemberNotFoundError wasn't working for .NET objects. (Issue #4497)
  • Now returns a proper error code when CreateSharedBuffer is called with 0 buffer size. (Issue #4554)
  • Fixed an activation issue for the caret browsing dialog.
  • Fixed an issue where the WebView2 Visual Hosting CursorChanged event wasn't firing for custom cursors.

1.0.2478.35

Release Date: April 22, 2024

NuGet package for WebView2 SDK 1.0.2478.35

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

Promotions

The following APIs have been promoted to Stable and are now included in this Release 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.

Bug fixes

Runtime-only
  • Fixes a potential integer overflow that could lead to a crash when using AdditionalObjects in the WebMessage API.

1.0.2526-prerelease

Release Date: April 22, 2024

NuGet package for WebView2 SDK 1.0.2526-prerelease

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

Breaking changes

The minimum .NET Framework version requirement for .NET WebView2, including WPF and WinForms controls, has been updated from .NET Framework 4.5 to .NET Framework 4.6.2.

Experimental APIs

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

  • Added SaveAs APIs that allow you to programmatically perform the Save as operation. You can use these APIs to block the default Save as dialog, and then either save silently, or build your own UI for Save as. These APIs pertain only to the Save as dialog, not the Download dialog, which continues to use the existing Download APIs.

Promotions

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

  • Support for the Fluent Style Overlay Scrollbar.

Bug fixes

Runtime and SDK

  • Fixed a bug in WinRT JavaScript projection where passing in a typed array resulted in an "Interface Not Supported" error. (Issue #3486)

  • Added support for handling out array parameters in WinRT JavaScript projection.

Runtime-only

  • Fixed a bug where the Image Auto-captioning feature was enabled by default.

  • Fixed a bug where if the LaunchingExternalURIScheme event handler is attached, if the always remember checkbox is enabled and the user selects this checkbox, the dialog will incorrectly be shown again.

  • Fixed GetNonClientRegionAtPoint incorrectly returning Nowhere for some points.

  • Fixed a bug where the Text Services Framework would disconnect upon dropping a file onto a WebView2 region.

  • Fixed a bug where the View Source Ctrl+U keyboard shortcut remained enabled when the AreDevToolsEnabled setting was false.

  • Fixed a bug where a composable IME was duplicated upon regaining focus. (Issue #1610)

  • Ensured that devicePixelRatio is synchronized with custom rasterization scales. (Issue #3060)

  • Fixed a race condition when using CallDevToolsProtocolMethod events in NewWindowRequested. (Issue #4181)

  • Fixed a crash that can occur in WPF TabIntoCore when the Controller has been destroyed but the user tries to tab into the control (pressing the Tab key). (Issue #4452)

  • Ensured that spellcheck takes input language with case-insensitive format.

  • Made the Language API more robust regarding user input.

  • Fixed a bug where the Save password? prompt is not displayed.

SDK-only
  • Fixed missing AreBrowserExtensionsEnabled API in WinRT projection.

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)

See also