v3/internal/webview2/scripts/test.md
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.
<!-- ------------------------------ -->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 |
|---|---|
| No label | 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.
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.
<!-- ------------------------------ -->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.
<!-- Cross-framework API conventions Events: No EventHandler or CompletedHandler in .NET or WinRT. General event pattern: - Win32: add/remove_XYZ + XYZEventHandler - .NET/WinRT: XYZ event Async methods: - Win32: XYZ method + XYZCompletedHandler - .NET/WinRT: XYZAsync --> <!-- ------------------------------ -->New APIs are added in phases, as follows:
For more information, see Phases of introducing APIs in Understand the different WebView2 SDK versions.
<!-- terminology: APIs are Experimental or Stable SDKs/packages are Prerelease or Release -->The following sections cover either a Release SDK package (1.0.####.##) or a Prerelease SDK package (1.0.####-prerelease).
<!-- maintenance notes: version # patterns to check: ## 1.0.####.## [NuGet package for WebView2 SDK 1.0.####.##](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.####.##) For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version ###.0.####.## or higher. ## 1.0.####-prerelease [NuGet package for WebView2 SDK 1.0.####-prerelease](https://www.nuget.org/packages/Microsoft.Web.WebView2/1.0.####-prerelease) For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version ###.0.####.0 or higher. --> <!-- ====================================================================== -->Release Date: June 5, 2023
NuGet package for WebView2 SDK 1.0.1823.32
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 114.0.1823.32 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->LaunchingExternalUriScheme event is raised when there's an attempt to launch a URI scheme that is registered with the OS (an external URI scheme).CoreWebView2 Class:
CoreWebView2 Class:
MemoryUsageTargetLevel specifies memory consumption levels, such as low or normal.CoreWebView2 Class:
CoreWebView2 Class:
CoreWebView2Profile Class:
CoreWebView2Profile Class:
ICoreWebView2Profile6 interface:
Release Date: June 12, 2023
NuGet package for WebView2 SDK 1.0.1905-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 116.0.1905.0 or higher.
<!-- ------------------------------ -->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.CoreWebView2NavigationStartingEventArgs Class:
CoreWebView2NavigationStartingEventArgs Class:
ServiceWorkers enum value in the BrowsingDataKinds enum specifies service workers that are registered for an origin.CoreWebView2BrowsingDataKinds Enum:
CoreWebView2BrowsingDataKinds Enum:
COREWEBVIEW2_BROWSING_DATA_KINDS enum:
LaunchingExternalUriScheme event is raised when there's an attempt to launch a URI scheme that is registered with the OS (an external URI scheme).CoreWebView2 Class:
CoreWebView2 Class:
MemoryUsageTargetLevel specifies memory consumption levels, such as low or normal.CoreWebView2 Class:
CoreWebView2 Class:
wv2winrt webhosthidden entered an infinite loop when enumerating some webhosthidden types. (SDK-only)null instead of an IAsyncAction. (SDK-only)Release Date: May 8, 2023
NuGet package for WebView2 SDK 1.0.1774.30
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 113.0.1774.30 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->File object passed via WebMessage.CoreWebView2WebMessageReceivedEventArgs Class:
CoreWebView2WebMessageReceivedEventArgs Class:
CookieManager property enables the host app to get the cookie manager for the profile.CoreWebView2Profile Class:
CoreWebView2Profile Class:
ICoreWebView2Profile5 interface:
AddScriptToExecuteOnDocumentCreated before a new window is created. (Issue #2491)CoreWebView2 Class:
CoreWebView2 Class:
ICoreWebView2 interface:
X-Edge-Shopping-Flag header to be added to web requests that are coming from WebView2. (Issue #3365)Release Date: May 8, 2023
NuGet package for WebView2 SDK 1.0.1829-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 115.0.1829.0 or higher.
<!-- ------------------------------ -->The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->CoreWebView2Profile Class:
CoreWebView2Profile Class:
ICoreWebView2Profile6 interface:
PostSharedBufferToScript that stops after about 32000x1MB buffers are posted. (Issue #3360)CoreWebView2 Class:
CoreWebView2 Class:
ICoreWebView2_17 interface:
ScriptDialogOpening event callback. (Issue #3355)BackForwardCache flag.Release Date: April 13, 2023
NuGet package for WebView2 SDK 1.0.1722.45
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 112.0.1722.45 or higher.
<!-- ------------------------------ -->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.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->CoreWebView2Settings
CoreWebView2Settings
PermissionKind.WindowManagement API indicates the kind of a permission request.CoreWebView2PermissionKind Enum
CoreWebView2PermissionKind Enum
COREWEBVIEW2_PERMISSION_KIND Enum
Release Date: April 10, 2023
NuGet package for WebView2 SDK 1.0.1777-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 114.0.1777.0 or higher.
<!-- ------------------------------ -->No experimental features are added in this Prerelease SDK.
<!-- ------------------------------ -->The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->File object passed via WebMessage.CoreWebView2WebMessageReceivedEventArgs
CoreWebView2WebMessageReceivedEventArgs
CookieManager property enables the host app to get the cookie manager for the profile.CoreWebView2Profile
CoreWebView2Profile
ContainerControl. (Issue #2835).pdf temporary cached data recovery function in WebView2. (Issue #3274)DownloadStarting was getting raised for a canceled Save As dialog. (Runtime-only)Release Date: March 20, 2023
NuGet package for WebView2 SDK 1.0.1661.34
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 111.0.1661.34 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->CoreWebView2 Class
CoreWebView2Environment Class
CoreWebView2Frame Class
CoreWebView2SharedBufferAccess Enum
ReadOnlyReadWriteCoreWebView2 Class
CoreWebView2Environment Class
CoreWebView2Frame Class
CoreWebView2SharedBufferAccess Enum
ReadOnlyReadWriteCOREWEBVIEW2_SHARED_BUFFER_ACCESS
COREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_ONLYCOREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_WRITECoreWebView2PermissionKind Enum
CoreWebView2PermissionRequestedEventArgs Event
CoreWebView2Profile Class
CoreWebView2PermissionKind Enum
CoreWebView2PermissionRequestedEventArgs Event
CoreWebView2Profile Class
ICoreWebView2GetNonDefaultPermissionSettingsCompletedHandler interface
COREWEBVIEW2_PERMISSION_KIND Enum
APIs for managing tracking prevention:
CoreWebView2EnvironmentOptions Class
CoreWebView2Profile Class
CoreWebView2TrackingPreventionLevel Enum
NoneBasicBalancedStrictCoreWebView2EnvironmentOptions Class
CoreWebView2Profile Class
CoreWebView2TrackingPreventionLevel Enum
NoneBasicBalancedStrictCOREWEBVIEW2_TRACKING_PREVENTION_LEVEL enum
COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_NONECOREWEBVIEW2_TRACKING_PREVENTION_LEVEL_BASICCOREWEBVIEW2_TRACKING_PREVENTION_LEVEL_BALANCEDCOREWEBVIEW2_TRACKING_PREVENTION_LEVEL_STRICTCoreWebView2ControllerOptions Class
CoreWebView2ControllerOptions Class
Release Date: March 20, 2023
NuGet package for WebView2 SDK 1.0.1724-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 113.0.1724.0 or higher.
<!-- ------------------------------ -->CoreWebView2LaunchingExternalUriSchemeEventArgs Class
CoreWebView2LaunchingExternalUriSchemeEventArgs Class
ICoreWebView2Experimental21::remove_LaunchingExternalUriScheme
ICoreWebView2ExperimentalLaunchingExternalUriSchemeEventHandler
ICoreWebView2ExperimentalLaunchingExternalUriSchemeEventArgs
The Environment interface that returns the TextureStream interface:
The TextureStream interface:
ErrorReceivedEventArgs:
WebTextureReceivedEventArgs:
TextureStream error kind enum:
The Texture interface that the host writes to so that the Renderer will render on it:
The received WebTexture interface that the Renderer writes to so that the host will read on it:
The Environment interface that returns the TextureStream interface:
The TextureStream interface:
ErrorReceivedEventArgs:
WebTextureReceivedEventArgs:
TextureStream error kind enum:
The Texture interface that the host writes to so that the Renderer will render on it:
The received WebTexture interface that the Renderer writes to so that the host will read on it:
The Environment interface that returns the TextureStream interface:
The TextureStream interface:
Supplemental TextureStream* interfaces:
TextureStream error kind enum:
Other interfaces (RenderAdapter):
The Texture interface that the host writes to so that the Renderer will render on it:
The received WebTexture interface that the Renderer writes to so that the host will read on it:
Added support for custom data partition:
Added support for cookie manager:
Add support for managing profile deletion:
Added support for custom data partition:
Added support for cookie manager:
Add support for managing profile deletion:
Added support for custom data partition:
Added support for cookie manager:
Add support for managing profile deletion:
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->PrintAsync and PrintToPdfStreamAsync that throws an exception when print settings are null.Release Date: February 15, 2023
NuGet package for WebView2 SDK 1.0.1587.40
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 110.0.1587.40 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->Release Date: February 15, 2023
NuGet package for WebView2 SDK 1.0.1671-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 112.0.1671.0 or higher.
<!-- ------------------------------ -->Also added support for Experimental Object Collection View API:
The above interface is currently being used for:
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->Previous name in 1619-prerelease:
Previous name in 1619-prerelease:
Previous name in 1619-prerelease:
BeforeUnload event was received. (Runtime-only) (Issue #2677)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.System.ArgumentException was thrown when a call to the HostObject method returns a non-generic task. (Issue #2787)SharedBuffer API where the stream object didn't work well with StreamWriter. (Runtime-only) (Issue #3108)SpeechSynthesis.getVoices(), will now work in UWP apps. (Runtime-only)CreateWebResourceResponse with a null reason phrase. (Runtime-only)CoreWebView2.AddHostObjectToScript option chrome.webview.hostObjects.options.ignoreMemberNotFoundError now works in non-English locales. (Runtime-only)Release Date: January 17, 2023
NuGet package for WebView2 SDK 1.0.1518.46
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 109.0.1518.46 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->Release Date: January 19, 2023
NuGet package for WebView2 SDK 1.0.1619-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 111.0.1619.0 or higher.
<!-- ------------------------------ -->MultipleAutomaticDownloadsFileReadWriteAutoplayLocalFontsMidiSystemExclusiveMessageAccessMultipleAutomaticDownloadsFileReadWriteAutoplayLocalFontsMidiSystemExclusiveMessageAccessCOREWEBVIEW2_PERMISSION_KIND_MULTIPLE_AUTOMATIC_DOWNLOADSCOREWEBVIEW2_PERMISSION_KIND_FILE_READ_WRITECOREWEBVIEW2_PERMISSION_KIND_AUTOPLAYCOREWEBVIEW2_PERMISSION_KIND_LOCAL_FONTSCOREWEBVIEW2_PERMISSION_KIND_MIDI_SYSTEM_EXCLUSIVE_MESSAGE_ACCESSThe following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->Release Date: December 12, 2022
NuGet package for WebView2 SDK 1.0.1462.37
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 108.0.1462.37 or higher.
<!-- ------------------------------ -->This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1466-prerelease.
<!-- ====================================================================== -->Release Date: December 12, 2022
NuGet package for WebView2 SDK 1.0.1549-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 110.0.1549.0 or higher.
<!-- ------------------------------ -->The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
<!-- ------------------------------ -->Release Date: October 31, 2022
NuGet package for WebView2 SDK 1.0.1418.22
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 107.0.1418.22 or higher.
<!-- ------------------------------ -->This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1414-prerelease.
<!-- ====================================================================== -->Release Date: October 31, 2022
NuGet package for WebView2 SDK 1.0.1466-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 109.0.1466.0 or higher.
<!-- ------------------------------ -->BufferFileMappingHandleSizeCloseDisposeOpenStreamBufferSizeCloseOpenStreamCloseget_Bufferget_FileMappingHandleget_SizeOpenStreamiframe:JavaScript parameter in the current top-level document:ColumnNumberLineNumberMessageNameToJsonColumnNumberLineNumberMessageNameToJsonget_ColumnNumberget_LineNumberget_Messageget_Nameget_ToJsonAllowedCertificateAuthorities in add_ClientCertificateRequested event as a Base64 string. (Runtime-only) (Issue #2346)WebResourceRequested event is subscribed to. (Runtime-only)AddHostObjectToScript bug in which, when JavaScript calls an async method and then a synchronous method, the async method call might fail.Release Date: October 11, 2022
NuGet package for WebView2 SDK 1.0.1370.28
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 106.0.1370.28 or higher.
<!-- ------------------------------ -->The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ------------------------------ -->Release Date: October 11, 2022
NuGet package for WebView2 SDK 1.0.1414-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 107.0.1414.0 or higher.
<!-- ------------------------------ -->CoreWebView2.GetDevToolsEventReceiver event. (SDK-only)Release Date: September 6, 2022
NuGet package for WebView2 SDK 1.0.1343.22
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 105.0.1343.22 or higher.
<!-- ------------------------------ -->This WebView2 SDK release has the same bug fixes as Bug fixes for 1.0.1369-prerelease.
<!-- ====================================================================== -->Release Date: September 6, 2022
NuGet package for WebView2 SDK 1.0.1369-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 106.0.1369.0 or higher.
<!-- ------------------------------ -->The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
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.
Release Date: August 8, 2022
NuGet package for WebView2 SDK 1.0.1293.44
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 104.0.1293.44 or higher.
The following APIs have been promoted to Stable and are now included in this Release SDK.
Release Date: August 8, 2022
NuGet package for WebView2 SDK 1.0.1340-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 105.0.1340.0 or higher.
WebResourceRequested for workers which allows setting filters in order to receive WebResourceRequested events for service workers, shared workers, and different origin iframes.WebResourceRequested event for requests with the specified scheme and be able to navigate the WebView2 control to the custom scheme.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)
Release Date: July 4, 2022
NuGet package for WebView2 SDK 1.0.1264.42
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 103.0.1264.42 or higher.
The following APIs have been promoted to Stable and are now included in this Release SDK.
ContextMenuRequestedAPI to enable host app to create or modify their own context menu.Release Date: July 4, 2022
NuGet package for WebView2 SDK 1.0.1305-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 105.0.1305.0 or higher.
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
PrintToPdfAsync may hang for long time. (Issue #1974)Release Date: June 14, 2022
NuGet package for WebView2 SDK 1.0.1245.22
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 102.0.1245.22 or higher.
There is no corresponding prerelease package.
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:
ClearBrowsingDataClearBrowsingDataAllClearBrowsingDataInTimeRangeThe HttpStatusCode API which provides the HTTP status code for navigation requests in NavigationCompleted events.
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.WebResourceRequested events using large data. (Issue #2171)StatusBarTextChanged regression. The StatusBarText API was made compatible with previous versions again. (Issue #2414)Release Date: May 9, 2022
NuGet package for WebView2 SDK 1.0.1210.39
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 101.0.1210.39 or higher.
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.
Release Date: May 9, 2022
NuGet package for WebView2 SDK 1.0.1248-prelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 102.0.1248.0 or higher.
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:
clearBrowsingDataInTimeRangeclearBrowsingDataAllFixed 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.
Release Date: April 12, 2022
NuGet package for WebView2 SDK 1.0.1185.39
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 100.0.1185.39 or higher.
ICoreWebView2Certificate to ICoreWebView2ClientCertificate.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_StatusBarTextChangedget_StatusBarTextremove_StatusBarTextChangedThe 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_PermissionRequestedremove_PermissionRequestedRelease Date: April 12, 2022
NuGet package for WebView2 SDK 1.0.1222-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 102.0.1222.0 or higher.
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.
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.
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)
Release Date: March 10, 2022
NuGet package for WebView2 SDK 1.0.1150.38
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 99.0.1150.38 or higher.
The following APIs have been promoted to Stable and are now included in this Release SDK.
Release Date: March 10, 2022
NuGet package for WebView2 SDK 1.0.1189-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 100.0.1189.0 or higher.
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
add_StatusBarTextChangedget_StatusBarTextremove_StatusBarTextChangedDocumentTitleChanged event was not being raised for backward/forward navigation in single-page apps.HistoryChanged event was not being raised for Iframe navigation.Release Date: February 6, 2022
NuGet package for WebView2 SDK 1.0.1108.44
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 98.0.1108.44 or higher.
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_NavigationStartingremove_NavigationStartingadd_ContentLoadingremove_ContentLoadingadd_NavigationCompletedremove_NavigationCompletedadd_DOMContentLoadedremove_DOMContentLoadedExecuteScriptPostWebMessageAsJsonPostWebMessageAsStringadd_WebMessageReceivedremove_WebMessageReceivedRelease Date: February 6, 2022
NuGet package for WebView2 SDK 1.0.1158-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 100.0.1158.0 or higher.
DevToolsProtocol targets in WebView2.The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
add_PermissionRequestedremove_PermissionRequestedRelease Date: January 13, 2022
NuGet package for WebView2 SDK 1.0.1072.54
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 97.0.1072.54 or higher.
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:
Release Date: January 13, 2022
NuGet package for WebView2 SDK 1.0.1133-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 99.0.1133.0 or higher.
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
PostWebMessageAsJsonPostWebMessageAsStringadd_WebMessageReceivedremove_WebMessageReceivedSet-Cookies header from showing up in the WebResourceResponseReceived event.GetAvailableBrowserVersionString() fails to locate/load WebView2Loader.dll. (Issue #1236)window.open when NewWindowRequested event was not
handled. (Issue #1343)Release Date: November 29, 2021
NuGet package for WebView2 SDK 1.0.1083-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 97.0.1083.0 or higher.
Added the following APIs for iframes in WebView2:
PostWebMessageAsJsonPostWebMessageAsStringadd_WebMessageReceivedremove_WebMessageReceivedAdded ProcessInfo APIs to provide more information about WebView2 processes and process collections.
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Release Date: November 29, 2021
NuGet package for WebView2 SDK 1.0.1054.31
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 96.0.1054.31 or higher.
Release Date: October 29, 2021
NuGet package for WebView2 SDK 1.0.1056-prerelease
For full API compatibility, this version of the WebView2 SDK requires Microsoft Edge version 97.0.1056.0 or higher.
ExitCode in ICoreWebView2ProcessFailedEventArgs2 for COREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED process failure.--js-flags switch is now honored in the AdditionalBrowserArguments that are provided in CoreWebView2EnvironmentOptions.name property for host objects in JavaScript. (Issue #641)InvalidCastException in the WPF control when it's implicitly initialized prior to the event loop starting. (Issue #1577)Release Date: October 25, 2021
NuGet package for WebView2 SDK 1.0.1020.30
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 95.0.1020.30 or higher.
EnsureCoreWebView2Async to not throw exceptions when the WPF source property is set. (Issue #1781)The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ====================================================================== -->Release Date: September 27, 2021
NuGet package for WebView2 SDK 1.0.992.28
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 94.0.992.31 or higher.
PlatformTarget isn't set in the user's .NET project. (Issue #1061)The following APIs have been promoted to Stable and are now included in this Release SDK.
ICoreWebView2NewWindowRequestedEventArgs2 interface.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.
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.
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.
MediaDevices.getDisplayMedia() is used. (Issue #1566)window.chrome.webview was unavailable in new windows in the same parent domain. This change is Runtime-specific. (Issue #1144)put_IsVisible(false). (Issue #238)SetVirtualHostNameToFolderMapping to pop-up windows.IDispatch objects were returned as IUnknown.The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
IsSwipeNavigationEnabledBrowserProcessExitedOpenBrowserTaskManagerRelease Date: September 8, 2021
NuGet package for WebView2 SDK 1.0.961.33
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 93.0.961.44 or higher.
ERR_SSL_CLIENT_AUTH_CERT_NEEDED errors. This is a Runtime change.AreBrowserAcceleratorKeysEnabled. This change is Runtime-specific.about:blank pages. This is a Runtime change.The following APIs have been promoted to Stable and are now included in this Release SDK.
<!-- ====================================================================== -->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.
edge://history.edge://downloads and edge://history pages. This change is Runtime-specific.NewWindowRequested event handler launched two windows when handling links that use target=_blank.add_WebResourceRequested didn't work on WebView2 controls created using add_NewWindowRequested. (Issue #616)NavigationStarting, AddHostObjectToScript methods, WebMessageReceived, and NewWindowRequested. (Issue #1092)PermissionRequested event for the microphone. This change is Runtime-specific.(Issue #1462)ExecuteScriptAsync blocked after several successful runs. This change is Runtime-specific. (Issue #1348)ResultFilePath in DownloadStartingEventArgs. (Issue #1428)The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Release Date: July 26, 2021
NuGet package for WebView2 SDK 1.0.902.49
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 92.0.902.49 or higher.
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)AddScriptToExecuteOnDocumentCreated didn't work on child windows. (Issue #935)NavigationCompleted events to be incorrect. (Issue #1142)The following APIs have been promoted to Stable and are now included in this Release SDK.
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.
Refresh, Home, and Back can't be disabled by AreBrowserAcceleratorKeysEnabled. This change is Runtime-specific.WebResourceRequested event handler is attached. This change is Runtime-specific. (Issue #1183).DefaultBackgroundColor transparency. This change is Runtime-specific. (Issue #1108).DefaultBackgroundColor API for Windows 7.The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
[!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.
Release Date: May 31, 2021
NuGet package for WebView2 SDK 1.0.864.35
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 91.0.864.35 or higher.
WebView2.h file. (Issue #1209).NewWindowRequested documentation. (Issue #448).The following APIs have been promoted to Stable and are now included in this Release SDK.
CoreWebView2WebResourceRequest headers collection. (Issue #1123).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.
iframe element support from AddHostObjectToScriptWithOrigins.Chromium DevTools Protocol message with POST binary data in WebView2.OpenSaveAsAwareness download UI, because it included links to edge://settings. (Issue #1120).CoreWebView2InitializationCompleted. (Issue #1050).ProcessFailed event, without a crash. (Issue #996).Release Date: April 21, 2021
NuGet package for WebView2 SDK 1.0.818.41
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 90.0.818.41 or higher.
ProcessFailed event. It now raises for non-renderer child processes and frame renderers.iframe element support for AddScriptToExecuteOnDocumentCreated..exe application files with malformatted version information. (Issue #850).--winhttp-proxy-resolver from WebView2 browser process command-line, turned on other proxy command-line options for WebView2.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.
ProcessFailed event. It now raises for non-renderer child processes and frame renderers.iframe element support for AddScriptToExecuteOnDocumentCreated.The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Rasterization Scale APIs:
WebResourceRequested event. (Issue #568).edge:// causes browser process to exit. (Issue #604).Release Date: March 8, 2021
NuGet package for WebView2 SDK 1.0.774.44
For full API compatibility, this version of the WebView2 SDK requires WebView2 Runtime version 89.0.774.44 or higher.
The following APIs have been promoted to Stable and are now included in this Release SDK.
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.
[!IMPORTANT] Breaking Change: WebView2 prerelease package 1.0.781 is deprecated. Discontinue development with package 1.0.781.
[!IMPORTANT] WebView2 prerelease package 0.9.430 is deprecated, and is removed with the next release. If your WebView2 app uses the package, the WebView2 team recommends that you move to a newer package.
CreateCookieWithCookie method with the CopyCookie method.CreateCoreWebView2CompositionController method from ICoreWebView2Environment3.AreDefaultContextMenusEnabled is false. (Issue #605).E_NOINTERFACE when querying ICoreWebView2 for ICoreWebView2Experimental. (Issue #691).CoreWebView2NavigationStartingEventArgs.Cancel is set to false. (Issue #400).window.print() on pop-up windows with event handlers attached to NewWindowRequested events. (Issue #409).HRESULT instances passed by ICoreWebView2WebResourceResponseViewGetContentCompletedHandler::Invoke.WebView2.Dispose when hosted in multiple windows. (Issue #816) and Issue #442).The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
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.
The following APIs have been promoted to Stable and are now included in this Release SDK.
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.
[!IMPORTANT] Breaking Change: WebView2 prerelease package 1.0.707 and package 0.9.628 are deprecated. Discontinue development with package 1.0.707 and package0.9.628.
Added WebView2 Group Policies. For best practices, see group policies for WebView2.
[!IMPORTANT] Breaking Change: Deprecated the old registry location.
text{Root}\Software\Policies\Microsoft\EmbeddedBrowserWebView\LoaderOverride\{AppId}
Added support for Drag and Drop in WebView2.
Added APIs to handle DPI support.
RasterizationScale property if needed.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).
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
CoreWebView2Ready with CoreWebView2InitializationCompleted.AcceleratorKey select in WebView2. (Issue #288).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.
[!IMPORTANT] Announcement: .NET WPF/WinForms WebView2 SDKs are now Generally Available (GA). Starting with this release, Release SDKs are forward-compatible. For more details, see GA announcement blog post.
CoreWebView2NewWindowRequestedEventArgs.Handled prevents new window from being opened. (Issue #549 and Issue #560).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.
version.lib when using WebView2 static library.CoreWebView2Environment variable.Microsoft.Web.WebView2.Core namespace to subclasses of System.EventArgs or System.ComponentModel.CancelEventArgs. (Issue #250)EdgeNotFoundException to WebView2RuntimeNotFoundException.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.
[!IMPORTANT] Announcement: Win32 C/C++ WebView2 is now Generally Available (GA). Starting this release, Release SDKs are forward-compatible. See GA announcement blog post.
For more information about the Runtime, Evergreen distribution, and Fixed Version distribution, see Distribute your app and the WebView2 Runtime.
<!-- ====================================================================== -->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.
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.
[!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:
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.
ZoomFactor property on WPF Webview2 Controller.NuGet package for WebView2 SDK 0.9.538
This version of the WebView2 SDK requires Microsoft Edge version 85.0.538.0 or higher.
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.
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).
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.
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.
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 nowCOREWEBVIEW2_*.- GetCoreWebView2BrowserVersionInfo is now GetAvailableCoreWebView2BrowserVersionString.
- get_BrowserVersionInfo is now get_BrowserVersionString.
- AddRemoteObject is now AddHostObjectToScript.
- RemoveRemoteObject is now RemoveHostObjectFromScript.
chrome.webview.remoteObjectsis nowchrome.webview.hostObjects.
[!IMPORTANT] Breaking Change: The
AddRemoteObjectJS proxy methods are also renamed.
getLocalis nowgetLocalProperty.setLocalis nowsetLocalProperty.getRemoteis nowgetHostProperty.setRemoteis nowsetHostProperty.applyRemoteis nowapplyHostFunction.
[!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.
POINTER_INFO. This object is passed to SendPointerInput to inject pointer input into the WebView2.cursor property on the CompositionController tells the app what the mouse cursor should currently be for the WebView2.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
IWebView2WebViewtoICoreWebView2in 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 separatedICoreWebView2into ICoreWebView2 and ICoreWebView2Host.ICoreWebView2Hostsupports 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
SourceChangedevent is run. When the history state is changed theHistoryChangedevent is run. TheContentLoadingevent is run before the initial script when a new document is being loaded.
Added support for ARM64 architecture.
Added Soft InputWidget 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
DevToolsProtocolEventReceivedbehavior. 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
WebMessageReceivedEventArgsget_WebMessageAsString property to a TryGetWebMessageAsString method.
[!IMPORTANT] Breaking Change: Changed
AcceleratorKeyPressedEventArgsHandle method to a get_Handled property.
NuGet package for WebView2 SDK 0.8.355
This version of the WebView2 SDK requires Microsoft Edge version 80.0.355.0 or higher.
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.
NuGet package for WebView2 SDK 0.8.314
This version of the WebView2 SDK requires Microsoft Edge version 80.0.314.0 or higher.
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 folderis the same (#1).
Updated Notification Change Behavior so WebView2 automatically rejects notification permission requests prompted by web content hosted in the WebView2 control.
NuGet package for WebView2 SDK 0.8.270
This version of the WebView2 SDK requires Microsoft Edge version 78.0.270.0 or higher.
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.
NuGet package for WebView2 SDK 0.8.230
This version of the WebView2 SDK requires Microsoft Edge version 77.0.230.0 or higher.
Stop API to stop all navigation and pending resource fetches (Issue #28)..tlb file to the NuGet package (Issue #22).NuGet package for WebView2 SDK 0.8.190
This version of the WebView2 SDK requires Microsoft Edge version 77.0.190.0 or higher.
get_AreDevToolsEnabled/put_AreDevToolsEnabled to control if users can open DevTools (Issue #16).get_IsStatusBarEnabled/put_IsStatusBarEnabled to control if the status bar is displayed (Issue #19).get_CanGoBack/GoBack/get_CanGoForward/GoForward for going back and forward through navigation history.IWebView2HttpHeadersCollectionIterator/IWebView2HttpRequestHeaders/IWebView2HttpRequestHeaders) for viewing and modifying HTTP headers in WebView2.IID\_\* interface ID objects (Issue #12).TARGET file in SDK.window.open() in script.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.
<!-- ====================================================================== -->