Release Notes for the WebView2 SDK
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.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.
CoreWebView2EnvironmentOptionsClass:CoreWebView2ScrollbarStyle Enum
DefaultFluentOverlay
Bug fixes
Runtime-only
- Fixed a bug where if the
LaunchingExternalURISchemeevent 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
msWebView2CancelInitialNavigationfeature 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
ignoreMemberNotFoundErrorwasn't working for .NET objects. (Issue #4497) - Now returns a proper error code when
CreateSharedBufferis called with 0 buffer size. (Issue #4554) - Fixed an activation issue for the caret browsing dialog.
- Fixed an issue where the WebView2 Visual Hosting
CursorChangedevent 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
ReleaseChannelsto choose which channels are searched for during environment creation, andChannelSearchKindto select a search order.
CoreWebView2EnvironmentOptionsClass:CoreWebView2ChannelSearchKind Enum
MostStableLeastStable
CoreWebView2ReleaseChannels Enum
NoneStableBetaDevCanary
Bug fixes
Runtime-only
- Fixes a potential integer overflow that could lead to a crash when using
AdditionalObjectsin 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
SaveAsAPIs 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.
CoreWebView2Class:-
CompleteDefaultHtmlOnlySingleFile
CoreWebView2SaveAsUIResult Enum
CancelledFileAlreadyExistsInvalidPathKindNotSupportedSuccess
CoreWebView2SaveAsUIShowingEventArgsClass:- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace Property
- CoreWebView2SaveAsUIShowingEventArgs.Cancel Property
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType Property
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method
- CoreWebView2SaveAsUIShowingEventArgs.Kind Property
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog Property
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Support for the Fluent Style Overlay Scrollbar.
CoreWebView2EnvironmentOptionsClass:CoreWebView2ScrollbarStyle Enum
DefaultFluentOverlay
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
outarray 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
LaunchingExternalURISchemeevent handler is attached, if the always remember checkbox is enabled and the user selects this checkbox, the dialog will incorrectly be shown again.Fixed
GetNonClientRegionAtPointincorrectly returningNowherefor 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
AreDevToolsEnabledsetting wasfalse.Fixed a bug where a composable IME was duplicated upon regaining focus. (Issue #1610)
Ensured that
devicePixelRatiois synchronized with custom rasterization scales. (Issue #3060)Fixed a race condition when using
CallDevToolsProtocolMethodevents inNewWindowRequested. (Issue #4181)Fixed a crash that can occur in WPF
TabIntoCorewhen theControllerhas 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
AreBrowserExtensionsEnabledAPI 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.
CoreWebView2CompositionControllerClass:CoreWebView2NonClientRegionChangedEventArgsClass:CoreWebView2NonClientRegionKind Enum
CaptionClientNowhere
CoreWebView2SettingsClass:
- Added the
FailureSourceModulePathproperty to theProcessFailedEventArgstype, 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 withSTATUS_INVALID_IMAGE_HASH.
CoreWebView2ProcessFailedEventArgsClass:
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.
CoreWebView2EnvironmentOptionsClass:CoreWebView2ScrollbarStyle Enum
DefaultFluentOverlay
- Updated the WebMessageObjects API to allow injecting DOM objects into WebView2 content that's constructed via the app and via the
CoreWebView2.PostWebMessageAPI 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.
CoreWebView2Class:CoreWebView2EnvironmentClass:CoreWebView2FileSystemHandleClass:CoreWebView2FileSystemHandleKind Enum
FileDirectory
CoreWebView2FileSystemHandlePermission Enum
ReadOnlyReadWrite
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
ReleaseChannelsto choose which channels are searched for during environment creation, andChannelSearchKindto select a search order.
CoreWebView2EnvironmentOptionsClass:CoreWebView2ChannelSearchKind Enum
MostStableLeastStable
CoreWebView2ReleaseChannels Enum
NoneStableBetaDevCanary
- Added the
FailureSourceModulePathproperty to theProcessFailedEventArgstype, 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 withSTATUS_INVALID_IMAGE_HASH.
CoreWebView2ProcessFailedEventArgsClass:
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
WebResourceRequestedfor workers, which allows setting filters in order to receiveWebResourceRequestedevents for service workers, shared workers, and different-origin iframes.
CoreWebView2Class:CoreWebView2WebResourceRequestedEventArgsClass:
- To support browser extensions in WebView2, added
GetBrowserExtensionsfor WinRT:
Bug fixes
Runtime-only
Fixed a regression that affected handling of the
NewWindowRequestedevent 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
InitiatingOriginproperty ofCoreWebView2LaunchingExternalUriSchemeEventArgshas changed. If theInitiatingOriginis an opaque origin, theInitiatingOriginthat'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 atexample.comopens a subframe that has a different opaque origin, the subframe's precursor origin isexample.com.
CoreWebView2LaunchingExternalUriSchemeEventArgsClass:
- The members of the
CoreWebView2TextureStreamErrorKindenum have been renamed:
Old member names:
- CoreWebView2TextureStreamErrorKind Enum
CoreWebView2TextureStreamErrorNoVideoTrackStartedCoreWebView2TextureStreamErrorTextureErrorCoreWebView2TextureStreamErrorTextureInUse
New member names:
- CoreWebView2TextureStreamErrorKind Enum
NoVideoTrackStartedTextureErrorTextureInUse
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- The
CoreWebView2ControllerOptionsclass now has anAllowHostInputProcessingproperty, which allows user input messages (keyboard, mouse, touch, and pen) to pass through the browser window to be received by an app process window.
CoreWebView2ControllerOptionsClass:
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.
CoreWebView2CompositionControllerClass:CoreWebView2SettingsClass:
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-schemecommand-line switch in a WebView2 browser process.Disabled the global
UserDataFolderregistry key, so that this registry key can only be applied per-app.Fixed the
NewWindowRequestedevent not being fired when opened by a browser extension. (Issue #3841)Fixed the
NewWindowRequestedevent not being fired when opening a view source. (Issue #4162)Fixed an issue to fire
StateChangedandBytesReceivedChangedevents when a download involves navigation.Fixed a bug where the
BeforeUnloaddialog caused the WebView2 window to unexpectedly jump position. (Issue #4350)Fixed an issue where
PrintAsyncprints 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.
ExecuteScriptWithResultprovides exception information if the script failed.TryGetResultAsStringgets the script execution result as a string rather than as JSON, to make it more convenient to interact with string results:
CoreWebView2Class:
Bug fixes
Runtime-only
Ensured that the spellcheck language matches
put_Languageprogrammatically. The customized context menu is also updated with correct spellchecks. (Runtime-only)Fixed a bug that stopped raising the
NavigationCompletedevent 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
ReleaseChannelsto choose which channels are searched for during environment creation, andChannelSearchKindto 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.
CoreWebView2CompositionControllerClass:CoreWebView2SettingsClass:
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
CoreWebView2AcceleratorKeyPressedEventArgshas a newIsBrowserAcceleratorKeyEnabledproperty to allow you to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
CoreWebView2AcceleratorKeyPressedEventArgsClass:
- 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:
CoreWebView2EnvironmentClass:CoreWebView2ProcessExtendedInfoClass:CoreWebView2Class:CoreWebView2FrameClass:CoreWebView2FrameInfoClass:
ExecuteScriptWithResultprovides exception information if the script failed.TryGetResultAsStringgets the script execution result as a string rather than as JSON, to make it more convenient to interact with string results:
CoreWebView2Class:
CreateFromComICoreWebView2wraps an existingICoreWebView2object in aCoreWebView2instance, to allow .NET devs to interact with an control that was created in C++.
CoreWebView2Class:
- To support browser extensions in WebView2, added
GetBrowserExtensionsfor WinRT:
- Added support for
WebResourceRequestedfor workers, which allows setting filters in order to receiveWebResourceRequestedevents for service workers, shared workers, and different origin iframes.
CoreWebView2Class:CoreWebView2WebResourceRequestedEventArgsClass:
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-regionCSS property so that changes to its value trigger a page re-layout. (Runtime-only)Fixed an issue where
put_AreBrowserAcceleratorKeysEnabledwasn't able to update settings for WebView2 when noAcceleratorKeyPressedevent handler is registered. (Runtime-only) (Issue #4278)
SDK-only
Fixed an issue where the WebView2 control in .NET was failing to find the
WebView2Loader.dllon UNC paths. (SDK-only) (Issue #4081)Fixed some issues causing instances of
InvalidOperationExceptionin .NET controls, that weren't helpful to developers. (SDK-only) (Issue #4272)
See also
- About Release Notes for the WebView2 SDK
- Archived Release Notes for the WebView2 SDK
- Overview of WebView2 features and APIs - outlines many of the APIs, by feature area, that are in Release SDK packages.
- Contacting the Microsoft Edge WebView2 team
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for