Training
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
These Release Notes provide information about new features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK.
Release Date: February 10, 2025
NuGet package for WebView2 SDK 1.0.3065.39
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 133.0.3065.39 or higher.
No additional APIs have been promoted to Stable and added in this Release SDK.
Release Date: February 10, 2025
NuGet package for WebView2 SDK 1.0.3116-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 134.0.3116.0 or higher.
No Experimental APIs have been added in this Prerelease SDK.
No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
CoreWebView2Find.FindNext
method that incorrectly mentioned FindPrevious
. The method summary now mentions FindNext
instead. (Issue #5059)Release Date: January 20, 2025
NuGet package for WebView2 SDK 1.0.2957.106
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 132.0.2957.106 or higher.
The following APIs have been promoted to Stable and are now included in this Release SDK.
The WebView2CompositionControl
prevents the WebView2 control from being the topmost layer in a WPF app and obscuring any WPF elements. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl
is a drop-in replacement for the standard WPF WebView2 control. Both the WebView2 control and WebView2CompositionControl
implement the Microsoft.Web.WebView2.Wpf.IWebView2
interface. Both of them derive from FrameworkElement
, as follows:
FrameworkElement
-> HwndHost
-> WebView2
.FrameworkElement
-> Control
-> WebView2CompositionControl
.Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).
This issue occurs because the WPF control uses the WPF HwndHost
to host the Win32 WebView2 control, and HwndHost
has an issue with airspace.
See also:
WebView2CompositionControl
where it's not displayed if it's initialized with size (0,0), such as when it's initialized in a TabItem
of a TabControl
. (Issue #4941)Release Date: January 24, 2025
NuGet package for WebView2 SDK 1.0.3079-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 134.0.3079.0 or higher.
The following Experimental APIs have been added in this Prerelease SDK.
The Find API allows you to programmatically control Find operations, and enables adding the following functionality to your app:
There are known issues with the Find API for PDF documents. When you view a PDF document within a WebView2 control, the Find feature currently only provides the first index and the number of matches found. For example, if the string occurs three times in a PDF, the UI would say 1/3 and would not support programmatically calling Next or Previous. We are actively investigating these issues, and we encourage you to report any problems you encounter, by using the WebView2Feedback repo.
The DragStarting
API overrides the default drag and drop behavior when running in visual hosting mode. The DragStarting
event notifies your app when the user starts a drag operation in the WebView2, and provides the state that's necessary to override the default WebView2 drag operation with your own logic.
DragStarting
on the ICoreWebView2ExperimentalCompositionController6
to add an event handler that's invoked when the drag operation is starting.ICoreWebView2ExperimentalDragStartingEventArgs
to start your own drag operation.
GetDeferral
method to execute any async drag logic and call back into the WebView at a later time.Handled
property to let the WebView2 know whether to use its own drag logic.The FrameCreatedEvent API supports nested iframes, such as recording the navigation history for a second-level iframe. Without this API, WebView2 only tracks first-level iframes, which are the direct child iframes of the main frame. Using this API, your app can subscribe to the nested iframe creation event, giving the app access to all properties, methods, and events of CoreWebView2Frame
for the nested iframe.
Use this API to manage iframe tracking on a page that contains multiple levels of iframes. You can choose to track any of the following:
CoreWebView2Frame
Class:
The DefaultBackgroundColor API allows users to set the DefaultBackgroundColor
property at initialization. This prevents a disruptive white flash during the WebView2 loading process.
CoreWebView2ControllerOptions
Class:
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
The WebView2CompositionControl
prevents the WebView2 control from being the topmost layer in a WPF app and obscuring any WPF elements. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl
is a drop-in replacement for the standard WPF WebView2 control. Both the WebView2 control and WebView2CompositionControl
implement the Microsoft.Web.WebView2.Wpf.IWebView2
interface. Both of them derive from FrameworkElement
, as follows:
FrameworkElement
-> HwndHost
-> WebView2
.FrameworkElement
-> Control
-> WebView2CompositionControl
.Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).
This issue occurs because the WPF control uses the WPF HwndHost
to host the Win32 WebView2 control, and HwndHost
has an issue with airspace.
See also:
IsolateSandboxedIframes
upstream feature for WebView2.CleanUpSome
API in Hostobject
now only does garbage collection for the full heap. CleanUpSome
has been removed from the V8 engine.AreBrowserAcceleratorKeysEnabled
. (Issue #5033)IsDefaultDownloadDialogOpenChanged
wasn't triggered when a dialog is closed by using the keyboard. (Issue #4807)WebView2CompositionControl
where it's not displayed if it's initialized with size (0,0), such as when it's initialized in a TabItem
of a TabControl
. (Issue #4941)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.
The following APIs have been promoted to Stable and are now included in this Release SDK.
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:
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.
No Experimental APIs have been added in this Prerelease SDK.
No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
FrameNavigationStarting
. (Issue #4843)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.
The following APIs have been promoted to Stable and are now included in this Release SDK.
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:
CoreWebView2
Class:
CoreWebView2SaveFileSecurityCheckStartingEventArgs Class
CoreWebView2.AddWebResourceRequestedFilter
without a CoreWebView2WebResourceRequestSourceKinds
parameter is now deprecated. See the .NET CoreWebView2.AddWebResourceRequestedFilter Method.TargetFramework
for C# WinRT, enabled AOT (ahead-of-time) compatibility, and disabled runtime marshalling.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.
The following Experimental APIs have been added in this Prerelease SDK.
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
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
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:
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:
CoreWebView2
Class:
CoreWebView2SaveFileSecurityCheckStartingEventArgs Class
WebView2Loader.dll
in WinAppSDK case.CoreWebView2.AddWebResourceRequestedFilter
without a CoreWebView2WebResourceRequestSourceKinds
parameter is now deprecated. See the .NET CoreWebView2.AddWebResourceRequestedFilter Method.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.
No additional APIs have been promoted to Stable and added in this Release SDK.
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.
No Experimental APIs have been added in this Prerelease SDK.
No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
edge://wallet
in WebView2. (Issue #4710)DataList
was not visible in WinUI or in other visually hosted WebView2 instances.GetAvailableBrowserVersionString()
with an older WebView2Loader.dll
. (Issue #4395)cpp20
and /permissive-
options.TargetFramework
for C# WinRT, enabled AOT (ahead-of-time) compatibility, and disabled runtime marshalling.Training
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Documentation
About Release Notes for the WebView2 SDK - Microsoft Edge Developer documentation
About Release Notes for Microsoft Edge WebView2, covering new features, APIs, and fixes for Win32, WPF, and WinForms.
Archived Release Notes for the WebView2 SDK - Microsoft Edge Developer documentation
Release Notes for older releases of Microsoft Edge WebView2, covering new features, APIs, and fixes for Win32, WPF, and WinForms.
WebView2 Roadmap - Microsoft Edge Developer documentation
Learn about what's coming next for WebView2.