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.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, andChannelSearchKind
to select a search order.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels Enum
None
Stable
Beta
Dev
Canary
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.
CoreWebView2
Class:-
Complete
Default
HtmlOnly
SingleFile
CoreWebView2SaveAsUIResult Enum
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs
Class:- 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.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
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 returningNowhere
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 wasfalse
.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 inNewWindowRequested
. (Issue #4181)Fixed a crash that can occur in WPF
TabIntoCore
when theController
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.
CoreWebView2CompositionController
Class:CoreWebView2NonClientRegionChangedEventArgs
Class:CoreWebView2NonClientRegionKind Enum
Caption
Client
Nowhere
CoreWebView2Settings
Class:
- Added the
FailureSourceModulePath
property to theProcessFailedEventArgs
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 withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
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.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
- 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.
CoreWebView2
Class:CoreWebView2Environment
Class:CoreWebView2FileSystemHandle
Class:CoreWebView2FileSystemHandleKind Enum
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
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, andChannelSearchKind
to select a search order.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels Enum
None
Stable
Beta
Dev
Canary
- Added the
FailureSourceModulePath
property to theProcessFailedEventArgs
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 withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
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 receiveWebResourceRequested
events for service workers, shared workers, and different-origin iframes.
CoreWebView2
Class:CoreWebView2WebResourceRequestedEventArgs
Class:
- 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 ofCoreWebView2LaunchingExternalUriSchemeEventArgs
has changed. If theInitiatingOrigin
is an opaque origin, theInitiatingOrigin
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 atexample.com
opens a subframe that has a different opaque origin, the subframe's precursor origin isexample.com
.
CoreWebView2LaunchingExternalUriSchemeEventArgs
Class:
- The members of the
CoreWebView2TextureStreamErrorKind
enum have been renamed:
Old member names:
- CoreWebView2TextureStreamErrorKind Enum
CoreWebView2TextureStreamErrorNoVideoTrackStarted
CoreWebView2TextureStreamErrorTextureError
CoreWebView2TextureStreamErrorTextureInUse
New member names:
- CoreWebView2TextureStreamErrorKind Enum
NoVideoTrackStarted
TextureError
TextureInUse
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- The
CoreWebView2ControllerOptions
class now has anAllowHostInputProcessing
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.
CoreWebView2ControllerOptions
Class:
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.
CoreWebView2CompositionController
Class:CoreWebView2Settings
Class:
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
andBytesReceivedChanged
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:
CoreWebView2
Class:
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, andChannelSearchKind
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.
CoreWebView2CompositionController
Class:CoreWebView2Settings
Class:
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
CoreWebView2AcceleratorKeyPressedEventArgs
has a newIsBrowserAcceleratorKeyEnabled
property to allow you to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Class:
- 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:
CoreWebView2Environment
Class:CoreWebView2ProcessExtendedInfo
Class:CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2FrameInfo
Class:
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:
CoreWebView2
Class:
CreateFromComICoreWebView2
wraps an existingICoreWebView2
object in aCoreWebView2
instance, to allow .NET devs to interact with an control that was created in C++.
CoreWebView2
Class:
- To support browser extensions in WebView2, added
GetBrowserExtensions
for WinRT:
- Added support for
WebResourceRequested
for workers, which allows setting filters in order to receiveWebResourceRequested
events for service workers, shared workers, and different origin iframes.
CoreWebView2
Class:CoreWebView2WebResourceRequestedEventArgs
Class:
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 noAcceleratorKeyPressed
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:
CoreWebView2EnvironmentOptions
Class:CoreWebView2Profile
Class:
- 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:
CoreWebView2Environment
Class:CoreWebView2ProcessExtendedInfo
Class:CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2FrameInfo
Class:
ICoreWebView2AcceleratorKeyPressedEventArgs
has a newIsBrowserAcceleratorKeyEnabled
property to allow developers to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Class:
- Added support for managing profile deletion:
CoreWebView2Profile
Class:
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:
CoreWebView2NewWindowRequestedEventArgs
Class:
- For WinRT, options have been added to manage custom scheme registration when creating a
CoreWebView2Environment
:
CoreWebView2CustomSchemeRegistration
Class:CoreWebView2EnvironmentOptions
Class:
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:
- CoreWebView2BrowserExtension Class
CoreWebView2EnvironmentOptions
Class:CoreWebView2Profile
Class:
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 theProcessFailedEventArgs
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 withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
Bug fixes
- Added support for additional page settings (
PageRange
andPagesPerSheet
) 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 theNewWindow
is set tonull
. (Runtime-only)
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
https://aka.ms/ContentUserFeedback.
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:Submit and view feedback for