Release Notes for the WebView2 SDK

The WebView2 team updates the WebView2 SDK on a four-week cadence. This article contains the latest information on product announcements, additions, modifications, and breaking changes to the APIs.

You can view the list of Microsoft.Web.WebView2 SDK packages at the NuGet site.

Generally, release notes apply across the supported platforms, which are listed in WebView2 API Reference. For an outline of APIs that are in Release SDK packages, see Overview of WebView2 features and APIs.

Updating the Runtime and SDK

WebView2 changes may require an update to the Runtime, SDK, or both. Most new APIs require both Runtime and SDK updates. Starting with the February 2023 release, the update requirement for each bug fix is indicated as follows:

Indicator	Meaning
(Runtime and SDK), or no indicator	Both the Runtime and the SDK need to be updated.
(Runtime-only)	Only the Runtime needs to be updated.
(SDK-only)	Only the SDK needs to be updated.

WebView2 shares code and binaries with the Microsoft Edge browser, and is released around the same time. As a result, WebView2 Runtime releases generally also include Microsoft Edge updates.

• For Microsoft Edge updates, see Release notes for Microsoft Edge Stable Channel and Release notes for Microsoft Edge Beta Channel.

• To update the WebView2 Runtime on your development machine and on user machines, see Distribute your app and the WebView2 Runtime. To view or get the latest WebView2 Runtime versions, see Download the WebView2 Runtime in the Microsoft Edge WebView2 page at developer.microsoft.com.

• To install or update the WebView2 SDK, see Install or update the WebView2 SDK in Set up your Dev environment for WebView2.

Recommended browser channel and Runtime

Make sure to re-compile your WebView2 app after updating the WebView2 SDK NuGet package. The WebView2 team recommends the following:

• Use the Canary preview channel of Microsoft Edge when you develop using a Prerelease version of the WebView2 SDK package. Canary is the recommended preview channel, because it ships at the fastest cadence and has the newest APIs.

• Use the Evergreen WebView2 Runtime when you use a release version of the WebView2 SDK package.

For more information, see Matching the Runtime version with the SDK version.

Minimum version of the browser or Runtime to load WebView2

To load WebView2, the minimum version of Microsoft Edge or the WebView2 Runtime is 86.0.616.0. The minimum version to load WebView2 only changes when a breaking change occurs in the web platform.

To use a Prerelease SDK along with a Microsoft Edge preview channel, see Test upcoming APIs and features.

Experimental APIs, Prerelease SDKs, and Release SDKs

New APIs are added in phases, as follows:

1. APIs are initially introduced as Experimental APIs in a Prerelease SDK package.
2. Then they become Stable APIs in a Prerelease SDK package.
3. Soon after, they become Stable APIs in a Release SDK package.

For more information, see Phases of introducing APIs in Understand the different WebView2 SDK versions.

