Archived Release Notes for the WebView2 SDK

These Release Notes provide information about added features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK, for older releases.

1.0.3179.45

Release Date: April 07, 2025

NuGet package for WebView2 SDK 1.0.3179.45

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

Promotions

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

Bug fixes

Runtime-only

• Fixed the HTML Select element (<select>) to make it selectable, in WPF apps.
• Fixed navigation of edge://crashes within a WebView2 control.
• Fixed potential crash and UI issues when invoking the Windows Credentials UI from a WebView2 instance.
• Fixed a bug where users were unable to type in an input field with autofill info. (Issue #5144)

1.0.3230-prerelease

Release Date: April 07, 2025

NuGet package for WebView2 SDK 1.0.3230-prerelease

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

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

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

Track navigation history for nested iframes (FrameCreatedEvent API)

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:

• Only the main page and first-level iframes (the default behavior).
• A partial WebView2 frames tree with specific iframes of interest.
• The full WebView2 frames tree.

Bug fixes

Runtime-only

• Fixed an issue in WPF where the <datalist> dropdown closed when the mouse moved outside the WebView2 control bounds.
• Fixed navigation of edge://crashes within a WebView2 control.
• Fixed the HTML Select element (<select>) to make it selectable, in WPF apps.
• Fixed potential crash and UI issues when invoking the Windows Credentials UI from a WebView2 instance.
• Fixed bug where users unable to type in input field with autofill info. (Issue #5144)
• Fixed a regression in the Status bar APIs.

SDK-only

• Fixed Tab, Shift+Tab, and Arrow keys in Window to Visual hosting mode.

1.0.3124.44

Release Date: March 10, 2025

NuGet package for WebView2 SDK 1.0.3124.44

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

Promotions

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

Bug fixes

Runtime-only

• Extensions won't get disabled in WebView2 by using AddBrowserExtensionAsync, regardless of whether developer mode is on. (Issue #5113)
• Disabled background update of network time. (Issue #5047)
• Fixed the download popup not being displayed when target="_blank". (Issue #5063)

1.0.3171-prerelease

Release Date: March 10, 2025

NuGet package for WebView2 SDK 1.0.3171-prerelease

For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 135.0.3171.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

• Fixed host object async method exception handling. (Issue #3402)
• Fixed documentation for CoreWebVIew2.Navigate. (Issue #5091)

Runtime-only

• Fixed an "Add to Chrome" store installation regression.
• Fixed folder uploads in UWP and WinUI. (Issue #3275)
• Extensions won't get disabled in WebView2 by using AddBrowserExtensionAsync, regardless of whether developer mode is on. (Issue #5113)
• Disabled background update of network time. (Issue #5047)
• Fixed the download popup not being displayed when target="_blank". (Issue #5063)

SDK-only

• Fixes a crash that could occur when the Garbage Collector calls Finalize on a thread other than the main thread.

1.0.3065.39

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.

Promotions

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

Bug fixes

Runtime-only

• Added the missing Close button in the Download flyout.
• Fixed a race condition that occurred when the Web Request Response event never occurs.

1.0.3116-prerelease

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.

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

• Added the missing Close button in the Download flyout.
• Fixed a race condition that occurred when the Web Request Response event never occurs.

SDK-only

• Fixed .NET and Win32 documentation of the CoreWebView2Find.FindNext method that incorrectly mentioned FindPrevious. The method summary now mentions FindNext instead. (Issue #5059)

1.0.2957.106

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.

Promotions

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

Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)

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:

• Mitigating Airspace Issues In WPF Applications
• WPF Airspace - WebView2CompositionControl - Spec.

Bug fixes

Runtime-only

• Fixed a regression where display changes can cause WebView2 to render smaller than the app window.

SDK-only

• Fixed an issue in the WPF 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)

1.0.3079-prerelease

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.

Experimental APIs

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

Customize the Find behavior (Find API)

The Find API allows you to programmatically control Find operations, and enables adding the following functionality to your app:

• Customize Find options, including Find Term, Case Sensitivity, Word Matching, Match Highlighting, and Default UI Suppression.
• Find text strings and navigate among them within a WebView2 control.
• Programmatically initiate Find operations, and navigate Find results.
• Suppress the default Find UI.
• Track the status of Find operations.

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.

Customize the drag and drop behavior (DragStarting API)

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.

• Use DragStarting on the ICoreWebView2ExperimentalCompositionController6 to add an event handler that's invoked when the drag operation is starting.
• Use ICoreWebView2ExperimentalDragStartingEventArgs to start your own drag operation.
  • Use the GetDeferral method to execute any async drag logic and call back into the WebView at a later time.
  • Use the Handled property to let the WebView2 know whether to use its own drag logic.

Track navigation history for nested iframes (FrameCreatedEvent API)

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:

• Only the main page and first-level iframes (the default behavior).
• A partial WebView2 frames tree with specific iframes of interest.
• The full WebView2 frames tree.

Set default background color on WebView2 initialization (DefaultBackgroundColor API)

The DefaultBackgroundColor API allows users to set the DefaultBackgroundColor property at initialization. This prevents a disruptive white flash during the WebView2 loading process.

Promotions

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

Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)

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:

• Mitigating Airspace Issues In WPF Applications
• WPF Airspace - WebView2CompositionControl - Spec.

Bug fixes

Runtime-only

• Fixed a regression where display changes can cause WebView2 to render smaller than app window.
• Enabled the IsolateSandboxedIframes upstream feature for WebView2.
• Prevented deleting a service worker when the version changes.
• The CleanUpSome API in Hostobject now only does garbage collection for the full heap. CleanUpSome has been removed from the V8 engine.
• Fixed a regression of AreBrowserAcceleratorKeysEnabled. (Issue #5033)
• Fixed a bug where IsDefaultDownloadDialogOpenChanged wasn't triggered when a dialog is closed by using the keyboard. (Issue #4807)

SDK-only

• Fixed an issue in the WPF 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)

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.

Bug fixes

Runtime-only

• Allowed the Download dialog to receive initial focus on launch.

General changes

• The Microsoft Edge WebView2 Runtime is no longer listed in Windows Settings > Apps > Installed apps, because it is a persistent system component.

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.

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 a CoreWebView2WebResourceRequestSourceKinds 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.

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.

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.

Bug fixes

SDK-only

• Fixed Arm64 incompatibility with WindowsAppSDK 1.6.
• Removed extra WebView2Loader.dll in WinAppSDK case.
• Using CoreWebView2.AddWebResourceRequestedFilter without a CoreWebView2WebResourceRequestSourceKinds 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 older WebView2Loader.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.

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.

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 or Function 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.

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 and setInterval) throttling under different page states (foreground, background, and background with intensive throttling).
  • Throttle script timers in select hosted iframes.

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.

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

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" and NotificationReceived for WinRT, immediately above.

• Fixed an issue where KeyDown events from the WinForms WebView2 control didn't include the correct ModifierKeys information. (Issue #1216)

• Fixed x86 for WinRT C# projection.

• Made CreateCoreWebView2Environment and GetAvailableCoreWebView2BrowserVersionString more robust against potential race condition during Runtime update.

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

• Disabled BreakoutBoxPreferCaptureTimestampInVideoFrame for WebView2 TextureStream.

• Fixed a regression where the 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 the host.

• Fixed a bug where the autofill popup dismisses immediately and causes a focus change.

• Fixed a bug where WebView2 fails to load because of 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, this 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 security-warning UI about the file-type policy.
  • 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 to 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 GetComICoreWebView2 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:

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)

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

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:

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, and ChannelSearchKind 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.

Promotions

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

• CoreWebView2AcceleratorKeyPressedEventArgs has a new IsBrowserAcceleratorKeyEnabled property to allow you to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:

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

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

• CreateFromComICoreWebView2 wraps an existing ICoreWebView2 object in a CoreWebView2 instance, to allow .NET devs to interact with an control that was created in C++.

• To support browser extensions in WebView2, added GetBrowserExtensions for WinRT:

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

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 no AcceleratorKeyPressed 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

Promotions

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

• Support for browser extensions in WebView2:

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

• ICoreWebView2AcceleratorKeyPressedEventArgs has a new IsBrowserAcceleratorKeyEnabled property to allow developers to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:

• Added support for managing profile deletion:

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

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:

• For WinRT, options have been added to manage custom scheme registration when creating a CoreWebView2Environment:

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:

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

• Added support for additional page settings (PageRange and PagesPerSheet) 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 the NewWindow is set to null. (Runtime-only)

1.0.2045.28

Release Date: September 18, 2023

NuGet package for WebView2 SDK 1.0.2045.28

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

Promotions

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

Bug fixes

• Disabled the Mouse Gesture feature by default. (Runtime-only) (Issue #3737)

• Fixed a bug where mouse wheel scrolling was intermittently broken for visual hosting. (Runtime-only)

• Fixed a bug where downloading APK files in WebView2 crashes the WebView2 browser process. (Runtime-only) (Issue #3569)

1.0.2106-prerelease

Release Date: September 20, 2023

NuGet package for WebView2 SDK 1.0.2106-prerelease

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

Experimental APIs

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

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

Promotions

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

• For WinRT, options have been added to manage custom scheme registration when creating a CoreWebView2Environment:

• Added source frame info to the NewWindowRequested event arguments, to identify the source of the request:

Bug fixes

Runtime

• Updated the Screen Capture UI to remove mention of tabs. (Runtime-only)

• Fixed a bug where PrintAsync doesn't print using the default DPI on the printer. (Runtime-only) (Issue #3709)

• Fix a WebView creation failure when app is running as a different admin user. (Runtime-only) (Issue #3738)

• Fixed a bug that prevented setting an automation name for the WebView2 control on WinUI 3. (Runtime-only)

• Enabled the new inter-process communication implementation for apps that are using very old SDKs. (Runtime-only)

SDK

• Fixed a bug where the CoreWebView2EnvironmentOptions.Language property doesn't change the accept-language HTTP header. (SDK-only) (Issue #3635)

• Added support for longer runtime installation paths. (SDK-only)

• The custom URI scheme registration API now works in WinRT. For API names and links, in the Promotions section above, see the "custom scheme registration" entry. (SDK-only)

Runtime and SDK

• Fixed a bug where the Runtime exits unexpectedly when calling SetPermissionState with an invalid enum value. (Runtime and SDK)

1.0.1938.49

Release Date: August 28, 2023

NuGet package for WebView2 SDK 1.0.1938.49

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

Promotions

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

Bug fixes

• Fixed a handle tracking bug where TextureStream API usage could fail. (Runtime-only)

• Fixed a bug where a WebView2 created in a background thread doesn't come to the foreground when created. (Runtime-only) (Issue #3584)

• Fixed a bug where the WebView2 content sometimes renders at the incorrect size after changing the display configuration (such as laptop sleeping; remoting; or connecting or disconnecting an external display). (Runtime-only) (Issue 3429)

• Fixed a bug where a bluescreen happens when using WebView2 apps on certain hardware configurations. (Runtime-only) (Issue #3679)

1.0.2065-prerelease

Release Date: August 30, 2023

NuGet package for WebView2 SDK 1.0.2065-prerelease

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

Experimental APIs

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

• Added source frame info to NewWindowRequested, to support identifying the source:

Bug fixes

• Disabled installing CRX in WebView2. (Runtime-only)

• Fixed an initialization failure when the app has a DPI awareness compatibility setting applied. (Runtime-only) (Issue #3008)

• Fixed a bug where visual hosted owned windows couldn't take character input. (Runtime-only)

1.0.1901.177

Release Date: July 24, 2023

NuGet package for WebView2 SDK 1.0.1901.177

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

Promotions

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

• NavigationKind gets the navigation kind of each navigation, such as Back/Forward, Reload, or navigation to a new document.

• The ServiceWorkers enum value in the BrowsingDataKinds enum specifies service workers that are registered for an origin.

Bug fixes

• Fixed a bug where the entire toolbar is blank when hiding the Bookmarks, Search, and PageSelector buttons simultaneously. (Runtime-only) Issue 2866

1.0.1988-prerelease

Release Date: July 24, 2023

NuGet package for WebView2 SDK 1.0.1988-prerelease

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

Experimental APIs

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

• Supports desktop notifications through WebView2:

• Supports monitoring iframe's runtime memory usage by getting process info details of iframes.

• Supports extensions in WebView2.

• The TextDirectionKind enum specifies the text direction as left to right or right to left.

Bug fixes

• Fixed a CoreWebView2Frame.ExecuteScriptAsync hang that occurred when a frame was destroyed during script execution. Issue 3124

• Fixed a COMException when reading WebResourceResponse content after a redirect. Issue 3229

• Fixed a regression where calling CoreWebView2.AddHostObjectToScript twice for the same name hangs. (Runtime-only) Issue 3539

• Fixed an issue where PrintAsync fails when PrinterName contains Chinese characters. Issue 3379

• Fixed an issue to disable the context menu in print pages when AreDefaultContextMenusEnabled is set to false. Issue 3548

• Removed visual search from the web capture context menu. (Runtime-only) Issue 3426

• Fixed an issue that caused PrintAsync and PrintToPdfStreamAsync to fail when print settings are null.

• Removed the Launch game button from the default No Internet Connection error page. (Runtime-only)

• Fixed an issue to ensure that WebVivew2Loader can be loaded from a UNC path. Issue 3465

• Fixed invalid CoreWebView2PdfToolbarItems.FullScreen and CoreWebView2PdfToolbarItems.MoreSettings.

• Added a lock for host object access from multithread. (Runtime-only)

• Fixed configuration options that (CoreWebView2PdfToolbarItems.MoreSettings, CoreWebView2PdfToolbarItems.FullScreen) are not valid in PDF preview mode. Issue 3324

• Removed the Hide all annotations option in PDF Settings and more. (Runtime-only)

• Removed the Show all saved passwords context menu item. (Runtime-only)

1.0.1823.32

Release Date: June 5, 2023

NuGet package for WebView2 SDK 1.0.1823.32

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

Promotions

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

• The LaunchingExternalUriScheme event is raised when there's an attempt to launch a URI scheme that is registered with the OS (an external URI scheme).

• MemoryUsageTargetLevel specifies memory consumption levels, such as low or normal.

• Enhanced support for multiple profiles, to allow configuring General Autofill and Password Autosave settings for different profiles.

1.0.1905-prerelease

Release Date: June 12, 2023

NuGet package for WebView2 SDK 1.0.1905-prerelease

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

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

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

• NavigationKind gets the navigation kind of each navigation, such as Back/Forward, Reload, or navigation to a new document.

• The ServiceWorkers enum value in the BrowsingDataKinds enum specifies service workers that are registered for an origin.

• The LaunchingExternalUriScheme event is raised when there's an attempt to launch a URI scheme that is registered with the OS (an external URI scheme).

• MemoryUsageTargetLevel specifies memory consumption levels, such as low or normal.

Bug fixes

• Using wv2winrt webhosthidden entered an infinite loop when enumerating some webhosthidden types. (SDK-only)

• In code that's generated by the wv2winrt tool, when calling an async method, it would crash if it succeeded but returned null instead of an IAsyncAction. (SDK-only)

1.0.1774.30

Release Date: May 8, 2023

NuGet package for WebView2 SDK 1.0.1774.30

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

Promotions

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

• The File API allows accessing a DOM File object passed via WebMessage.

• The Profile Cookie Manager API supports profile management. The CookieManager property enables the host app to get the cookie manager for the profile.

Bug fixes

• Fixed an issue to allow an app to inject initial scripts by calling AddScriptToExecuteOnDocumentCreated before a new window is created. (Issue #2491)

• Fixed an issue that was causing the X-Edge-Shopping-Flag header to be added to web requests that are coming from WebView2. (Runtime-only) (Issue #3365)

1.0.1829-prerelease

Release Date: May 8, 2023

NuGet package for WebView2 SDK 1.0.1829-prerelease

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

Promotions

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

• Enhanced support for multiple profiles, to allow configuring General Autofill and Password Autosave settings for different profiles.

Bug fixes

• Disabled the Chrome Web Store info banner that displays the option to allow extensions installation. (Issue #3312)

• Fixed an issue where a custom menu item wasn't firing. (Issue #3300)

• Fixed a crash during initialization when creating a WebView2 using WPF and SDK version 1.0.1722.32, which is now deprecated. (See SDK 1.0.1722.32 is deprecated below.) (Issue #3375)

• Fixed a bug in PostSharedBufferToScript that stops after about 32000x1MB buffers are posted. (Runtime-only) (Issue #3360)

• Fixed an issue where navigation will always take place within a ScriptDialogOpening event callback. (Runtime-only) (Issue #3355)

• Fixed an issue to support the BackForwardCache flag. (Runtime-only)

• Fixed an issue with visual hosted owned windows, where clicking into the Find bar from outside the window didn't activate the Find bar.

1.0.1722.45

Release Date: April 13, 2023

NuGet package for WebView2 SDK 1.0.1722.45

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

SDK 1.0.1722.32 is deprecated

WebView2 SDK 1.0.1722.32 is deprecated, and that package has been removed from the listing at NuGet. Discontinue development with package 1.0.1722.32. If your WebView2 app uses that package, we recommend that you move to a newer package, such as WebView2 SDK 1.0.1722.45 or later.

Promotions

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

• The Managing SmartScreen API controls whether SmartScreen is enabled.

• The PermissionKind.WindowManagement API indicates the kind of a permission request.

1.0.1777-prerelease

Release Date: April 10, 2023

NuGet package for WebView2 SDK 1.0.1777-prerelease

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

Experimental APIs

No Experimental APIs have been added in this Prerelease SDK.

Promotions

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

• The File API allows accessing a DOM File object passed via WebMessage.

• The Profile Cookie Manager API supports profile management. The CookieManager property enables the host app to get the cookie manager for the profile.

Bug fixes

• Fixed a crash when releasing the WebView from a different thread. (Runtime-only) (Issue #3062)

• Fixed a bug where focus was trapped inside the WebView2 control when wrapped in a ContainerControl. (Issue #2835)

• Fixed the issue by disabling the editable .pdf temporary cached data recovery function in WebView2. (Issue #3274)

• Disabled the Chrome Web Store info banner that displays the option to allow extensions installation. (Issue #3312)

• Fixed an issue with new download items not getting called out by screen readers.

• Fixed a bug where visual hosted owned windows didn't map mouse pointer input correctly.

• Fixed a bug where DownloadStarting was getting raised for a canceled Save As dialog. (Runtime-only)

1.0.1661.34

Release Date: March 20, 2023

NuGet package for WebView2 SDK 1.0.1661.34

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

Promotions

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

• The SharedBuffer API:

• APIs for managing permissions:

APIs for managing tracking prevention:

• APIs to manage the value of the controller's script locale:

1.0.1724-prerelease

Release Date: March 20, 2023

NuGet package for WebView2 SDK 1.0.1724-prerelease

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

Experimental APIs

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

• Added AdditionalObjects for WebMessage received:

• Added Window Management permission type:

• Added support for launching external URIs:

• Added support for texture streaming: