Archived Release Notes for the WebView2 SDK
These Release Notes provide information about added features and bug fixes that are included in the WebView2 Release SDK and the WebView2 Prerelease SDK, for older releases.
1.0.2592.51
Release Date: June 19, 2024
NuGet package for WebView2 SDK 1.0.2592.51
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 126.0.2592.51 or higher.
Promotions
No additional APIs have been promoted to Stable and added in this Release SDK.
Bug fixes
Runtime-only
Disabled
BreakoutBoxPreferCaptureTimestampInVideoFrame
for WebView2TextureStream
.Fixed a regression where the
WindowCloseRequested
event only fires for firstwindow.close()
call.Fixed a regression where typed arrays in WinRT JavaScript projection could not be handled as
IDispatch
in the host.Fixed a bug where the autofill popup dismisses immediately and causes a focus change.
Fixed a bug where WebView2 fails to load because of
AppPolicyGetWindowingModel
. (Issue #4591)
1.0.2646-prerelease
Release Date: June 19, 2024
NuGet package for WebView2 SDK 1.0.2646-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 128.0.2646.0 or higher.
General features
- Added support for C#/WinRT .NET 6+.
Experimental features
- Introduced the feature flag
msWebView2EnableDownloadContentInWebResourceResponseReceived
, an an Experimental feature (rather than as a Stable feature). When this flag is enabled, this allows responses of navigations that become downloads to be available inWebResourceResponseReceived
.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added a new
SaveFileSecurityCheckStarting
event. As a developer, you can register a handler on this event to get the file path, filename extension, and document origin URI information. Then you can apply your own rules to do actions such as the following:- Allow saving the file without presenting a default security-warning UI about the file-type policy.
- Cancel the saving.
- Create your own UI to manage runtime file-type policies.
CoreWebView2
Class:CoreWebView2SaveFileSecurityCheckStartingEventArgs Class
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
- CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method
- Added a new
ScreenCaptureStarting
event. This event is raised whenever the WebView2 and/or iframe that corresponds to theCoreWebView2Frame
(or to any of its descendant iframes) requests permission to use the Screen Capture API before the UI is shown. As a developer, you can then choose to block the UI from being displayed, or allow the UI to be displayed.
CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2ScreenCaptureStartingEventArgs
Class:
- Added a new
GetComICoreWebView2
method to theCoreWebView2
.NET class that enables you to convert aCoreWebView2
between .NET and COM. Added a new WinRT interface that enables you to convert aCoreWebView2
between WinRT and COM. This allows you to interoperate between libraries that are written in different languages.
CoreWebView2
Class:
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Updated the WebMessageObjects API to allow injecting DOM objects into WebView2 content that's constructed via the app, and via the
CoreWebView2.PostWebMessage
API in the other direction. Added a new web object type to represent a file system handle that can be posted to the web content to provide it with filesystem access.
CoreWebView2
Class:CoreWebView2Environment
Class:CoreWebView2FileSystemHandle
Class:CoreWebView2FileSystemHandleKind Enum
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
Bug fixes
Runtime-only
- Fixed a bug in owned-window activation logic for visual hosting.
1.0.2535.41
Release Date: May 28, 2024
NuGet package for WebView2 SDK 1.0.2535.41
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 125.0.2535.41 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Support for the Fluent Style Overlay Scrollbar.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
Bug fixes
Runtime-only
Fixed a bug where if the
LaunchingExternalURIScheme
event handler is attached, and the always remember checkbox is enabled, and the user selects this checkbox, the dialog is incorrectly displayed again.Fixed an issue where text edit controls in visual hosting would duplicate IME input when losing and then regaining focus.
Fixed an issue where full-trust UWP apps couldn't display owned windows.
SDK-only
- Fixed an issue in the SDK causing erroneous <Platform> values in the .NET project platforms list. (Issue #1755)
1.0.2584-prerelease
Release Date: May 28, 2024
NuGet package for WebView2 SDK 1.0.2584-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 126.0.2584.0 or higher.
Experimental features
- Introduced an option to cancel the initial navigation in WebView2, to improve startup performance. This change is disabled by default, and can be enabled by using the
msWebView2CancelInitialNavigation
feature flag.
Experimental APIs
No Experimental APIs have been added in this Prerelease SDK.
Promotions
No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Bug fixes
Runtime and SDK
- Fixed a crash when .NET host object async methods return a null result. (Issue #4509)
Runtime-only
Fixed a WebView2 memory leak issue when the window is closed. (Issue #4286)
Fixed an issue where
ignoreMemberNotFoundError
wasn't working for .NET objects. (Issue #4497)Now returns a proper error code when
CreateSharedBuffer
is called with 0 buffer size. (Issue #4554)Fixed an activation issue for the caret browsing dialog.
Fixed an issue where the WebView2 Visual Hosting
CursorChanged
event wasn't firing for custom cursors.
1.0.2478.35
Release Date: April 22, 2024
NuGet package for WebView2 SDK 1.0.2478.35
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 124.0.2478.35 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Added the Runtime selection feature to support more prerelease testing and flighting scenarios. You can specify
ReleaseChannels
to choose which channels are searched for during environment creation, andChannelSearchKind
to select a search order.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels Enum
None
Stable
Beta
Dev
Canary
Bug fixes
Runtime-only
- Fixes a potential integer overflow that could lead to a crash when using
AdditionalObjects
in the WebMessage API.
1.0.2526-prerelease
Release Date: April 22, 2024
NuGet package for WebView2 SDK 1.0.2526-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 125.0.2526.0 or higher.
Breaking changes
The minimum .NET Framework version requirement for .NET WebView2, including WPF and WinForms controls, has been updated from .NET Framework 4.5 to .NET Framework 4.6.2.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added
SaveAs
APIs that allow you to programmatically perform the Save as operation. You can use these APIs to block the default Save as dialog, and then either save silently, or build your own UI for Save as. These APIs pertain only to the Save as dialog, not the Download dialog, which continues to use the existing Download APIs.
CoreWebView2
Class:-
Complete
Default
HtmlOnly
SingleFile
CoreWebView2SaveAsUIResult Enum
Cancelled
FileAlreadyExists
InvalidPath
KindNotSupported
Success
CoreWebView2SaveAsUIShowingEventArgs
Class:- CoreWebView2SaveAsUIShowingEventArgs.AllowReplace Property
- CoreWebView2SaveAsUIShowingEventArgs.Cancel Property
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType Property
- CoreWebView2SaveAsUIShowingEventArgs.Kind Property
- CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
- CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog Property
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Support for the Fluent Style Overlay Scrollbar.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
Bug fixes
Runtime and SDK
Fixed a bug in WinRT JavaScript projection where passing in a typed array resulted in an "Interface Not Supported" error. (Issue #3486)
Added support for handling
out
array parameters in WinRT JavaScript projection.
Runtime-only
Fixed a bug where the Image Auto-captioning feature was enabled by default.
Fixed a bug where if the
LaunchingExternalURIScheme
event handler is attached, if the always remember checkbox is enabled and the user selects this checkbox, the dialog will incorrectly be shown again.Fixed
GetNonClientRegionAtPoint
incorrectly returningNowhere
for some points.Fixed a bug where the Text Services Framework would disconnect upon dropping a file onto a WebView2 region.
Fixed a bug where the View Source Ctrl+U keyboard shortcut remained enabled when the
AreDevToolsEnabled
setting wasfalse
.Fixed a bug where a composable IME was duplicated upon regaining focus. (Issue #1610)
Ensured that
devicePixelRatio
is synchronized with custom rasterization scales. (Issue #3060)Fixed a race condition when using
CallDevToolsProtocolMethod
events inNewWindowRequested
. (Issue #4181)Fixed a crash that can occur in WPF
TabIntoCore
when theController
has been destroyed but the user tries to tab into the control (pressing the Tab key). (Issue #4452)Ensured that spellcheck takes input language with case-insensitive format.
Made the Language API more robust regarding user input.
Fixed a bug where the Save password? prompt is not displayed.
SDK-only
- Fixed missing
AreBrowserExtensionsEnabled
API in WinRT projection.
1.0.2420.47
Release Date: March 25, 2024
NuGet package for WebView2 SDK 1.0.2420.47
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 123.0.2420.47 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Added a new API to provide hit-testing results on the regions that a WebView2 contains. This API is useful for visually hosted applications that want to handle mouse events on the non-client area of the WebView2 window.
CoreWebView2CompositionController
Class:CoreWebView2NonClientRegionChangedEventArgs
Class:CoreWebView2NonClientRegionKind Enum
Caption
Client
Nowhere
CoreWebView2Settings
Class:
- Added the
FailureSourceModulePath
property to theProcessFailedEventArgs
type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
Bug fixes
SDK-only
- The .NET assemblies for WinForms and WPF are now shipped with optimization enabled. (Issue #4409)
1.0.2470-prerelease
Release Date: March 25, 2024
NuGet package for WebView2 SDK 1.0.2470-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires WebView2 Runtime version 124.0.2470.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Support for the Fluent Style Overlay Scrollbar.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ScrollbarStyle Enum
Default
FluentOverlay
- Updated the WebMessageObjects API to allow injecting DOM objects into WebView2 content that's constructed via the app and via the
CoreWebView2.PostWebMessage
API in the other direction. Added a new web object type to represent a file system handle that can be posted to the web content to provide it with filesystem access.
CoreWebView2
Class:CoreWebView2Environment
Class:CoreWebView2FileSystemHandle
Class:CoreWebView2FileSystemHandleKind Enum
File
Directory
CoreWebView2FileSystemHandlePermission Enum
ReadOnly
ReadWrite
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Added the Runtime selection feature to support more prerelease testing and flighting scenarios. You can specify
ReleaseChannels
to choose which channels are searched for during environment creation, andChannelSearchKind
to select a search order.
CoreWebView2EnvironmentOptions
Class:CoreWebView2ChannelSearchKind Enum
MostStable
LeastStable
CoreWebView2ReleaseChannels Enum
None
Stable
Beta
Dev
Canary
- Added the
FailureSourceModulePath
property to theProcessFailedEventArgs
type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
Bug fixes
Runtime-only
Fixed a reliability regression that could crash the application process when an old version of WebView2 client DLL is unloaded.
Ensured that the WebView2 temporary download folder is unique per user data folder, and doesn't interfere with other apps or the browser.
1.0.2365.46
Release Date: February 26, 2024
NuGet package for WebView2 SDK 1.0.2365.46
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 122.0.2365.46 or higher.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Added support for
WebResourceRequested
for workers, which allows setting filters in order to receiveWebResourceRequested
events for service workers, shared workers, and different-origin iframes.
CoreWebView2
Class:CoreWebView2WebResourceRequestedEventArgs
Class:
- To support browser extensions in WebView2, added
GetBrowserExtensions
for WinRT:
Bug fixes
Runtime-only
Fixed a regression that affected handling of the
NewWindowRequested
event when the new window is set to be the source WebView. (Issue #4250)Fixed a bug where closing a WebView that has an embedded PDF viewer could lead to a crash. (Issue #3832)
Fixed a regression where mouse-clicks stopped working when the application enabled
SetWindowDisplayAffinity
. (Issue #4325)
1.0.2415-prerelease
Release Date: February 26, 2024
NuGet package for WebView2 SDK 1.0.2415-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 123.0.2415.0 or higher.
Breaking changes
- The behavior of the
InitiatingOrigin
property ofCoreWebView2LaunchingExternalUriSchemeEventArgs
has changed. If theInitiatingOrigin
is an opaque origin, theInitiatingOrigin
that's reported in the event args is its precursor origin. The precursor origin is the origin that created the opaque origin. For example, if a frame that's atexample.com
opens a subframe that has a different opaque origin, the subframe's precursor origin isexample.com
.
CoreWebView2LaunchingExternalUriSchemeEventArgs
Class:
- The members of the
CoreWebView2TextureStreamErrorKind
enum have been renamed:
Old member names:
- CoreWebView2TextureStreamErrorKind Enum
CoreWebView2TextureStreamErrorNoVideoTrackStarted
CoreWebView2TextureStreamErrorTextureError
CoreWebView2TextureStreamErrorTextureInUse
New member names:
- CoreWebView2TextureStreamErrorKind Enum
NoVideoTrackStarted
TextureError
TextureInUse
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- The
CoreWebView2ControllerOptions
class now has anAllowHostInputProcessing
property, which allows user input messages (keyboard, mouse, touch, and pen) to pass through the browser window to be received by an app process window.
CoreWebView2ControllerOptions
Class:
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Added a new API to provide hit-testing results on the regions that a WebView2 contains. This API is useful for visually hosted applications that want to handle mouse events on the non-client area of the WebView2 window.
CoreWebView2CompositionController
Class:CoreWebView2Settings
Class:
Bug fixes
Runtime-only
Fixed the camera or mic not being able to open in Google Meet or Microsoft Teams meetings when the permission request is set to "not persisted" (that is,
SavesInProfile = false
). (Issue #3592)Fixed appending an empty
--edge-webview-custom-scheme
command-line switch in a WebView2 browser process.Disabled the global
UserDataFolder
registry key, so that this registry key can only be applied per-app.Fixed the
NewWindowRequested
event not being fired when opened by a browser extension. (Issue #3841)Fixed the
NewWindowRequested
event not being fired when opening a view source. (Issue #4162)Fixed an issue to fire
StateChanged
andBytesReceivedChanged
events when a download involves navigation.Fixed a bug where the
BeforeUnload
dialog caused the WebView2 window to unexpectedly jump position. (Issue #4350)Fixed an issue where
PrintAsync
prints a blank page if it is called too soon, before the PDF is fully loaded. (Issue #3779)
1.0.2277.86
Release Date: February 5, 2024
NuGet package for WebView2 SDK 1.0.2277.86
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 121.0.2277.86 or higher.
Breaking changes
Important
Breaking Change: Navigations to about:blank
are now cancellable via the NavigationStarting
event. To revert to the old behavior, disable the msWebView2CancellableAboutNavigations
feature flag.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
ExecuteScriptWithResult
provides exception information if the script failed.TryGetResultAsString
gets the script execution result as a string rather than as JSON, to make it more convenient to interact with string results:
CoreWebView2
Class:
Bug fixes
Runtime-only
Ensured that the spellcheck language matches
put_Language
programmatically. The customized context menu is also updated with correct spellchecks. (Runtime-only)Fixed a bug that stopped raising the
NavigationCompleted
event for some websites that load AV1-encoded videos. (Runtime-only) (Issue #3801)Fixed an issue where host-process COM resources would be released during WebView tear-down. (Runtime-only) (Issue #4226)
Fixed a bug that broke loading some social media apps such as Facebook, Twitter, and Linkedin. This change is Runtime-specific. (Runtime-only) (Issue #4281)
1.0.2357-prerelease
Release Date: January 30, 2024
NuGet package for WebView2 SDK 1.0.2357-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 122.0.2357.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added the Runtime selection feature to support more prerelease testing and flighting scenarios. Developers can specify
ReleaseChannels
to choose which channels are searched for during environment creation, andChannelSearchKind
to select a search order.
- Added a new API to provide hit-testing results on the regions that a WebView2 contains. This API is useful for visually hosted applications that want to handle mouse events on the non-client area of the WebView2 window.
CoreWebView2CompositionController
Class:CoreWebView2Settings
Class:
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
CoreWebView2AcceleratorKeyPressedEventArgs
has a newIsBrowserAcceleratorKeyEnabled
property to allow you to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Class:
- 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:
CoreWebView2Environment
Class:CoreWebView2ProcessExtendedInfo
Class:CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2FrameInfo
Class:
ExecuteScriptWithResult
provides exception information if the script failed.TryGetResultAsString
gets the script execution result as a string rather than as JSON, to make it more convenient to interact with string results:
CoreWebView2
Class:
CreateFromComICoreWebView2
wraps an existingICoreWebView2
object in aCoreWebView2
instance, to allow .NET devs to interact with an control that was created in C++.
CoreWebView2
Class:
- To support browser extensions in WebView2, added
GetBrowserExtensions
for WinRT:
- Added support for
WebResourceRequested
for workers, which allows setting filters in order to receiveWebResourceRequested
events for service workers, shared workers, and different origin iframes.
CoreWebView2
Class:CoreWebView2WebResourceRequestedEventArgs
Class:
Bug fixes
Runtime-only
Fixed a bug where closing a WebView control that has an embedded PDF viewer could lead to a crash. (Runtime-only) (Issue #3832)
Fixed issues with stacking of child-process taskbar icons. (Runtime-only) (Issue #3245)
Fixed a bug that sent an unnecessary network request for Edge Cloud Config Service. (Runtime-only) (Issue #4180)
Updated the behavior of the
app-region
CSS property so that changes to its value trigger a page re-layout. (Runtime-only)Fixed an issue where
put_AreBrowserAcceleratorKeysEnabled
wasn't able to update settings for WebView2 when noAcceleratorKeyPressed
event handler is registered. (Runtime-only) (Issue #4278)
SDK-only
Fixed an issue where the WebView2 control in .NET was failing to find the
WebView2Loader.dll
on UNC paths. (SDK-only) (Issue #4081)Fixed some issues causing instances of
InvalidOperationException
in .NET controls, that weren't helpful to developers. (SDK-only) (Issue #4272)
1.0.2210.55
Release Date: December 11, 2023
NuGet package for WebView2 SDK 1.0.2210.55
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 120.0.2210.55 or higher.
Breaking changes
Important
Breaking Change: If you're developing an unpackaged Win32 app using Fixed Version Runtime v120 or above and targeting Windows 10 devices, you need to run a couple of ACL shell commands (icacls
), to avoid crashing, because of a new security feature implemented in WebView2. See [Breaking Change] Unpackaged Win32 app using Fixed Version v120+ on Win10 need ACL. The fix is in the article Distribute your app and the WebView2 Runtime, section Details about the Fixed Version runtime distribution mode, step "On Windows 10 devices, starting with Fixed Version 120, developers of unpackaged Win32 applications using Fixed Version are required to run the following commands."
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Support for browser extensions in WebView2:
CoreWebView2EnvironmentOptions
Class:CoreWebView2Profile
Class:
- 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:
CoreWebView2Environment
Class:CoreWebView2ProcessExtendedInfo
Class:CoreWebView2
Class:CoreWebView2Frame
Class:CoreWebView2FrameInfo
Class:
ICoreWebView2AcceleratorKeyPressedEventArgs
has a newIsBrowserAcceleratorKeyEnabled
property to allow developers to control whether the browser handles accelerator keys (shortcut keys), such as Ctrl+P or F3:
CoreWebView2AcceleratorKeyPressedEventArgs
Class:
- Added support for managing profile deletion:
CoreWebView2Profile
Class:
Bug fixes
Added support for promise cancellation on host objects' async methods in WinRT JS projection. For information about
AddHostObjectToScript
, see Call native-side WinRT code from web-side code. (Runtime and SDK)Disabled automatic HTTPS upgrades for WebView2 API navigations. (Runtime-only) (Issue #4104)
1.0.2151.40
Release Date: November 6, 2023
NuGet package for WebView2 SDK 1.0.2151.40
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 119.0.2151.40 or higher.
General Availability
Important
Announcement: Xbox WebView2 SDK is now Generally Available (GA) and is available on Xbox October 2310 version (231018-2200). For more details, see WebView2 for Xbox announcement.
Promotions
The following APIs have been promoted to Stable and are now included in this Release SDK.
- Added source frame info to the
NewWindowRequested
event arguments, to identify the source of the request:
CoreWebView2NewWindowRequestedEventArgs
Class:
- For WinRT, options have been added to manage custom scheme registration when creating a
CoreWebView2Environment
:
CoreWebView2CustomSchemeRegistration
Class:CoreWebView2EnvironmentOptions
Class:
Bug fixes
- Fixed a reliability issue where multiple WebView creations could lead to a crash. (Runtime-only) (Issue #3793)
1.0.2194-prerelease
Release Date: November 6, 2023
NuGet package for WebView2 SDK 1.0.2194-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 120.0.2194.0 or higher.
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- Support for browser extensions in WebView2:
- CoreWebView2BrowserExtension Class
CoreWebView2EnvironmentOptions
Class:CoreWebView2Profile
Class:
Bug fixes
Fixed an issue where WebView2 would sometimes render blurry content or no content after changing monitor scale or switching between RDP and docking modes. (Runtime-only)
Fixed an issue in
TextServicesFoundation
causing a crash when a WebView2 instance was destroyed. (Runtime-only)Fixes a memory leak in .NET when web messages are sent from WebView2, but aren't read from the application side. (Runtime and SDK) (Issue #3794)
Fixed an issue causing the
ScaleFactor
setting to not work properly for all WebView2 Print APIs. (Runtime-only) (Issue #4082)
1.0.2088.41
Release Date: October 16, 2023
NuGet package for WebView2 SDK 1.0.2088.41
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 118.0.2088.41 or higher.
Promotions
No additional APIs have been promoted to Stable and added in this Release SDK.
Bug fixes
Fixed an issue causing some UWP apps to be unable to input text. (Runtime-only) (Issue #3805)
Fixed an initialization failure for apps that were using the Windows
PerProcessSystemDPIForceOff
compatibility setting. (Runtime-only) (Issue #3692)Fixed a Dialog Position Offset bug in WebView2. (Runtime-only) (Issue #3763)
1.0.2164-prerelease
Release Date: October 18, 2023
NuGet package for WebView2 SDK 1.0.2164-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 120.0.2164.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added the
FailureSourceModulePath
property to theProcessFailedEventArgs
type, to specify the full path of the module that caused the crash in cases of Windows code integrity failures - that is, when a process exited withSTATUS_INVALID_IMAGE_HASH
.
CoreWebView2ProcessFailedEventArgs
Class:
Bug fixes
Added support for additional page settings (
PageRange
andPagesPerSheet
) in the PrintToPDF API. (Runtime-only) (Issue #3719)Navigation to an Extension Resource file was not handled correctly, and has now been fixed with the correct handling method. (Runtime-only) (Issue #3728)
Fixed an issue causing some UWP apps to be unable to input text. (Runtime-only) (Issue #3805)
Fixed an initialization failure for apps that were using the Windows
PerProcessSystemDPIForceOff
compatibility setting. (Runtime-only) (Issue #3692)Removed monitors that were collecting data when the system default browser setting changes. (Runtime-only)
Fixed a Dialog Position Offset bug in WebView2. (Runtime-only) (Issue #3763)
Fixed a crash in the
NewWindowRequested
event if theNewWindow
is set tonull
. (Runtime-only)
1.0.2045.28
Release Date: September 18, 2023
NuGet package for WebView2 SDK 1.0.2045.28
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 117.0.2045.28 or higher.
Promotions
No additional APIs have been promoted to Stable and added in this Release SDK.
Bug fixes
Disabled the Mouse Gesture feature by default. (Runtime-only) (Issue #3737)
Fixed a bug where mouse wheel scrolling was intermittently broken for visual hosting. (Runtime-only)
Fixed a bug where downloading APK files in WebView2 crashes the WebView2 browser process. (Runtime-only) (Issue #3569)
1.0.2106-prerelease
Release Date: September 20, 2023
NuGet package for WebView2 SDK 1.0.2106-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 119.0.2106.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- The Frame Process Info API, including
GetProcessExtendedInfos
, provides a snapshot collection of all frames that are actively running in the associated renderer process. This API enables the host application to detect which part of WebView2 is consuming resources such as memory or CPU usage:
CoreWebView2Environment
Class:CoreWebView2FrameKind
Enum:
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
:
CoreWebView2CustomSchemeRegistration
Class:CoreWebView2EnvironmentOptions
Class:
- Added source frame info to the
NewWindowRequested
event arguments, to identify the source of the request:
CoreWebView2NewWindowRequestedEventArgs
Class:
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 theaccept-language
HTTP header. (SDK-only) (Issue #3635)Added support for longer runtime installation paths. (SDK-only)
The custom URI scheme registration API now works in WinRT. For API names and links, in the Promotions section above, see the "custom scheme registration" entry. (SDK-only)
Runtime and SDK
- Fixed a bug where the Runtime exits unexpectedly when calling
SetPermissionState
with an invalid enum value. (Runtime and SDK)
1.0.1938.49
Release Date: August 28, 2023
NuGet package for WebView2 SDK 1.0.1938.49
For full API compatibility, this Release version of the WebView2 SDK requires WebView2 Runtime version 116.0.1938.49 or higher.
Promotions
No additional APIs have been promoted to Stable and added in this Release SDK.
Bug fixes
Fixed a handle tracking bug where
TextureStream
API usage could fail. (Runtime-only)Fixed a bug where a WebView2 created in a background thread doesn't come to the foreground when created. (Runtime-only) (Issue #3584)
Fixed a bug where the WebView2 content sometimes renders at the incorrect size after changing the display configuration (such as laptop sleeping; remoting; or connecting or disconnecting an external display). (Runtime-only) (Issue 3429)
Fixed a bug where a bluescreen happens when using WebView2 apps on certain hardware configurations. (Runtime-only) (Issue #3679)
1.0.2065-prerelease
Release Date: August 30, 2023
NuGet package for WebView2 SDK 1.0.2065-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 118.0.2065.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added source frame info to
NewWindowRequested
, to support identifying the source:
CoreWebView2NewWindowRequestedEventArgs
Class
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.
CoreWebView2NavigationStartingEventArgs
Class:- CoreWebView2NavigationKind Enum
- The
ServiceWorkers
enum value in theBrowsingDataKinds
enum specifies service workers that are registered for an origin.
CoreWebView2BrowsingDataKinds
Enum:
Bug fixes
- Fixed a bug where the entire toolbar is blank when hiding the Bookmarks, Search, and PageSelector buttons simultaneously. (Runtime-only) Issue 2866
1.0.1988-prerelease
Release Date: July 24, 2023
NuGet package for WebView2 SDK 1.0.1988-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 117.0.1988.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Supports desktop notifications through WebView2:
- Supports monitoring iframe's runtime memory usage by getting process info details of iframes.
CoreWebView2
Class:CoreWebView2Environment
Class:CoreWebView2Frame
Class:CoreWebView2FrameInfo
Class:- CoreWebView2FrameKind Enum
Iframe
MainFrame
Other
CoreWebView2ProcessInfo
Class:
- Supports extensions in WebView2.
- CoreWebView2BrowserExtension Class
CoreWebView2EnvironmentOptions
Class:CoreWebView2Profile
Class:
- The
TextDirectionKind
enum specifies the text direction as left to right or right to left.
- CoreWebView2TextDirectionKind Enum
Default
LeftToRight
RightToLeft
Bug fixes
Fixed a
CoreWebView2Frame.ExecuteScriptAsync
hang that occurred when a frame was destroyed during script execution. Issue 3124Fixed a
COMException
when readingWebResourceResponse
content after a redirect. Issue 3229Fixed a regression where calling
CoreWebView2.AddHostObjectToScript
twice for the same name hangs. (Runtime-only) Issue 3539Fixed an issue where
PrintAsync
fails whenPrinterName
contains Chinese characters. Issue 3379Fixed an issue to disable the context menu in print pages when
AreDefaultContextMenusEnabled
is set tofalse
. Issue 3548Removed visual search from the web capture context menu. (Runtime-only) Issue 3426
Fixed an issue that caused
PrintAsync
andPrintToPdfStreamAsync
to fail when print settings arenull
.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 3465Fixed invalid
CoreWebView2PdfToolbarItems.FullScreen
andCoreWebView2PdfToolbarItems.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 3324Removed 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).
CoreWebView2
Class:- CoreWebView2LaunchingExternalUriSchemeEventArgs Class
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral Method
MemoryUsageTargetLevel
specifies memory consumption levels, such aslow
ornormal
.
CoreWebView2
Class:- CoreWebView2MemoryUsageTargetLevel Enum
- Enhanced support for multiple profiles, to allow configuring General Autofill and Password Autosave settings for different profiles.
CoreWebView2Profile
Class:
1.0.1905-prerelease
Release Date: June 12, 2023
NuGet package for WebView2 SDK 1.0.1905-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 116.0.1905.0 or higher.
Experimental APIs
No Experimental APIs have been added in this Prerelease SDK.
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
NavigationKind
gets the navigation kind of each navigation, such as Back/Forward, Reload, or navigation to a new document.
CoreWebView2NavigationStartingEventArgs
Class:- CoreWebView2NavigationKind Enum
- The
ServiceWorkers
enum value in theBrowsingDataKinds
enum specifies service workers that are registered for an origin.
CoreWebView2BrowsingDataKinds
Enum:
- 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).
CoreWebView2
Class:- CoreWebView2LaunchingExternalUriSchemeEventArgs Class
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral Method
MemoryUsageTargetLevel
specifies memory consumption levels, such aslow
ornormal
.
CoreWebView2
Class:- CoreWebView2MemoryUsageTargetLevel Enum
Bug fixes
Using
wv2winrt webhosthidden
entered an infinite loop when enumerating somewebhosthidden
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 anIAsyncAction
. (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 viaWebMessage
.
- CoreWebView2File Class
CoreWebView2WebMessageReceivedEventArgs
Class:
- The Profile Cookie Manager API supports profile management. The
CookieManager
property enables the host app to get the cookie manager for the profile.
CoreWebView2Profile
Class:
Bug fixes
- Fixed an issue to allow an app to inject initial scripts by calling
AddScriptToExecuteOnDocumentCreated
before a new window is created. (Issue #2491)
CoreWebView2
Class:
- 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.
CoreWebView2Profile
Class:
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)
CoreWebView2
Class:
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.
CoreWebView2Settings
- The
PermissionKind.WindowManagement
API indicates the kind of a permission request.
CoreWebView2PermissionKind
Enum
1.0.1777-prerelease
Release Date: April 10, 2023
NuGet package for WebView2 SDK 1.0.1777-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 114.0.1777.0 or higher.
Experimental APIs
No Experimental APIs have been added in this Prerelease SDK.
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
- The File API allows accessing a DOM
File
object passed viaWebMessage
.
CoreWebView2WebMessageReceivedEventArgs
- The Profile Cookie Manager API supports profile management. The
CookieManager
property enables the host app to get the cookie manager for the profile.
CoreWebView2Profile
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:
CoreWebView2
ClassCoreWebView2Environment
ClassCoreWebView2Frame
ClassCoreWebView2SharedBufferAccess Enum
ReadOnly
ReadWrite
- APIs for managing permissions:
CoreWebView2PermissionKind
EnumCoreWebView2PermissionRequestedEventArgs
EventCoreWebView2Profile
Class
APIs for managing tracking prevention:
CoreWebView2EnvironmentOptions
ClassCoreWebView2Profile
ClassCoreWebView2TrackingPreventionLevel Enum
None
Basic
Balanced
Strict
- APIs to manage the value of the controller's script locale:
CoreWebView2ControllerOptions
Class
1.0.1724-prerelease
Release Date: March 20, 2023
NuGet package for WebView2 SDK 1.0.1724-prerelease
For full API compatibility, this Prerelease version of the WebView2 SDK requires the WebView2 Runtime that ships with Microsoft Edge version 113.0.1724.0 or higher.
Experimental APIs
The following Experimental APIs have been added in this Prerelease SDK.
- Added
AdditionalObjects
for WebMessage received:
- Added Window Management permission type:
- Added support for launching external URIs:
CoreWebView2LaunchingExternalUriSchemeEventArgs Class
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral Method
- CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated Property
- CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri Property
- Added support for texture streaming:
The Environment
interface that returns the TextureStream
interface:
- CoreWebView2Environment.CreateTextureStream Method
- CoreWebView2Environment.RenderAdapterLUIDChanged Event
- CoreWebView2Environment.RenderAdapterLUID Property
The TextureStream
interface:
- CoreWebView2TextureStream Class
- CoreWebView2TextureStream.AddAllowedOrigin Method
- CoreWebView2TextureStream.CloseTexture Method
- CoreWebView2TextureStream.CreateTexture Method
- CoreWebView2TextureStream.ErrorReceived Event
- CoreWebView2TextureStream.GetAvailableTexture Method
- CoreWebView2TextureStream.Id Property
- CoreWebView2TextureStream.PresentTexture Method
- CoreWebView2TextureStream.RemoveAllowedOrigin Method
- CoreWebView2TextureStream.SetD3DDevice Method
- CoreWebView2TextureStream.StartRequested Event
- CoreWebView2TextureStream.Stop Method
- CoreWebView2TextureStream.Stopped Event
- CoreWebView2TextureStream.WebTextureReceived Event
- CoreWebView2TextureStream.WebTextureStreamStopped Event
ErrorReceivedEventArgs:
WebTextureReceivedEventArgs:
- CoreWebView2TextureStreamWebTextureReceivedEventArgs Class
- CoreWebView2TextureStreamWebTextureReceivedEventArgs.WebTexture Property
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:
- Added support for profile management: custom data partition, cookie manager and profile deletion:
Added support for custom data partition:
- CoreWebView2.CustomDataPartitionId Property
- CoreWebView2Profile.ClearCustomDataPartitionAsync Method
Added support for cookie manager:
Add support for managing 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
andPrintToPdfStreamAsync
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
The following Experimental APIs have been added in this Prerelease SDK.
- 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:
Previous name in 1619-prerelease:
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, theResultFilePath
previously wasn't showing the correct download location for UWP applications when theDownloadStarting
event handler was attached. This has been fixed; the correctResultFilePath
is now shown.Fixed a bug where
System.ArgumentException
was thrown when a call to theHostObject
method returns a non-generic task. (Issue #2787)Fixed an issue in the
SharedBuffer
API where the stream object didn't work well withStreamWriter
. (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 anull
reason
phrase. (Runtime-only)The
CoreWebView2.AddHostObjectToScript
optionchrome.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:
- CoreWebView2.PrintAsync Method
- CoreWebView2.PrintToPdfStreamAsync Method
- CoreWebView2.ShowPrintUI Method
- CoreWebView2PrintSettings Class
- CoreWebView2PrintSettings.Collation Property
- CoreWebView2PrintSettings.ColorMode Property
- CoreWebView2PrintSettings.Copies Property
- CoreWebView2PrintSettings.Duplex Property
- CoreWebView2PrintSettings.MediaSize Property
- CoreWebView2PrintSettings.PageRanges Property
- CoreWebView2PrintSettings.PagesPerSide Property
- CoreWebView2PrintSettings.PrinterName Property
- 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
The following Experimental APIs have been added in this Prerelease SDK.
- Added support for the Permission management API:
- CoreWebView2PermissionRequestedEventArgs Class
- CoreWebView2Profile Class
- CoreWebView2PermissionSetting Class
- CoreWebView2PermissionSetting.PermissionKind Property
- CoreWebView2PermissionKind Enum
MultipleAutomaticDownloads
FileReadWrite
Autoplay
LocalFonts
MidiSystemExclusiveMessageAccess
- CoreWebView2PermissionSetting.PermissionOrigin Property
- CoreWebView2PermissionSetting.PermissionState Property
- 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
The following Experimental APIs have been added in this Prerelease SDK.
- 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:
- CoreWebView2.PrintAsync Method
- CoreWebView2.PrintToPdfStreamAsync Method
- CoreWebView2.ShowPrintUI Method
- CoreWebView2PrintSettings Class
- CoreWebView2PrintSettings.Collation Property
- CoreWebView2PrintSettings.ColorMode Property
- CoreWebView2PrintSettings.Copies Property
- CoreWebView2PrintSettings.Duplex Property
- CoreWebView2PrintSettings.MediaSize Property
- CoreWebView2PrintSettings.PageRanges Property
- CoreWebView2PrintSettings.PagesPerSide Property
- CoreWebView2PrintSettings.PrinterName Property
- 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
The following Experimental APIs have been added in this Prerelease SDK.
- Added support for creating a shared memory based buffer with a specified size:
- CoreWebView2SharedBuffer Class
Buffer
FileMappingHandle
Size
Close
Dispose
OpenStream
- 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:
- CoreWebView2ScriptException Class
ColumnNumber
LineNumber
Message
Name
ToJson
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
inadd_ClientCertificateRequested
event as aBase64
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
The following Experimental APIs have been added in this Prerelease SDK.
- Added support for the Print API:
- CoreWebView2.PrintAsync Method
- CoreWebView2.PrintToPdfStreamAsync Method
- CoreWebView2.ShowPrintUI Method
- CoreWebView2PrintSettings Class
- CoreWebView2PrintSettings.Collation Property
- CoreWebView2PrintSettings.ColorMode Property
- CoreWebView2PrintSettings.Copies Property
- CoreWebView2PrintSettings.Duplex Property
- CoreWebView2PrintSettings.MediaSize Property
- CoreWebView2PrintSettings.PageRanges Property
- CoreWebView2PrintSettings.PagesPerSide Property
- CoreWebView2PrintSettings.PrinterName Property
- 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
The following Experimental APIs have been added in this Prerelease SDK.
- Added support for
WebResourceRequested
for workers which allows setting filters in order to receiveWebResourceRequested
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
andIMapView
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
ContextMenuRequested
API 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 callsetHostProperty
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
, orsystem
.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
toICoreWebView2ClientCertificate
.
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
The following Experimental APIs have been added in this Prerelease SDK.
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
, orsystem
.Default Download API which provides a way to customize the default download location.
Bug fixes
Fixed
ZoomFactor
issue that incorrectly setsZoomFactor
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
andMouseEvent.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
The following Experimental APIs have been added in this Prerelease SDK.
- 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
The following Experimental APIs have been added in this Prerelease SDK.
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
The following Experimental APIs have been added in this Prerelease SDK.
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 theWebResourceResponseReceived
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/loadWebView2Loader.dll
. (Issue #1236)Fixed size and position of the new window created with
window.open
whenNewWindowRequested
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
The following Experimental APIs have been added in this Prerelease SDK.
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 following Experimental APIs have been added in this Prerelease SDK.
- 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
General reliability improvements.
The real process exit code is now provided as
ExitCode
inICoreWebView2ProcessFailedEventArgs2
forCOREWEBVIEW2_PROCESS_FAILED_KIND_BROWSER_PROCESS_EXITED
process failure.The
--js-flags
switch is now honored in theAdditionalBrowserArguments
that are provided inCoreWebView2EnvironmentOptions
.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.
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
The following Experimental APIs have been added in this Prerelease SDK.
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
The following Experimental APIs have been added in this Prerelease SDK.
Removed silent failures by using
EnsureCoreWebView2Async
, which throws anArgumentException
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 asIUnknown
.
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.
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.
Bug fixes
Fixed bug that broke the
edge://downloads
andedge://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 usetarget=_blank
.Fixed a bug in WebView2 visual hosting that flickered before startup.
Fixed bug when
add_WebResourceRequested
didn't work on WebView2 controls created usingadd_NewWindowRequested
. (Issue #616)Allow the host app to set foreground on a different application in response to events including
NavigationStarting
,AddHostObjectToScript
methods,WebMessageReceived
, andNewWindowRequested
. (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 file names from being used in
ResultFilePath
inDownloadStartingEventArgs
. (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
The following Experimental APIs have been added in this Prerelease SDK.
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
, andBack
can't be disabled byAreBrowserAcceleratorKeysEnabled
. 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.
.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
The following Experimental APIs have been added in this Prerelease SDK.
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 withPOST
binary data in WebView2.Turned off the
OpenSaveAsAwareness
download UI, because it included links toedge://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
The following Experimental APIs for .NET have been added in this Prerelease SDK.
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 forAddScriptToExecuteOnDocumentCreated
. - 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 forAddScriptToExecuteOnDocumentCreated
.
Promotions
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
Rasterization Scale APIs:
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
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.
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 theCopyCookie
method. - Added visual hosting support using the ICoreWebView2CompositionController interface, which is created using the new
CreateCoreWebView2CompositionController
method fromICoreWebView2Environment3
.
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
isfalse
. (Issue #605).Fixed a bug that returned
E_NOINTERFACE
when queryingICoreWebView2
forICoreWebView2Experimental
. (Issue #691).Fixed a bug that allowed navigation with malformed URIs when
CoreWebView2NavigationStartingEventArgs.Cancel
is set tofalse
. (Issue #400).Fixed a bug that blocked
window.print()
on pop-up windows with event handlers attached toNewWindowRequested
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
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.
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 theRasterizationScale
with theBounds
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
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.
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.
Important
Announcement: Win32 C/C++ WebView2 is now Generally Available (GA). Starting this release, Release SDKs are forward-compatible. See GA announcement blog post.
- 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 useSystem.Drawing.Rectangle
instead ofSystem.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.
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 forabout:blank
orsrcdoc
of theiframe
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
Release Date: June 8, 2020
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.
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, as 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
Release Date: May 14, 2020
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
Release Date: April 20, 2020
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 Prerelease and Release SDKs for 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.remoteObjects
is nowchrome.webview.hostObjects
.
-
Important
Breaking Change: The
AddRemoteObject
JS proxy methods are also renamed.getLocal
is nowgetLocalProperty
.setLocal
is nowsetLocalProperty
.getRemote
is nowgetHostProperty
.setRemote
is nowsetHostProperty
.applyRemote
is 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.
- 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 theCompositionController
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
toICoreWebView2
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 separatedICoreWebView2
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 theHistoryChanged
event is run. TheContentLoading
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. WhenAreRemoteObjectsAllowed
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
Release Date: December 9, 2019
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
Release Date: October 28, 2019
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
Release Date: September 10, 2019
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 removereleaseChannelPreference
. For more information about theCreateWebView2EnvironmentWithDetails
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 to1
before launching the app. See Test upcoming APIs and features.Updated the
CreateWebView2EnvironmentWithDetails
function with logic for selectinguserDataFolder
when not specified. For more information about theCreateWebView2EnvironmentWithDetails
function, see CreateWebView2EnvironmentWithDetails. If you previously used the defaultuserDataFolder
location, when you switch to the new SDK the defaultuserDataFolder
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, theCreateWebView2EnvironmentWithDetails
function might fail. You can copy the data from the olduser data folder
to the new directory.
0.8.230
Release Date: July 29, 2019
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
Release Date: June 17, 2019
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
Release Date: May 6, 2019
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
- About Release Notes for the WebView2 SDK
- Release Notes for the WebView2 SDK
- 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