Edit

Share via

Release Notes for the WebView2 SDK

  • Article

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

See also