The following sections cover either a Release SDK package (1.0.####.##) or a Prerelease SDK package (1.0.####-prerelease).

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

• 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

• 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 APIs have been promoted from Experimental to Stable 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 are 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

• Added AdditionalObjects for WebMessage received:

• Added Window Management permission type:

• Added support for launching external URIs:

• Added support for texture streaming:

• Added support for profile management: custom data partition, cookie manager and profile deletion:

Promotions

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

• Managing smartscreen API:

Bug fixes

• Fixed a bug in PrintAsync and PrintToPdfStreamAsync that throws an exception when print settings are null.
• Improved handling of apps running elevated. (Runtime-only)
• Added support for window management permission kind. (Runtime and SDK)
• Reliability improvement. (Runtime-only)

1.0.1587.40

Release Date: February 15, 2023

NuGet package for WebView2 SDK 1.0.1587.40

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

Promotions

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

• Additional options used to create a WebView2 Environment to manage custom scheme registration:

1.0.1671-prerelease

Release Date: February 15, 2023

NuGet package for WebView2 SDK 1.0.1671-prerelease

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

Experimental APIs

• Added support for the Experimental File API:

Promotions

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

• The SharedBuffer API:

• The Permission API:

• The ScriptLocale API:

Bug fixes

• Fixed a bug where WebView2 was not closing properly when a BeforeUnload event was received. (Runtime-only) (Issue #2677)
• In the DownloadStarting event, the ResultFilePath previously wasn't showing the correct download location for UWP applications when the DownloadStarting event handler was attached. This has been fixed; the correct ResultFilePath is now shown.
• Fixed a bug where System.ArgumentException was thrown when a call to the HostObject method returns a non-generic task. (Issue #2787)
• Fixed an issue in the SharedBuffer API where the stream object didn't work well with StreamWriter. (Runtime-only) (Issue #3108)
• DOM speech-synthesis APIs, such as SpeechSynthesis.getVoices(), will now work in UWP apps. (Runtime-only)
• Fixed a crash that occurred on frame destruction. (Runtime-only) (Issue #3062)
• Fixed a bug where the app crashes when trying to call CreateWebResourceResponse with a null reason phrase. (Runtime-only)
• The CoreWebView2.AddHostObjectToScript option chrome.webview.hostObjects.options.ignoreMemberNotFoundError now works in non-English locales. (Runtime-only)
• Fully enabled Open file dialog support for elevated apps on Windows 7.
• Fixed a bug where owned windows were not appearing for UWP.

1.0.1518.46

Release Date: January 17, 2023

NuGet package for WebView2 SDK 1.0.1518.46

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

Promotions

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

• The Print API:

• The Custom Crash Reporting API:

1.0.1619-prerelease

Release Date: January 19, 2023

NuGet package for WebView2 SDK 1.0.1619-prerelease

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

Experimental APIs

• Added support for the Permission management API:

• Added support for API to disable back and forward navigation:

Promotions

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

• The Custom Scheme Registration API:

• The Tracking Prevention API:

Bug fixes

• Disabled Open link as Profile in the WebView2 context menu.
• Fixed post data missing in form submit with Ctrl-click. (Issue #2652)
• Fixed a bug where the user is not able to get the custom context menu on PDF Viewer. (Issue #2607)
• Fixed a bug where the entire toolbar is blank when simultaneously hiding the Bookmarks, Search, and PageSelector buttons. (Issue #2866)
• Fixed a bug where the app crashes when trying to move focus to WebView2 when it is disabled.
• Fixed drag and drop within the WebView2 for composition-hosted WebViews.
• Removed read-aloud icon in address bar in a WebView2 popup window.
• Fixed unexpected items in the context menu of popup windows in WebView2.

1.0.1462.37

Release Date: December 12, 2022

NuGet package for WebView2 SDK 1.0.1462.37

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

Bug fixes

This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1466-prerelease.

1.0.1549-prerelease

Release Date: December 12, 2022

NuGet package for WebView2 SDK 1.0.1549-prerelease

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

Experimental APIs

• Added support for the Locale Region API:

• Added support for the tracking prevention API:

Promotions

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

• Added support for the Print API:

• Added support for Custom Crash Reporting API:

Bug fixes

• Fixed some nullptr issues where now some public APIs which take nullptr as input parameters do not crash the WebView2.
• Disabled "Open link as Profile" in the WebView2 context menu.
• Fixed bug where the whole tool bar will be blank when hiding Bookmarks, Search, and PageSelector buttons simultaneously. (Issue #2866)
• Fix post data missing in form submit with control click. (Issue #2652)
• Fixed a bug where the user is not able to get the custom context menu on PDF Viewer. (Issue #2607)
• Fix drag/drop within the WebView2 for composition hosted WebViews.
• Fixed a bug where the app crashes when trying to move focus to WebView2 when it is disabled.
• Remove read aloud icon in address bar in a WebView2 popup window.
• Fixed an issue where context menu shows unexpected items in WebView2 popup window.

1.0.1418.22

Release Date: October 31, 2022

NuGet package for WebView2 SDK 1.0.1418.22

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

Bug fixes

This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1414-prerelease.

1.0.1466-prerelease

Release Date: October 31, 2022

NuGet package for WebView2 SDK 1.0.1466-prerelease

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

Experimental APIs

• Added support for creating a shared memory based buffer with a specified size:

• Added support for accessing a shared buffer object from the script of the main frame or iframe:

• Added support for running JavaScript code from the JavaScript parameter in the current top-level document:

Bug fixes for 1.0.1466-prerelease

• Fixed a bug in which the custom header title in print settings could be wrong. (Issue #2093)
• Display AllowedCertificateAuthorities in add_ClientCertificateRequested event as a Base64 string. (Runtime-only) (Issue #2346)
• Fixed a bug in which the default footer URI in print settings is missing. (Issue #2851)
• Fixed a bug that produces a null pointer exception that's related to print settings. (Runtime-only) (Issue #2858)
• Fixed a bug that reports navigation failure when redirecting to a server that has been configured with Client Certificate Authentication and when the WebResourceRequested event is subscribed to. (Runtime-only)
• Fixed an AddHostObjectToScript bug in which, when JavaScript calls an async method and then a synchronous method, the async method call might fail.

1.0.1370.28

Release Date: October 11, 2022

NuGet package for WebView2 SDK 1.0.1370.28

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

Promotions

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

• The drag and drop API:

1.0.1414-prerelease

Release Date: October 11, 2022

NuGet package for WebView2 SDK 1.0.1414-prerelease

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

Experimental APIs

• Added support for the Print API:

• Added support for SmartScreen API:

• Added support for Custom Crash Reporting API:

Bug fixes for 1.0.1414-prerelease

• Removed three-dot menu with a broken link from the downloads page. (Runtime-only) (Issue #2753)
• Fixed a bug in the WebView2 WinRT JS Projection tool (wv2winrt) where C++20 projects failed to compile. (Issue #2768)
• Fixed a crash which could occur with the WebView2 WinRT API while closing down WebView2 if you subscribed to any events, especially the CoreWebView2.GetDevToolsEventReceiver event. (SDK-only)
• Fixed a bug where it wasn't possible to dismiss the download popup after minimizing the window. (Runtime-only)

1.0.1343.22

Release Date: September 6, 2022

NuGet package for WebView2 SDK 1.0.1343.22

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

Bug fixes

This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1369-prerelease.

1.0.1369-prerelease

Release Date: September 6, 2022

NuGet package for WebView2 SDK 1.0.1369-prerelease

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

Promotions

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

• The drag and drop API:

Bug fixes for 1.0.1369-prerelease

• Fixed a bug where WPF apps would crash when windows with WebView2 were closed. (Issue #640)
• Fixed a bug that produced simultaneous WebView creation failure. (Runtime-only) (Issue #2703)
• Fixed print settings paper size to support dimensions as small as 0.01 inches. (Runtime-only)
• Fixed a bug where the WebView2 print dialog reset the Scale setting to Fit to printable area every time. (Issue #2523)
• Fixed a bug in the wv2winrt tool where a WinMD file wasn't referenced in some projects.

1.0.1293.44

Release Date: August 8, 2022

NuGet package for WebView2 SDK 1.0.1293.44

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

Promotions

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

• The Favicon API:

1.0.1340-prerelease

Release Date: August 8, 2022

NuGet package for WebView2 SDK 1.0.1340-prerelease

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

Experimental APIs

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

• Added support for custom scheme registration which allows WebView2 apps to be able to handle WebResourceRequested event for requests with the specified scheme and be able to navigate the WebView2 control to the custom scheme.

Bug fixes

• Added the ability for developers to explicitly specify the path from which to load the WebView2Loader.dll. (Issue #767)
• Added useful error messages when using CallDevToolsProtocolMethod. (Issue #1609)
• Fixed a bug in finding and loading the WebView2Loader.dll in some .NET apps. (Issue #2372)
• Fixed a bug where DownloadStarting event was not fired when retrying a download. (Issue #2489)
• Fixed an issue in service worker caching if the path was too long. (Issue #1900)
• Improved performance for wv2winrt IMap and IMapView projections into JavaScript.
• Adding support for HWND_MESSAGE to be used as WebView2 parent window to support headless scenarios. (Issue #202)
• Improved handling of running as admin user apps.
• Fixed online/offline status and notifications when using WebView2 in UWP apps.
• GDI scaling can now be enabled for WebView2. WebView2 will respect the GDI scaling setting of the hosting application without additional work needed from the app. (Issue #1700)
• Fixed a bug where focus is not returned to the application after closing the find bar for windowed mode. (Issue #1225)

1.0.1264.42

Release Date: July 4, 2022

NuGet package for WebView2 SDK 1.0.1264.42

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

Promotions

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

• Added ContextMenuRequestedAPI to enable host app to create or modify their own context menu.

1.0.1305-prerelease

Release Date: July 4, 2022

NuGet package for WebView2 SDK 1.0.1305-prerelease

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

Promotions

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

• The Favicon API:

Bug fixes

• Fixed an issue where PrintToPdfAsync may hang for long time. (Issue #1974)

• Fixed regression where WebView2 would steal focus from the app when the WebView2 was made visible. (Issue #862)

1.0.1245.22

Release Date: June 14, 2022

NuGet package for WebView2 SDK 1.0.1245.22

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

There is no corresponding prerelease package.

Promotions

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

• The Server Certificate API which provides an option to trust the server's TLS certificate at the application level. It renders the page without prompting the user about TLS or providing the ability to cancel the web request.

• The ClearBrowsingData API which allows developers to programmatically clear specific data types for a duration:

  • ClearBrowsingData
  • ClearBrowsingDataAll
  • ClearBrowsingDataInTimeRange

• The HttpStatusCode API which provides the HTTP status code for navigation requests in NavigationCompleted events.

Bug fixes

• Fixed an issue with the on-screen keyboard in which the keyboard doesn't reappear after it's closed by clicking the X button. Also fixed an issue in which the keyboard gets dismissed when users switch from one edit control to another within WebView2. (Issue #460)
• Fixed an issue when using a proxy from AddHostObjectToScript in script. If you call setHostProperty and it failed, you could have received an internal error message structure rather than a JavaScript Error object.
• Fixed regression where WebView2 would steal focus from the app when the WebView2 was made visible. (Issue #862)
• Fixed a bug that caused increased memory usage with WebResourceRequested events using large data. (Issue #2171)
• Fixed StatusBarTextChanged regression. The StatusBarText API was made compatible with previous versions again. (Issue #2414)
• Better support for apps running as admin. (Issue #2356)

1.0.1210.39

Release Date: May 9, 2022

NuGet package for WebView2 SDK 1.0.1210.39

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

Promotions

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

• Support for multiple user profiles in WebView2.

• Theming API which provides a way to customize the WebView2 color theme as light, dark, or system.

• Default Download API which provides a way to customize the default download location.

1.0.1248-prerelease

Release Date: May 9, 2022

NuGet package for WebView2 SDK 1.0.1248-prelease

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

General features

• Added support for WinRT Object projection into JavaScript by adding WinRT JS Projection tool (wv2winrt) in NuGet package. For instructions about using the WinRT JS Projection tool see Call native-side WinRT code from web-side code.

Promotions

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

• The Server Certificate API which provides an option to trust the server's TLS certificate at the application level and render the page without prompting the user about TLS or providing the ability to cancel the web request.

• The ClearBrowsingData API which allows developers to programmatically clear specific data types for a duration:

  • clearBrowsingDataInTimeRange
  • clearBrowsingDataAll

Bug fixes

• Fixed an unavoidable crash that occurred in the WPF control's OnWindowPositionChanged event. (Issue #1531)
• Fixed the issue with CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess not working properly in .NET SDK. (Issue #2363)
• Fixed a runtime regression that caused some Office Add-ins which use host objects to crash during operations that previously worked. (Issue #2337)
• Fixed an issue where WebView2 content can become blurry when moving between monitors with different scaling.
• Fixed a regression to make sure that WebView2 creation fails quickly with HRESULT_FROM_WIN32(ERROR_INVALID_STATE) instead of time out.
• Fixed a bug where changes from Chromium broke WebView2 background color.

1.0.1185.39

Release Date: April 12, 2022

NuGet package for WebView2 SDK 1.0.1185.39

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

General features

• Renamed ICoreWebView2Certificate to ICoreWebView2ClientCertificate.

Promotions

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

• The CallDevToolsProtocolMethodForSession API that supports sessionId for CDP method calls.

• The StatusBarText API:

  • add_StatusBarTextChanged
  • get_StatusBarText
  • remove_StatusBarTextChanged

• The AllowExternalDrop API that supports enable/disable for external drop operations.

• The HiddenPdfToolbarItems API is available to customize PDF toolbar items.

• The ExclusiveUserDataFolderAccess API allows control of whether or not other processes can create WebView2 from WebView2Environment created with the same user data folder and therefore sharing the same WebView browser process instance.

• The permission requested support for iframes:

  • add_PermissionRequested
  • remove_PermissionRequested

1.0.1222-prerelease

Release Date: April 12, 2022

NuGet package for WebView2 SDK 1.0.1222-prerelease

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

Experimental APIs for 1.0.1222-prerelease

• Added the Server Certificate API which provides an option to trust the server's TLS certificate at the application level and render the page without prompting the user about TLS or providing the ability to cancel the web request.

• Added the Favicon API which provides a way to get the favicon when it changes or is set at a website.

Promotions

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

• Support for multiple user profiles in WebView2.

• Theming API which provides a way to customize the WebView2 color theme as light, dark, or system.

• Default Download API which provides a way to customize the default download location.

Bug fixes

• Fixed ZoomFactor issue that incorrectly sets ZoomFactor value to the maximum value when it is out of bounds.
• Fixed an issue in which WebView2 content can become blurry when moving between monitors with different scaling.
• Fixed a bug where MouseEvent.movementX and MouseEvent.movementY will always be 0 in visual hosting mode. (Issue #2220)
• Fixed log in issue caused by a password regression in WebView2. (Issue #2291)
• Fixed a failure caused when a user opens a new app window and the web page does not have a navigation entry assigned.
• Made a runtime change to fix a bug in WinUI 2 (UWP) in which owned windows were not showing up.
• Fixed ICoreWebView2Frame::PostWebMessage functionality after source update. (Issue #2267)

1.0.1150.38

Release Date: March 10, 2022

NuGet package for WebView2 SDK 1.0.1150.38

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

Promotions

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

• The BasicAuthentication API that enables developers to handle Basic HTTP Authentication request and response.

1.0.1189-prerelease

Release Date: March 10, 2022

NuGet package for WebView2 SDK 1.0.1189-prerelease

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

Experimental APIs

• Added ContextMenuRequested API to enable host app to create or modify their own context menu.

Promotions

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

• The CallDevToolsProtocolMethodForSession API that supports sessionId for CDP method calls.
• The StatusBarText API:
  • add_StatusBarTextChanged
  • get_StatusBarText
  • remove_StatusBarTextChanged
• The AllowExternalDrop API that supports enable/disable external drop.
• The HiddenPdfToolbarItems API is available to customize the PDF toolbar items.
• The ExclusiveUserDataFolderAccess API allows control of whether or not other processes can create WebView2 using the same user data folder.

Bug fixes

• Fixed a bug where WebView2 app gets stuck occasionally with UWP.
• Fixed a bug where focus is not returned to the application after closing the Find bar for windowed mode.
• Fixed bug in which the DocumentTitleChanged event was not being raised for backward/forward navigation in single-page apps.
• Fixed bug in which the HistoryChanged event was not being raised for Iframe navigation.

1.0.1108.44

Release Date: February 6, 2022

NuGet package for WebView2 SDK 1.0.1108.44

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

Promotions

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

• The AdditionalAllowedFrameAncestors API that enable developers to provide additional allowed frame ancestors.

• The ProcessInfo APIs provide more information about WebView2 processes and process collections.

• New APIs for iframes:

  • add_NavigationStarting
  • remove_NavigationStarting
  • add_ContentLoading
  • remove_ContentLoading
  • add_NavigationCompleted
  • remove_NavigationCompleted
  • add_DOMContentLoaded
  • remove_DOMContentLoaded
  • ExecuteScript
  • PostWebMessageAsJson
  • PostWebMessageAsString
  • add_WebMessageReceived
  • remove_WebMessageReceived

1.0.1158-prerelease

Release Date: February 6, 2022

NuGet package for WebView2 SDK 1.0.1158-prerelease

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

Experimental APIs

• Added Status bar API to provide info when webiew is showing status message, URL, or empty string.
• Added CDP API to provide possibility for developers have multiple DevToolsProtocol targets in WebView2.

Promotions

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

• Rename ICoreWebView2ClientCertificate to ICoreWebView2Certificate.
• New APIs for iframes:
  • add_PermissionRequested
  • remove_PermissionRequested

Bug fixes

• Fixed an issue causing erroneous warnings in the Visual Studio Error List window. (Issue #1722)
• Fixed a bug where NewWindowRequested was not getting raised when opening PDF downloads.
• Resolved a bug in WinUI 3 where select dropdowns would not show up. (Issue #1693)
• Added the ability to toggle WebView2 mute state, even when there is no audio playing.

1.0.1072.54

Release Date: January 13, 2022

NuGet package for WebView2 SDK 1.0.1072.54

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

Promotions

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

• The Media API that enables developers to mute/unmute media within WebView2.

• The Download Positioning and Anchoring API enables:

  • Changing the position of the download dialog, relative to the WebView2 bounds. You can anchor the download dialog to the Download button, instead of the default position, which is the top-right corner.
  • Programmatically open and close the default download dialog.
  • Making changes in response to the dialog opening and closing.

1.0.1133-prerelease

Release Date: January 13, 2022

NuGet package for WebView2 SDK 1.0.1133-prerelease

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

Experimental APIs

• Added support for theming (overall color scheme - light, dark, system) of WebView2.
• Added a way to set default download path.
• Added support for clearing browser data.
• Added permission requested support for iframes.

Promotions

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

• New APIs for iframes:
  • PostWebMessageAsJson
  • PostWebMessageAsString
  • add_WebMessageReceived
  • remove_WebMessageReceived
• The ProcessInfo APIs provides more information about WebView2 processes and process collections.
• The HTTP Authentication API.

Bug fixes

• Fixed a bug that prevented Set-Cookies header from showing up in the WebResourceResponseReceived event.
• Resolved a bug where pop-ups and owned windows would jump to a different position before closing instead of closing along with the app window. This bug was only active for a very short window of time.
• Fixed focus issue after closing file picker dialog.
• Fixed bug where Find on Page UI visibility did not change with WebView2 visibility.
• Fixed bug where GetAvailableBrowserVersionString() fails to locate/load WebView2Loader.dll. (Issue #1236)
• Fixed size and position of the new window created with window.open when NewWindowRequested event was not handled. (Issue #1343)
• Fixed bug where mini menu was still displaying on selected text when context menus were disabled. This change is Runtime-specific. (Issue #1345)
• Fixed bug where focus returns to wrong location after switching apps in WinForms.

1.0.1083-prerelease

Release Date: November 29, 2021

NuGet package for WebView2 SDK 1.0.1083-prerelease

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

Experimental APIs

• Added the following APIs for iframes in WebView2:

  • PostWebMessageAsJson
  • PostWebMessageAsString
  • add_WebMessageReceived
  • remove_WebMessageReceived

• Added ProcessInfo APIs to provide more information about WebView2 processes and process collections.

Promotions

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

• The Media API that enables developers to mute/unmute media within WebView2.
• The Download Positioning and Anchoring API. This API enables:
  • Changing the position of the download dialog, relative to the WebView2 bounds. You can anchor the download dialog to the Download button, instead of the default position, which is the top-right corner.
  • Programmatically opening and closing the default download dialog.
  • Making changes in response to the dialog opening and closing.

Bug fixes

• Fixed a focus issue after closing the file picker dialog.
• Fixed a bug where WebView2 doesn't receive spatial input on initial launch.
• Fixed an issue that prevented single sign-on in WebView2.
• Resolved a bug where the download dialog was not moving with the window on WPF and WinForms.
• Updated compatible command line check to prevent needing a version check for optional switches.
• Fixed an error that was causing "Microsoft Edge" branding to appear in the accessibility tree.

1.0.1054.31

Release Date: November 29, 2021

NuGet package for WebView2 SDK 1.0.1054.31

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

Bug fixes

• General reliability fixes.
• Turned off the Control-flow Enforcement Technology (CET) Shadow Stack feature for v96 WebView2 Runtime.
• Fixed an issue that was causing slow startup times when launching in a .NET single-file application. (Issue #1909)
• Fixed a crash caused by Microsoft Edge browser policies getting incorrectly applied to WebView2 as well. (Issue #1860)
• Fixed a crash that occurred when a pop-up window with a download dialog was closed. (Issue #1765) & (Issue #1723)

1.0.1056-prerelease

Release Date: October 29, 2021

NuGet package for WebView2 SDK 1.0.1056-prerelease

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

Experimental APIs

• The Download Positioning and Anchoring API. This API enables:
  • Changing the position of the download dialog, relative to the WebView2 bounds. You can anchor the download dialog to the Download button, instead of the default position, which is the top-right corner.
  • Programmatically opening and closing the default download dialog.
  • Making changes in response to the dialog opening and closing.
• The HTTP Authentication API.

Bug fixes

• General reliability improvements.
• The real process exit code is now provided as ExitCode in ICoreWebView2ProcessFailedEventArgs2 for COREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED process failure.
• The --js-flags switch is now honored in the AdditionalBrowserArguments that are provided in CoreWebView2EnvironmentOptions.
• Fixed access to the name property for host objects in JavaScript. (Issue #641)
• Fixed an InvalidCastException in the WPF control when it's implicitly initialized prior to the event loop starting. (Issue #1577)

1.0.1020.30

Release Date: October 25, 2021

NuGet package for WebView2 SDK 1.0.1020.30

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

Promotions

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

• PrintToPdf API.

Bug fixes

• Updated EnsureCoreWebView2Async to not throw exceptions when the WPF source property is set. (Issue #1781)
• Fixed a bug where WebView2 crashes after interacting with multiple windows that show a download UI. (Issue #1723)

1.0.992.28

Release Date: September 27, 2021

NuGet package for WebView2 SDK 1.0.992.28

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

Promotions

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

• OpenTaskManagerWindow API.
• isSwipeNavigationEnabled property.
• BrowserProcessExited API.
• get_Name property on ICoreWebView2NewWindowRequestedEventArgs2 interface.

Bug fixes

• Fixed missing WebView2 DLLs (which led to initialization failure) when PlatformTarget isn't set in the user's .NET project. (Issue #1061)

1.0.1018-prerelease

Release Date: September 20, 2021

NuGet package for WebView2 SDK 1.0.1018-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 95.0.1018.0 or higher.

Experimental APIs

• Added a media API that enables developers to mute/unmute media within WebView2.
• Added support for multiple user profiles with WebView2.

Bug fixes

• Fixed a bug where WebView2 stops rendering when the app is spanning monitors and the monitor scale changes.
• Fixed a bug where closing the download UI crashes WebView2 when multiple download windows are open. (Issue #1723)
• Fixed a build/initialization error when PlatformTarget isn't set in the user's .NET project. (Issue #730 and Issue #1548)

1.0.1010-prerelease

Release Date: September 14, 2021

NuGet package for WebView2 SDK 1.0.1010-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 95.0.1010.0 or higher.

General features

• WebView2 performance improvements.
• Reliability fixes. (Issue #1605 and Issue #1678)
• Added performance improvements during startup and when the host app is in the foreground.

Experimental APIs

• Removed silent failures by using EnsureCoreWebView2Async, which throws an ArgumentException when called multiple times with incompatible parameters.

• Changed default handling of the UserDataFolder property in the environment object.

  Caution

  Breaking Change: The default handling for the user data folder, if the developer doesn't specify where to put it, will be changing. See Announcement: User directory folder default handling updates.

• Added navigation & script APIs for iframes.

• Added MemoryUsageTargetLevel which allows developers to specify memory consumption levels, such as low, or normal.

• Added ExclusiveUserDataFolderAccess to environment options.

• Added HiddenPdfToolbarItems to customize PDF toolbar items.

• Added PrintToPdf, which allows printing the current page to PDF. Also, you can use optional custom settings with this new API.

• Added AllowExternalDrop property to allow the dragging and dropping of objects from outside a WebView2 control into it.

• Added ContextMenu APIs which allow customization of the WebView2 context menu.

Promotions

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

• IsSwipeNavigationEnabled
• BrowserProcessExited
• OpenBrowserTaskManager

Bug fixes

• Improved how host objects exceptions are caught in your JavaScript code.
• Replaced WebView2 icon with a generic icon in DevTools windows.
• Turn on the Tab screen sharing option when MediaDevices.getDisplayMedia() is used. (Issue #1566)
• Fixed a bug in the Client Certificate API, when the correct certificate was not selected. This is a Runtime change. (Issue #1666)
• Fixed bug where window.chrome.webview was unavailable in new windows in the same parent domain. This change is Runtime-specific. (Issue #1144)
• Fixed a bug where dropdown menus or lists were displayed behind the window that has focus. (Issue #411)
• Fixed focus issues when using put_IsVisible(false). (Issue #238)
• Fixed a bug to apply SetVirtualHostNameToFolderMapping to pop-up windows.
• Fixed bugs where an IDispatch objects were returned as IUnknown.

1.0.961.33

Release Date: September 8, 2021

NuGet package for WebView2 SDK 1.0.961.33

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

Promotions

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

• Client Certificate API.

Bug fixes

• Fixed a bug that caused ERR_SSL_CLIENT_AUTH_CERT_NEEDED errors. This is a Runtime change.
• Fixed a bug that special browser keys like Refresh, Home, Back, and so on can't be turned off using AreBrowserAcceleratorKeysEnabled. This change is Runtime-specific.
• Fixed a bug where the transparent background color isn't rendered.
• Fixed a bug that caused a white flicker when loading WebView2.
• Fixed a bug in WebView2 .NET controls where WebView2 windows were blank when created in the background. (Issue #1077)
• Fixed a bug where settings were not updated when the user navigated to or a new window displayed about:blank pages. This is a Runtime change.

1.0.955-prerelease

Release Date: July 26, 2021

NuGet package for WebView2 SDK 1.0.955-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 93.0.967.0 or higher.

General features

• WebView2 performance improvements.
• Added partial Event Tracing for Windows (ETW) support.
• Removed Microsoft branding from edge://history.
• New default Download UI.

Experimental APIs

• Added OpenTaskManagerWindow to launch a WebView2 browser task manager.
• Added NewWindowRequestedEventArgs.
• Added support for virtual host name mapping to work with Service Workers.
• Added HiddenPdfToolbarItems to customize the PDF toolbar items.

Promotions

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

• add_ClientCertificateRequested

Bug fixes

• Fixed bug that broke the edge://downloads and edge://history pages. This change is Runtime-specific.
• Fixed bugs to improve reliability in the WebView2Loader.dll.
• Fixed bug in which NewWindowRequested event handler launched two windows when handling links that use target=_blank.
• Fixed a bug in WebView2 visual hosting that flickered before startup.
• Fixed bug when add_WebResourceRequested didn't work on WebView2 controls created using add_NewWindowRequested. (Issue #616)
• Allow the host app to set foreground on a different application in response to events including NavigationStarting, AddHostObjectToScript methods, WebMessageReceived, and NewWindowRequested. (Issue #1092)
• Fix bug to trigger the PermissionRequested event for the microphone. This change is Runtime-specific.(Issue #1462)
• Fixed bug when ExecuteScriptAsync blocked after several successful runs. This change is Runtime-specific. (Issue #1348)
• Fixed bug preventing non-ASCII filenames from being used in ResultFilePath in DownloadStartingEventArgs. (Issue #1428)
• Fixed bug where the title bar on the default pop-up wasn't displayed completely. This change is Runtime-specific. (Issue #1016)

.NET

Bug fixes

• Fixed an issue in WebView2 .NET API reference documentation that caused only the first exception to be displayed.
• .NET core libraries are now built in release mode. To debug, ensure you clear the Just my code checkbox.
• Fixed a bug that crashed WebView2 on forms with child forms. The child form, with the find in page bar open, caused WebView2 to crash when the child form was closed. (Issue #1097)

1.0.902.49

Release Date: July 26, 2021

NuGet package for WebView2 SDK 1.0.902.49

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

Promotions

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

• add_FrameCreated.
• get_IsGeneralAutofillEnabled.
• get_IsPinchZoomEnabled.
• The Download APIs.
• AddHostObjectToScriptWithOrigins API with iframe element support.

Bug fixes

• Fix bug that broke the IsBuiltInErrorPageEnabled property, which turned off the error page that's displayed when there's a navigation failure or render process failure. This change is Runtime-specific. (Issue #634)
• Fixed an issue where WebView2 controls took focus away from the user's focus.
• Fixed bug when AddScriptToExecuteOnDocumentCreated didn't work on child windows. (Issue #935)
• Fixed a bug that caused inactive tabs to be automatically discarded. (Issue #637)
• Fixed a bug when a navigation event was interrupted by another navigation event resulting in the Navigation ID of NavigationCompleted events to be incorrect. (Issue #1142)

1.0.902-prerelease

Release Date: June 1, 2021

NuGet package for WebView2 SDK 1.0.902-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 92.0.902.0 or higher.

General features

• Improved WebView2 startup performance and disk footprint.

Experimental APIs

• Added IsSwipeNavigationEnabled property to enable or disable the ability of the end user to use swiping gesture on touch input-enabled devices to navigate in WebView2.
• Added BrowserProcessExited event.
• Added add_ClientCertificateRequested API. It allows showing a client certificate dialog prompt if desired and enables access to required metadata to replace default client certificate dialog prompt.

Promotions

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

• Download API.
• PinchZoom API.
• AddFrameCreated.
• AddHostObjectToScriptWithOrigins API promoted to Stable with iframe element support.
• Autofill API.

  Note

  There is no current API to delete the locally stored general autofill and password autosave information. Please provide a control to delete the data, which will involve deleting the entire user data folder.

Bug fixes

• Fix a bug where mouse left click doesn't dismiss context menu. This change is Runtime-specific.
• Fixed a bug where WebView2 creation fails when exe files for apps sharing the same user data folder have inconsistent version info.
• Fixed a bug where special browser keys such as Refresh, Home, and Back can't be disabled by AreBrowserAcceleratorKeysEnabled. This change is Runtime-specific.
• Fixed a bug in WebView2 .NET controls, where WebView2 windows are blank when created in the background. (Issue #1077)
• Dismissing a file picker dialog by pressing Enter or Esc no longer crashes WPF applications using WebView2 control. (Issue #1099)
• Fixed a bug that AllowSingleSignOnUsingOSPrimaryAccount doesn't work properly with WebView2 when a WebResourceRequested event handler is attached. This change is Runtime-specific. (Issue #1183)
• Downloading a file no longer breaks WebView2 DefaultBackgroundColor transparency. This change is Runtime-specific. (Issue #1108)
• Removed screen sharing media picker message that contains Microsoft branding. (Issue #940)
• Fixed a bug in WebView2 WinForm control where hiding the parent form doesn't hide the WebView2 control. (Issue #828 and Issue #1079)
• Added static WS_CLIPCHILDREN style to WebView2's WPF windows. (Issue #1013).
• Fixed a bug where right-clicking a link crashes the WebView2 host app. This change is Runtime-specific.
• Fixed a reliability bug that could crash the host app process when moving to a newer Edge WebView2 Runtime version.
• DEPRECATION: Officially deprecated the DefaultBackgroundColor API for Windows 7.

.NET

Bug fixes

• Fixed a bug in WebView2 WinForm control where WebView2 window visibility isn't updated properly after parent window is disposed. (Issue #1282 and Issue #828)
• Fixed a bug in WebView2 WPF control that Source property binding in WPF OneWay binding mode isn't working properly. (Issue #619 and Issue #608)

1.0.864.35

Release Date: May 31, 2021

NuGet package for WebView2 SDK 1.0.864.35

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

Bug fixes

• Fixed a reliability bug that could crash the host app process when moving to a newer Edge WebView2 Runtime version.
• Fixed a bug that prevented memory purge in some situations. This change is Runtime-specific.
• Fixed error in 818 SDK release package where project couldn't find the WebView2.h file. (Issue #1209).
• Fixed a bug which caused WebResourceRequested event to be dropped for some requests with binary bodies.
• Improve NewWindowRequested documentation. (Issue #448).

Promotions

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

• UserAgent API
• AreBrowserkeysenabled

.NET

Bug fixes

• Fixed a bug in WebView2 .NET controls that first header is missing when iterating CoreWebView2WebResourceRequest headers collection. (Issue #1123).

1.0.865-prerelease

Release Date: April 26, 2021

NuGet package for WebView2 SDK 1.0.865-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 91.0.865.0 or higher.

Experimental APIs

• Added IsPinchZoomEnabled setting. It allows you to turn on or off page scale zoom control in a setting.
• Added Custom add_DownloadStarting API. It allows you to block downloads, save to a different path, and access the required metadata to build custom download UI.
• Added iframe element support from AddHostObjectToScriptWithOrigins.
• Added sample code for WPF sample app to use the API to turn off browser function keys.
• Added the UpdateRuntime API, to easily update the WebView2 Runtime.

Bug fixes

• Fixed handler for a Chromium DevTools Protocol message with POST binary data in WebView2.
• Turned off the OpenSaveAsAwareness download UI, because it included links to edge://settings. (Issue #1120).
• Removed branding from screen share dialog. (Issue #940).
• Fixed bug where the SetWindowDisplayAffinity function broke WebView2 when it stopped screen capture in an WebView2 app. (Issue #841).
• Fixed bug for composition hosting where mouse input stopped working if any pen input was sent to WebView2.
• Fixed bug that broke mouse input after any pen input. This change is Runtime-specific.

.NET

Experimental APIs

• Added WebView2 designer tool to WPF Toolbox. (Issue #210).
• Added WebView2 UI element in .NET Designer Mode.

Bug fixes

• Improved COM Exception descriptions by wrapping each in a more detailed .NET exception. (Issue #338). This change is Runtime-specific.
• Fixed bug caused when you select Tab to shift focus caused WebView2 control to crash in Microsoft Visual Studio Tools for Office. (Issue #589 and Issue #933). This change is Runtime-specific.
• Improved .NET framework loader down level to be more robust. (Issue #946)
• Fixed bug that caused crash when you try to refresh before first navigation completed. (Issue #1011)
• Fixed initialization so navigation occurs during CoreWebView2InitializationCompleted. (Issue #1050)
• Improved .NET browser process crash error handling. You can now recreate controls after you handle a ProcessFailed event, without a crash. (Issue #996)

1.0.818.41

Release Date: April 21, 2021

NuGet package for WebView2 SDK 1.0.818.41

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

Features

• Extended the ProcessFailed event. It now raises for non-renderer child processes and frame renderers.
• Added iframe element support for AddScriptToExecuteOnDocumentCreated.
• Improved WebView2 code to be more resilient to .exe application files with malformatted version information. (Issue #850).
• Removed --winhttp-proxy-resolver from WebView2 browser process command-line, turned on other proxy command-line options for WebView2.

1.0.824-prerelease

Release Date: March 8, 2021

NuGet package for WebView2 SDK 1.0.824-prerelease

For full API compatibility, this prerelease version of the WebView2 SDK requires Microsoft Edge version 91.0.824.0 or higher.

Features

• Extended the ProcessFailed event. It now raises for non-renderer child processes and frame renderers.
• Added experimental AreBrowserAcceleratorKeysEnabled setting. You can prevent the browser from responding to keyboard shortcuts related to navigation, printing, saving, and other browser-specific functions.
• Added iframe element support for AddScriptToExecuteOnDocumentCreated.

Promotions

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

• UserAgent.

• Rasterization Scale APIs:

  • RasterizationScale property
  • RasterizationScaleChanged event
  • BoundsMode property
  • ShouldDetectMonitorScaleChanges property

Bug fixes

• Expanded supported C++ and .NET project types such as MFC and ATL. (Issue #506, Issue #669, and Issue #851).
• Fixed a bug that Evergreen WebView2 Runtime leaks Inbound firewall entry.
• Fixed setting Response during WebResourceRequested event. (Issue #568).
• Fixed a bug that navigating to edge:// causes browser process to exit. (Issue #604).
• Fixed a bug that limited WebView2 bounds to size of screen in Visual Hosting mode.

1.0.774.44

Release Date: March 8, 2021

NuGet package for WebView2 SDK 1.0.774.44

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

Features

• Turned off various Microsoft Edge browser services in WebView2.
• Visual Hosting APIs are now Generally Available.

Promotions

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

• DPI support related APIs
• Visual hosting APIs
• SetVirtualHostNameToFolderMapping
• TrySuspend and Resume
• DefaultBackgroundColor

Bug fixes

• Fixed a bug that limited WebView2 bounds to size of screen in Visual Hosting mode.

1.0.790-prerelease

Release Date: February 10, 2021

NuGet package for WebView2 SDK 1.0.790-prerelease

This prerelease version of the WebView2 SDK requires Microsoft Edge version 86.0.616.0 or higher.

Breaking changes

Features

• Added TrySuspend and Resume method to suspend and resume WebViews.
• Added SetVirtualHostNameToFolderMapping method that maps a virtual host name to a directory path. (Issue #37, Issue #161, and Issue #212).
• Added the DefaultBackgroundColor property to set the color and alpha-channel of the background. (Issue #414).
• Added the UserAgent property to get or set the User Agent. (Issue #122).
• Replaced the CreateCookieWithCookie method with the CopyCookie method.
• Added visual hosting support using the ICoreWebView2CompositionController interface, which is created using the new CreateCoreWebView2CompositionController method from ICoreWebView2Environment3.

Promotions

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

• Visual Hosting APIs
• SetVirtualHostNameToFolderMapping

Bug fixes

• Turned off the Microsoft Edge Shopping feature in WebView2.
• Turned off the context menu in the PDF viewer when AreDefaultContextMenusEnabled is false. (Issue #605).
• Fixed a bug that returned E_NOINTERFACE when querying ICoreWebView2 for ICoreWebView2Experimental. (Issue #691).
• Fixed a bug that allowed navigation with malformed URIs when CoreWebView2NavigationStartingEventArgs.Cancel is set to false. (Issue #400).
• Fixed a bug that blocked window.print() on pop-up windows with event handlers attached to NewWindowRequested events. (Issue #409).
• Fixed Dynamic DPI issue when moving apps between different monitors. (Issue #58)
• Improved the HRESULT instances passed by ICoreWebView2WebResourceResponseViewGetContentCompletedHandler::Invoke.
• Turned off autofill manage button. (Issue #585).
• Fixed Visual Studio crashes while you run WebView2.Dispose when hosted in multiple windows. (Issue #816) and Issue #442).
• Fixed bug to display WebView2 control in Visual Studio Toolbox. (Issue #210).
• Reduced high CPU usage issues. (Issue #878).
• Fixed issues with deprecated 1.0.781-prerelease package. (Issue #875 and Issue #878).

.NET

Bug fixes

• Fixed bug that crashed WebView2 apps that use the WPF SDK. The crash occurred when pressing F4 to close a window. (Issue #399).
• The WebView2 initialization screen is now transparent, instead of gray. (Issue #196).

1.0.705.50

Release Date: January 25, 2021

NuGet package for WebView2 SDK 1.0.705.50

This version of the WebView2 SDK requires WebView2 Runtime version 86.0.616.0 or higher.

Promotions

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

• WebResourceResponseReceived API
• NavigateWithWebResourceRequest API
• Cookie management API
• DOMContentLoaded API
• Environment property

1.0.721-prerelease

Release Date: December 8, 2020

NuGet package for WebView2 SDK 1.0.721-prerelease

This prerelease version of the WebView2 SDK requires Microsoft Edge version 86.0.616.0 or higher.

Breaking changes

Features

• Added WebView2 Group Policies. For best practices, see group policies for WebView2.

• Important

  Breaking Change: Deprecated the old registry location.

  {Root}\Software\Policies\Microsoft\EmbeddedBrowserWebView\LoaderOverride\{AppId}
  

• Added support for Drag and Drop in WebView2.

• Added APIs to handle DPI support.

  • Added RasterizationScale property to change the DPI scale for WebView2 content and UI pop-ups, and associated RasterizationScaleChanged event.
  • Added ShouldDetectMonitorScaleChanges property to automatically update RasterizationScale property if needed.
  • Added BoundsMode property to specify that the bounds are logic pixels and allow WebView2 to use RasterizationScale for WebView2 pixel display, and WebView2 use the RasterizationScale with the Bounds to get the physical size.

• Updated NewWindowRequested event to handle Ctrl+click and Shift+click. (Issue #168 and Issue #371).

Promotions

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

• WebResourceResponseReceived API
• NavigateWithWebResourceRequest API
• Cookie management API
• DOMContentLoaded API
• Environment property

.NET

Features

• Turned on WinForms designer in .NET Core 3.1+ and .NET 5.
• Improved .NET cookie management. (Issue #611).
• Replaced CoreWebView2Ready with CoreWebView2InitializationCompleted.

Bug fixes

• Added AcceleratorKeyPressed event to support AcceleratorKey select in WebView2. (Issue #288).
• Removed unnecessary files from being output to WebView2 folders. (Issue #461).
• Improved host object API. (Issue #335 and Issue #525).

1.0.664.37

Release Date: November 20, 2020

NuGet package for WebView2 SDK 1.0.664.37

This version of the WebView2 SDK requires WebView2 Runtime version 86.0.616.0 or higher.

General Availability

Features

• .NET WPF/WinForms WebView2 is now Generally Available (GA).
• Fixed Distribution (Bring-your-own) mode reached GA.

.NET

Bug fixes

• CoreWebView2NewWindowRequestedEventArgs.Handled prevents new window from being opened. (Issue #549 and Issue #560).

1.0.674-prerelease

Release Date: October 19, 2020

NuGet package for WebView2 SDK 1.0.674-prerelease

This prerelease version of the WebView2 SDK requires WebView2 Runtime version 86.0.616.0 or higher.

General features

• Added NavigateWithWebResourceRequest method to provide post data or other request headers during navigation.
• Added DOMContentLoaded event that runs when the initial HTML document is loaded and parsed.
• Added the Environment property on WebView2. This property exposes the WebView2 environment where an instance of WebView2 was created.
• Added cookie management APIs that allow developers to authenticate the WebView2 session, or retrieve cookies from WebView2 to authenticate other tools. The WebView2 team plans to make language or framework-specific improvements. See API Review: Cookie Management.
• Updated the WebResourceResponseReceived event, and added immutable WebResourceResponseView and WebResourceResponseReceivedEventArgs::PopulateResponseContent to WebResourceResponseView::GetContent.
• Turned off Microsoft Defender Application Guard (WDAG) in WebView2.
• Added SystemCursorId for Visual Hosting.
• Added bug fixed for Input Method in Visual Hosting.
• Removed include requirement for version.lib when using WebView2 static library.

.NET

• Updated CoreWebView2 class to expose the CoreWebView2Environment variable.
• Changed implementations of custom EventArgs classes in Microsoft.Web.WebView2.Core namespace to subclasses of System.EventArgs or System.ComponentModel.CancelEventArgs. (Issue #250)
• Added support for CoreWebView2CreationProperties in WinForms. (Issue #204).
• Added WebResourceRequested .NET APIs. (Issue #219).
• Updated WinForms Designer Source property to default or reset to null. (Issue #177).
• Updated WebView2 bounds in WebView2.Init() to support DPI modes that are less than 100%. (Issue #432).
• Updated BuildWindowCore and DestroyWindowCore to increase robustness. (Issue #382).
• Updated .NET Loader base to load on process bit instead of operating system architecture. (Issue #431).
• Renamed EdgeNotFoundException to WebView2RuntimeNotFoundException.

1.0.622.22

Release Date: October 19, 2020

NuGet package for WebView2 SDK 1.0.622.22

This version of the WebView2 SDK requires WebView2 Runtime version 86.0.616.0 or higher.

• The Evergreen WebView2 Runtime and installer are GA. The bootstrapper, the downlink link for the Bootstrapper, and the Standalone Installer for the Evergreen WebView2 Runtime are available on Microsoft Edge WebView2. Sample code for the installation workflow is also available in the WebView2Samples repo.

For more information about the Runtime, Evergreen distribution, and Fixed Version distribution, see Distribute your app and the WebView2 Runtime.

0.9.622.11

Release Date: September 10, 2020

NuGet package for WebView2 SDK 0.9.622.11

This version of the WebView2 SDK requires WebView2 Runtime version 86.0.616.0 or higher.

• Important

  Announcement: This SDK is the Release Candidate for WebView2 Win32 C/C++ GA. The GA version is expected to use the same API interface and functionality.

• Disconnected browser policies.

• Added AllowSingleSignOnUsingOSPrimaryAccount property on WebView2 environment options to turn on conditional access for WebView2.

• Updated ICoreWebView2NewWindowRequestedEventArgs to include WindowFeatures property, and the associated ICoreWebView2WindowFeatures. (Issue #293).

• Updated System.Windows.Rect to use System.Drawing.Rectangle instead of System.Windows.Rect (Issue #235).

• Updated NewWindowRequested event to handle window.open() request without parameters. (Issue #293).

• AdditionalBrowserArguments specified with ICoreWebView2EnvironmentOptions aren't overridden with environment variables or registry values. See CreateCoreWebView2EnvironmentWithOptions.

0.9.579

Release Date: July 20, 2020

NuGet package for WebView2 SDK 0.9.579

This version of the WebView2 SDK requires Microsoft Edge version 86.0.579.0 or higher.

All platforms

• Important

  Announcement: Evergreen WebView2 Runtime and installer is released for preview. See Distribute your app and the WebView2 Runtime.

• Important

  Announcement: The following WebView2 SDK Versions are no longer supported after the next SDK release:

  • 0.8.190
  • 0.8.230
  • 0.8.270
  • 0.8.314
  • 0.8.355

  The WebView2 SDK Versions are also marked deprecated on nuget.org. WebView2 recommends staying up to date with the latest version of WebView2.

• Added WebView2 worker thread improvements. (Issue #318).

• Turned off the pop-up blocker in WebView2. See the IsUserInitiated property in the NewWindowRequested event.

• Ensured WebView2 navigation starting event is run for about:blank. Now, NavigationStarting events are run for all navigation, but cancellations for about:blank or srcdoc of the iframe element aren't supported and ignored.

• Blocked some edge:// URI schemes in WebView2.

• Added experimental IsSingleSignOnUsingOSPrimaryAccountEnabled property on WebView2 environment options to turn on conditional access for WebView2.

• Added experimental WebResourceResponseReceived event that runs after the WebView2 receives and processes the response from a WebResource request. Authentication headers, if any, are included in the response object.

.NET

• Improved WPF focus handling. (Issue #185).
• Added ZoomFactor property on WPF Webview2 Controller.

0.9.538

NuGet package for WebView2 SDK 0.9.538

This version of the WebView2 SDK requires Microsoft Edge version 85.0.538.0 or higher.

All platforms

• Dropping support for WebView2 SDK Version 0.8.149. WebView2 recommends staying up to date with the latest version of WebView2.
• Updated group policy to account for when the profile path of the Microsoft Edge browser is modified (#179).

Win32 C/C++

• Added ICoreWebView2ExperimentalNewWindowRequestedEventArgs::get_WindowFeatures, which fires when window.open() is run and associated with ICoreWebView2ExperimentalWindowFeatures (#70).

• Important

  Breaking Change: Deprecated CreateCoreWebView2EnvironmentWithDetails and replaced with CreateCoreWebView2EnvironmentWithOptions.

• Important

  Breaking Change: In order to ensure the WebView2 API aligns with the Windows API naming conventions, the WebView2 team updated the names of the following.

  • AreRemoteObjectsAllowed is now AreHostObjectsAllowed.

• Updated AddHostObjectToScript. The original host object serializer markers are now set to the proxy objects. Then host object serializer markers are serialized back as a host object when passed as a parameter in the JavaScript callback (#148).

.NET (0.9.538 prerelease)

• Released WinForms and WPF WebView2API Samples, which are comprehensive guides of the WebView2 SDK. See Samples Repo.

• Added support for visual hosting and window features experimental APIs.

• Important

  Breaking Change: The following deferrals now implement IDisposable: ScriptDialogOpening, NewWindowRequested, WebResourceRequested, and PermissionRequested.

• Added GetAvailableBrowserVersionString and CompareBrowserVersions as CoreWebView2Environment statics.

0.9.515-prerelease

NuGet package for WebView2 SDK 0.9.515-prerelease

This prerelease version of the WebView2 SDK requires Microsoft Edge version 84.0.515.0 or higher.

• Important

  Announcement: WebView2 now supports Windows Forms and WPF on .NET Framework 4.6.2 or later and .NET Core 3.0 or later in the prerelease package.

• For more information about building WPF apps, see Get started with WebView2 in WPF apps and the WebView2 WPF Reference for WPF-specific APIs.

• For more information about building Windows Forms apps, see Get started with WebView2 in WinForms apps and the WebView2 Windows Forms Reference for Windows Forms specific APIs.

• For more information about the CoreWebView2 APIs, see .NET Reference.

• Caution

  Known Issues: The WebView2 team is aware of some issues in the prerelease that are being resolved in future releases.

  • DPI Awareness: WebView2 for WPF is currently not DPI aware. When initializing WebView2 on high DPI monitors, there is a known issue where the WebView2 control at first initializes as a fraction of the window until the window is resized.
  • WPF Designer: The WPF designer isn't currently supported. Add the WebView2 control in your app by directly modifying the appropriate XAML in a text editor.

0.9.488

NuGet package for WebView2 SDK 0.9.488

This version of the WebView2 SDK requires Microsoft Edge version 84.0.488.0 or higher.

• Important

  Announcement: Starting with the upcoming Microsoft Edge version 83, Evergreen WebView2 no longer targets the Stable browser channel. Instead, it targets another set of binaries, branded Evergreen WebView2 Runtime, that you can chain-install through an installer that the WebView2 team is currently developing. See Distribute your app and the WebView2 Runtime.

• Important

  Announcement: Moving forward, the WebView2 team releases two packages:

  • A Prerelease SDK package containing Experimental APIs (for you to try out), and also APIs that have been promoted to Stable status.
  • A Release SDK package that consists entirely of APIs that have reached Stable status (for your confidence).

  To learn about the differences, see Understanding browser versions and WebView2.

• Important

  Breaking Change: In order to ensure the WebView2 API aligns with the Windows API naming conventions, the WebView2 team updated the names of the following interfaces.

  • CORE_WEBVIEW2_* prefix is now COREWEBVIEW2_*.
  • GetCoreWebView2BrowserVersionInfo is now GetAvailableCoreWebView2BrowserVersionString.
  • get_BrowserVersionInfo is now get_BrowserVersionString.
  • AddRemoteObject is now AddHostObjectToScript.
  • RemoveRemoteObject is now RemoveHostObjectFromScript.
  • chrome.webview.remoteObjects is now chrome.webview.hostObjects.

• Important

  Breaking Change: The AddRemoteObject JS proxy methods are also renamed.

  • getLocal is now getLocalProperty.
  • setLocal is now setLocalProperty.
  • getRemote is now getHostProperty.
  • setRemote is now setHostProperty.
  • applyRemote is now applyHostFunction.

• Important

  Breaking Change: Deprecated CreateCoreWebView2EnvironmentWithDetails and replaced with CreateCoreWebView2EnvironmentWithOptions.

• Added FrameNavigationCompleted event. Now, when an iframe element completes navigation, an event is run and returns the success of the navigation and the navigation ID.

• Added ICoreWebView2EnvironmentOptions interface, which can be used to determine the version of the Evergreen WebView2 Runtime targeted by your app.

• Added IsBuiltInErrorPageEnabled setting. Now, you can choose to turn on or off the built-in error webpage for navigation failure and render process failure.

• Updated Remote Object Injection to support .NET IDispatch implementations (#113).

• Updated NewWindowRequested event to handle requests from context menus (#108).

• Released the first separate WebView2 prerelease package where you can access visual hosting APIs. The WebView2 team updated APISample to include the new experimental APIs.

  • Added ICoreWebView2ExperimentalCompositionController interface, to connect to a composition tree and provide input for the WebView2 control.
  • Added ICoreWebView2ExperimentalPointerInfo, which contains all the information from a POINTER_INFO. This object is passed to SendPointerInput to inject pointer input into the WebView2.
  • Added ICoreWebView2ExperimentalCursorChangedEventHandler, which tells the app when the mouse cursor over the WebView2 control should be changed. When mouse is over a text box in the WebView2, the cursor changes from the arrow to the selector. The cursor property on the CompositionController tells the app what the mouse cursor should currently be for the WebView2.

0.9.430

NuGet package for WebView2 SDK 0.9.430

This version of the WebView2 SDK requires Microsoft Edge version 82.0.430.0 or higher.

The WebView2 SDK is the official Win32 C++ Beta version, which incorporates several feature requests from feedback. The WebView2 team tries to limit the number of releases with breaking changes. As general availability approaches, several major breaking changes are incorporated in the Beta release.

• Important

  Breaking Change: As the final release approaches the WebView2 team renamed the prefix IWebView2WebView to ICoreWebView2 in order to make sure the WebView2 API aligns with the Windows API naming convention. Additionally, in order to leverage the WebView2 SDK from UI frameworks, the WebView2 team separated ICoreWebView2 into ICoreWebView2 and ICoreWebView2Host. ICoreWebView2Host supports resizing, showing-and-hiding, focusing, and other functionality related to windowing and composition. ICoreWebView2 supports all other WebView2 functionality. To learn more about incorporating the changes, see the WebView2 pull request in the WebView2 APISample project.

• Important

  Breaking Change: Split DocumentStateChanged into three components: SourceChanged, ContentLoading, and HistoryChanged. Now, when the source URL changes the SourceChanged event is run. When the history state is changed the HistoryChanged event is run. The ContentLoading event is run before the initial script when a new document is being loaded.

• Added support for ARM64 architecture.

• Added Soft Input Panel (SIP) support for touch screen devices.

• Added support for Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, and Windows Server 2016.

• Added NotifyParentWindowPositionChanged for the status bar to follow the window in windowed mode. Also, implement the change in windowless mode in order for accessibility features to work.

• Added AreRemoteObjectsAllowed setting to globally control whether a webpage can be accessed by any remote objects. By default, AreRemoteObjectsAllowed is turned on, so remote objects added by AddRemoteObject are accessible from the webpage. When AreRemoteObjectsAllowed is turned off, the objects aren't accessible from the webpage. Changes are applied on the next navigation event.

• Added IsZoomControlEnabled setting to prevent users from impacting the zoom of the WebView2 control using Ctrl++ and Ctrl+- (or Ctrl+ mouse wheel). Zoom can still be set using put_ZoomFactor when the setting is turned off.

• Changed ZoomFactor to only apply to the current WebView2 control. Zoom changes to the current WebView2 control don't affect other WebViews that you navigated to using the same site of origin. See get_ZoomFactor.

• Hid ZoomView UI for WebView2 control (#95).

• Added SetBoundsAndZoomFactor. Now, you can set the zoom factor and bounds of a WebView2 control at the same time.

• Added WindowCloseRequested event. See add_WindowCloseRequested (#119).

• Added support for the beforeunload dialog type for JavaScript dialog events and added CORE_WEBVIEW2_SCRIPT_DIALOG_KIND_BEFOREUNLOAD enum entry.

• Added GetHeaders to HttpRequestHeaders, GetHeader to HttpResponseHeaders, and get_HasCurrentHeader property to HttpHeadersCollectionIterator.

• Important

  Breaking Change: Modified DevToolsProtocolEventReceived behavior. Now, you can create a DevToolsProtocolEventReceiver for a particular DevTools Protocol event and subscribe/unsubscribe to such event using add_DevToolsProtocolEventReceived/remove_DevToolsProtocolEventReceived.

• Important

  Breaking Change: Changed WebMessageReceivedEventArgs get_WebMessageAsString property to a TryGetWebMessageAsString method.

• Important

  Breaking Change: Changed AcceleratorKeyPressedEventArgs Handle method to a get_Handled property.

0.8.355

NuGet package for WebView2 SDK 0.8.355

This version of the WebView2 SDK requires Microsoft Edge version 80.0.355.0 or higher.

• Released WebView2API Sample, a comprehensive guide of the WebView2 SDK. See API Sample.
• Added IME support for all languages besides English (#30).
• Updated the API surface of the WebResourceRequested event in response to bug reports. Simultaneously specifying a filter and an event on creation is now deprecated. To create a web resource requested event, use add_WebResourceRequested to add the event and AddWebResourceRequestedFilter to add a filter. RemoveWebResourceRequestedFilter removes the filter (#36) (#74).

• Important

  Breaking Change: Modified fullscreen behavior. Deprecated IsFullScreenAllowed. Now, by default, if an element in a WebView2 control (such as a video) is set to full screen, it fills the bounds of the WebView2 control. Use the ContainsFullScreenElementChanged event and get_ContainsFullScreenElement to specify how the app should resize the WebView2 control if an element wants to enter fullscreen mode.

0.8.314

NuGet package for WebView2 SDK 0.8.314

This version of the WebView2 SDK requires Microsoft Edge version 80.0.314.0 or higher.

Changes

• Added support for Windows 7, Windows 8, and Windows 8.1. See Supported platforms in Introduction to Microsoft Edge WebView2.

• Added Visual Studio and Visual Studio Code debug support for WebView2. Now, debug your script in the WebView2 right from your IDE. See How to debug when developing with WebView2 controls.

• Added Native Object Injection for the running script in WebView2 to access an IDispatch object from the Win32 component of the app and access the properties of the IDispatch object. See AddRemoteObject (#17).

• Added AcceleratorKeyPressed event. See add_AcceleratorKeyPressed (#57).

• Turned off the Context Menus. See put_AreDefaultContextMenusEnabled (#57).

• Updated DPI Awareness. Now, the DPI awareness of the WebView2 control is the same as the DPI awareness of the host app.

  Note

  If another hybrid app is launched with a different DPI Awareness than the original WebView2 control instance, the new WebView2 control instance isn't launched if the user data folder is the same (#1).

• Updated Notification Change Behavior so WebView2 automatically rejects notification permission requests prompted by web content hosted in the WebView2 control.

0.8.270

NuGet package for WebView2 SDK 0.8.270

This version of the WebView2 SDK requires Microsoft Edge version 78.0.270.0 or higher.

Changes

• Added DocumentTitleChanged event to indicate document title change (Issue #27).

• Added GetWebView2BrowserVersionInfo API (Issue #18).

• Added NewWindowRequested event.

• Updated CreateWebView2EnvironmentWithDetails function to remove releaseChannelPreference. For more information about the CreateWebView2EnvironmentWithDetails function, see CreateWebView2EnvironmentWithDetails. The registry and environment variable override is still supported. The default channel preference is used unless overridden.

  During the channel search, the WebView2 team skips any previous channel version that isn't compatible with the WebView2 SDK.

  The WebView2 team selects the more stable channel to ensure the most consistent behaviors for the end user. When you test with the latest Canary build, you should create a script to set the WEBVIEW2_RELEASE_CHANNEL_PREFERENCE environment variable to 1 before launching the app. See Test upcoming APIs and features.

• Updated the CreateWebView2EnvironmentWithDetails function with logic for selecting userDataFolder when not specified. For more information about the CreateWebView2EnvironmentWithDetails function, see CreateWebView2EnvironmentWithDetails. If you previously used the default userDataFolder location, when you switch to the new SDK the default userDataFolder is reset (set to a new location in the host code directory) and your state is also reset. If the host process doesn't have permission to write to the specified directory, the CreateWebView2EnvironmentWithDetails function might fail. You can copy the data from the old user data folder to the new directory.

0.8.230

NuGet package for WebView2 SDK 0.8.230

This version of the WebView2 SDK requires Microsoft Edge version 77.0.230.0 or higher.

Changes

• Added Stop API to stop all navigation and pending resource fetches (Issue #28).
• Added .tlb file to the NuGet package (Issue #22).
• Added .NET projects to the installer list in the NuGet package (Issue #32).

0.8.190

NuGet package for WebView2 SDK 0.8.190

This version of the WebView2 SDK requires Microsoft Edge version 77.0.190.0 or higher.

• Added get_AreDevToolsEnabled/put_AreDevToolsEnabled to control if users can open DevTools (Issue #16).
• Added get_IsStatusBarEnabled/put_IsStatusBarEnabled to control if the status bar is displayed (Issue #19).
• Added get_CanGoBack/GoBack/get_CanGoForward/GoForward for going back and forward through navigation history.
• Added HTTP header types (IWebView2HttpHeadersCollectionIterator/IWebView2HttpRequestHeaders/IWebView2HttpRequestHeaders) for viewing and modifying HTTP headers in WebView2.
• Added 32-bit WebView2 support on 64-bit machines (Issue #13).
• Added WebView2 IDL to the SDK (Issue #14).
• Added lib to support IID\_\* interface ID objects (Issue #12).
• Added include path, linking, and autocopying of DLL files to NuGet TARGET file in SDK.
• Turned on requesting window.open() in script.

0.8.149

NuGet package for WebView2 SDK 0.8.149

This version of the WebView2 SDK requires Microsoft Edge version 76.0.149.0 or higher.

Initial developer preview release.

See also

• Overview of WebView2 features and APIs - outlines many of the APIs, by feature area, that are in Release SDK packages.
• Contacting the Microsoft Edge WebView2 team