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.2903.40
Release Date: November 18, 2024
NuGet package for WebView2 SDK 1.0.2903.40
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 131.0.2903.40 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
Control whether the screen capture UI is shown (ScreenCaptureStarting event)
Added a new ScreenCaptureStarting
event. This event is raised whenever the WebView2 and/or iframe that corresponds to the CoreWebView2Frame
(or to any of its descendant iframes) requests permission to use the Screen Capture API before the UI is shown. The app can then block the UI from being displayed, or allow the UI to be displayed.
CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2NonClientRegionKind
Enum:
Bug fixes
Runtime-only
- Allowed the Download dialog to receive initial focus on launch.
1.0.2950-prerelease
Release Date: November 18, 2024
NuGet package for WebView2 SDK 1.0.2950-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 132.0.2950.0 or higher.
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-only
- Allowed the Download dialog to receive initial focus on launch.
- Fixed a crash while cancelling navigation to certain sites in
FrameNavigationStarting
. (Issue #4843) - Postponed customizing the context menu when the touch selection menu is being displayed. (Issue #4737)
SDK-only
- Added Arm64ec support.
- Fixed an issue where WebView2 running in "Window to Visual" mode couldn't receive accelerator input.
1.0.2849.39
Release Date: October 21, 2024
NuGet package for WebView2 SDK 1.0.2849.39
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 130.0.2849.39 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
Configure the security warning when saving a file (SaveFileSecurityCheckStarting
event)
Added a new SaveFileSecurityCheckStarting
event. Your app can register a handler on this event to get the file path, filename extension, and document origin URI information. You can then apply your own rules to do actions such as the following:
- Allow saving the file without presenting a default security-warning UI about the file-type policy.
- Cancel the saving.
- Create your own UI to manage runtime file-type policies.
CoreWebView2
Class:CoreWebView2SaveFileSecurityCheckStartingEventArgs Class
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method
Bug fixes
Runtime-only
- Fixed a Download dialog focus issue when pressing Tab or Shift+Tab to switch into the Webview2 control.
SDK-only
- Using
CoreWebView2.AddWebResourceRequestedFilter
without aCoreWebView2WebResourceRequestSourceKinds
parameter is now deprecated. See the .NET CoreWebView2.AddWebResourceRequestedFilter Method. - Added the .NET 8
TargetFramework
for C# WinRT, enabled AOT (ahead-of-time) compatibility, and disabled runtime marshalling.
1.0.2895-prerelease
Release Date: October 21, 2024
NuGet package for WebView2 SDK 1.0.2895-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 131.0.2895.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
RestartRequested
event when WebView2 needs to restart
Added a new RestartRequested
event. The RestartRequested
event is raised whenever WebView2 needs to restart to apply updates or configuration changes. You can use this API to detect when WebView2 needs to restart, and take appropriate actions. The Priority
property of the RestartRequested
event arguments indicates the priority of the restart request:
High
indicates that the app should prompt users to restart as soon as possible.Normal
indicates that the app should remind users to restart, on a best-effort basis.
CoreWebView2Environment
Class:CoreWebView2RestartRequestedEventArgs
Class:CoreWebView2RestartRequestedPriority Enum
CoreWebView2RestartRequestedPriority.Normal
CoreWebView2RestartRequestedPriority.High
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Control whether the screen capture UI is shown (ScreenCaptureStarting
event)
Added a new ScreenCaptureStarting
event. This event is raised whenever the WebView2 and/or iframe that corresponds to the CoreWebView2Frame
(or to any of its descendant iframes) requests permission to use the Screen Capture API before the UI is shown. The app can then block the UI from being displayed, or allow the UI to be displayed.
CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2ScreenCaptureStartingEventArgs
Class:
Configure the security warning when saving a file (SaveFileSecurityCheckStarting
event)
Added a new SaveFileSecurityCheckStarting
event. Your app can register a handler on this event to get the file path, filename extension, and document origin URI information. You can then apply your own rules to do actions such as the following:
- Allow saving the file without presenting a default security-warning UI about the file-type policy.
- Cancel the saving.
- Create your own UI to manage runtime file-type policies.
CoreWebView2
Class:CoreWebView2SaveFileSecurityCheckStartingEventArgs Class
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method
Bug fixes
SDK-only
- Fixed Arm64 incompatibility with WindowsAppSDK 1.6.
- Removed extra
WebView2Loader.dll
in WinAppSDK case. - Using
CoreWebView2.AddWebResourceRequestedFilter
without aCoreWebView2WebResourceRequestSourceKinds
parameter is now deprecated. See the .NET CoreWebView2.AddWebResourceRequestedFilter Method.
1.0.2792.45
Release Date: September 23, 2024
NuGet package for WebView2 SDK 1.0.2792.45
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 129.0.2792.45 or higher.
Promotions
No additional APIs have been promoted to Stable and added in this Release SDK.
Bug fixes
SDK-only
- Fixed an SDK dependency for .NET projects. (Issue #4743)
1.0.2839-prerelease
Release Date: September 23, 2024
NuGet package for WebView2 SDK 1.0.2839-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 130.0.2839.0 or higher.
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-only
- Fixed an issue where focusing on a WebView2 control in WinAppSDK with the Windows "Scroll inactive windows" setting disabled caused scrolling to fail.
- Blocked
edge://wallet
in WebView2. (Issue #4710) - Cleared the environment variable for default background color in .NET WebView2 controls after the controller has finished creation.
- Enabled accessibility support for Webview2 in visual hosting mode.
- Fixed a bug with removing a "web resource requested" filter for multiple sources when one of them is Document.
- Fixed a regression where
DataList
was not visible in WinUI or in other visually hosted WebView2 instances.
SDK-only
- Fixed an SDK dependency for .NET projects. (Issue #4743)
- Fixed a compatibility issue when calling
GetAvailableBrowserVersionString()
with an olderWebView2Loader.dll
. (Issue #4395) - Fixed issues when compiling wv2winrt-generated code with the
cpp20
and/permissive-
options. - Added the .NET 8
TargetFramework
for C# WinRT, enabled AOT (ahead-of-time) compatibility, and disabled runtime marshalling.
1.0.2739.15
Release Date: August 26, 2024
NuGet package for WebView2 SDK 1.0.2739.15
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 128.0.2739.15 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
Web notification handling
Added support for Web Notification, for non-persistent notifications. The NotificationReceived
event for CoreWebView2
controls web notification handling, allowing customization or suppression by the host app. Unhandled notifications default to WebView2's UI.
CoreWebView2
Class:CoreWebView2Notification Class
- CoreWebView2Notification.BadgeUri Property
- CoreWebView2Notification.Body Property
- CoreWebView2Notification.BodyImageUri Property
- CoreWebView2Notification.Direction Property
- CoreWebView2Notification.IconUri Property
- CoreWebView2Notification.IsSilent Property
- CoreWebView2Notification.Language Property
- CoreWebView2Notification.RequiresInteraction Property
- CoreWebView2Notification.ShouldRenotify Property
- CoreWebView2Notification.Tag Property
- CoreWebView2Notification.Timestamp Property
- CoreWebView2Notification.Title Property
- CoreWebView2Notification.VibrationPattern Property
- CoreWebView2Notification.ReportClicked Method
- CoreWebView2Notification.ReportClosed Method
- CoreWebView2Notification.ReportShown Method
- CoreWebView2Notification.CloseRequested Event
CoreWebView2TextDirectionKind Enum
Default
LeftToRight
RightToLeft
Save as
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.Kind Property
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog Property
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method
Bug fixes
There are no bug fixes in this Release SDK.
1.0.2783-prerelease
Release Date: August 26, 2024
NuGet package for WebView2 SDK 1.0.2783-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 129.0.2783.0 or higher.
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
- Re-enabled the default behavior of
SetUserAgent
: by default,SetUserAgent
is effective for cross-origin iframes.
Runtime-only
Enabled the interactive dragging feature by default. See
edge-webview-interactive-dragging
in WebView2 browser flags.Disabled
IsolateSandboxedIframes
for WebView2.Fixed an issue where WebView creation fails when multiple instances are launched at the same time. (Issue #4731)
Fixed a bug in WinRT JavaScript projection where caching existing properties in objects whose name contains
Proxy
orFunction
caused an error due to name collision.Fixed a bug where the WebView2 control became the wrong size after disconnecting and reconnecting a monitor.
Fixed an issue where "mailto:" links leave an untitled popup window open, instead of automatically closing the popup window.
SDK-only
C# WinRT projection now works on UWP.
Fixed an issue to ensure that
GeneratedFilesDir
no longer appears in Visual Studio for C# WinRT projection.
1.0.2651.64
Release Date: August 13, 2024
NuGet package for WebView2 SDK 1.0.2651.64
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 127.0.2651.64 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release 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 (CoreWebView2FileSystemHandle
) 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
Bug fixes
Runtime-only
- Fixed a regression where
WebResourceRequested
events crash on certain sites. (Issue #4602)
SDK-only
- Fixed x86 for WinRT C# projection.
1.0.2730-prerelease
Release Date: August 7, 2024
NuGet package for WebView2 SDK 1.0.2730-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 128.0.2730.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added new Throttling Controls APIs which allows for efficient resource management by allowing you to throttle JavaScript timers. This is helpful in scenarios where a WebView2 control needs to remain visible, but needs to consume fewer resources (such as when the user isn't interacting with the content). These Throttling Controls APIs allow you to:
- Customize script timers (
setTimeout
andsetInterval
) throttling under different page states (foreground, background, and background with intensive throttling). - Throttle script timers in select hosted iframes.
- Customize script timers (
CoreWebView2Frame
Class:CoreWebView2Settings
Class:
Promotions
The following APIs have been promoted from Experimental to Stable 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:-
Default
HtmlOnly
SingleFile
Complete
CoreWebView2SaveAsUIResult Enum
Success
InvalidPath
FileAlreadyExists
KindNotSupported
Cancelled
CoreWebView2SaveAsUIShowingEventArgs Class
- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace Property
- CoreWebView2SaveAsUIShowingEventArgs.Cancel Property
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType Property
- CoreWebView2SaveAsUIShowingEventArgs.Kind Property
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog Property
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method
- Added support for Web Notification, for non-persistent notifications. The
NotificationReceived
event forCoreWebView2
controls web notification handling, allowing customization or suppression by the host app. Unhandled notifications default to WebView2's UI.
Bug fixes
Runtime-only
Fixed an issue where the app window couldn't be controlled via system commands (such as Alt+F4 or Alt+Spacebar) when the focus was in WebView2 for Visual hosting mode. (Issue #2961)
Fixed a bug in WebView2 UWP where the Find bar couldn't be clicked into from the host app.
SDK-only
Adding the missing WinRT
CoreWebView2Notification.VibrationPattern
API. This WinRT API can be combined with the stable notification API promotion release notes; see "Web Notification" andNotificationReceived
for WinRT, immediately above.Fixed an issue where
KeyDown
events from the WinForms WebView2 control didn't include the correctModifierKeys
information. (Issue #1216)Fixed x86 for WinRT C# projection.
Made
CreateCoreWebView2Environment
andGetAvailableCoreWebView2BrowserVersionString
more robust against potential race condition during Runtime update.
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