Prerelease SDK 1.0.2106-prerelease, for Runtime 119 (Sep. 20, 2023)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Sep. 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 later; see Runtime 119.0.2151.40 (Nov. 6, 2023).

Detailed contents:

• Experimental APIs (Phase 1: Experimental in Prerelease)
  • Frame Process Info API
• Promotions to Phase 2 (Stable in Prerelease)
  • Manage custom scheme registration when creating a CoreWebView2Environment
  • Added source frame info to the NewWindowRequested event
• Bug fixes
• See also

Experimental APIs (Phase 1: Experimental in Prerelease)

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

Frame Process Info API

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:

.NET/C#

• CoreWebView2Environment Class:

  • CoreWebView2Environment.GetProcessExtendedInfosAsync Method

• CoreWebView2FrameKind Enum:

  • CoreWebView2FrameKind.Embed Enum Value
  • CoreWebView2FrameKind.Object Enum Value
  • CoreWebView2FrameKind.Unknown Enum Value

• CoreWebView2ProcessExtendedInfo Class

  • CoreWebView2ProcessExtendedInfo.AssociatedFrameInfos Property
  • CoreWebView2ProcessExtendedInfo.ProcessInfo Property

WinRT/C#

• CoreWebView2Environment Class:

  • CoreWebView2Environment.GetProcessExtendedInfosAsync Method

• CoreWebView2FrameKind Enum:

  • CoreWebView2FrameKind.Unknown Enum Value
  • CoreWebView2FrameKind.Embed Enum Value
  • CoreWebView2FrameKind.Object Enum Value

• CoreWebView2ProcessExtendedInfo Class

  • CoreWebView2ProcessExtendedInfo.AssociatedFrameInfos Property
  • CoreWebView2ProcessExtendedInfo.ProcessInfo Property

Win32/C++

• ICoreWebView2ExperimentalEnvironment13

  • ICoreWebView2ExperimentalEnvironment13::GetProcessExtendedInfos

• ICoreWebView2ExperimentalGetProcessExtendedInfosCompletedHandler

• ICoreWebView2ExperimentalProcessExtendedInfo

  • ICoreWebView2ExperimentalProcessExtendedInfo::get_AssociatedFrameInfos
  • ICoreWebView2ExperimentalProcessExtendedInfo::get_ProcessInfo

• ICoreWebView2ExperimentalProcessExtendedInfoCollection

  • ICoreWebView2ExperimentalProcessExtendedInfoCollection::get_Count
  • ICoreWebView2ExperimentalProcessExtendedInfoCollection::GetValueAtIndex

• COREWEBVIEW2_FRAME_KIND enum:

  • COREWEBVIEW2_FRAME_KIND_UNKNOWN
  • COREWEBVIEW2_FRAME_KIND_EMBED
  • COREWEBVIEW2_FRAME_KIND_OBJECT

Promotions to Phase 2 (Stable in Prerelease)

The following APIs have been promoted from Phase 1: Experimental in Prerelease, to Phase 2: Stable in Prerelease, and are included in this Prerelease SDK.

Manage custom scheme registration when creating a CoreWebView2Environment

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

Previous phase: Additional options to create an environment to manage custom scheme registration in Release SDK 1.0.1587.40, for Runtime 110 (Feb. 15, 2023).

.NET/C#

• CoreWebView2CustomSchemeRegistration Class:

  • CoreWebView2CustomSchemeRegistration.AllowedOrigins Property
  • CoreWebView2CustomSchemeRegistration.SchemeName Property

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations Property

WinRT/C#

• CoreWebView2CustomSchemeRegistration Class:

  • CoreWebView2CustomSchemeRegistration.AllowedOrigins Property
  • CoreWebView2CustomSchemeRegistration.SchemeName Property

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations Property

Win32/C++

• ICoreWebView2CustomSchemeRegistration:

  • ICoreWebView2CustomSchemeRegistration::get_SchemeName
  • ICoreWebView2CustomSchemeRegistration::GetAllowedOrigins
  • ICoreWebView2CustomSchemeRegistration::SetAllowedOrigins

• ICoreWebView2EnvironmentOptions4

  • ICoreWebView2EnvironmentOptions4::GetCustomSchemeRegistrations
  • ICoreWebView2EnvironmentOptions4::SetCustomSchemeRegistrations

Added source frame info to the NewWindowRequested event

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

Previous phase: Added source frame info to the NewWindowRequested event in Prerelease SDK 1.0.2065-prerelease, for Runtime 118 (Aug. 30, 2023).

.NET/C#

• CoreWebView2NewWindowRequestedEventArgs Class:
  • CoreWebView2NewWindowRequestedEventArgs.OriginalSourceFrameInfo Property

WinRT/C#

• CoreWebView2NewWindowRequestedEventArgs Class:
  • CoreWebView2NewWindowRequestedEventArgs.OriginalSourceFrameInfo Property

Win32/C++

• ICoreWebView2NewWindowRequestedEventArgs3
  • ICoreWebView2NewWindowRequestedEventArgs3::get_OriginalSourceFrameInfo

Bug fixes

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

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

• Added support for longer runtime installation paths.

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

See also

• Runtime 119.0.2151.40 (Nov. 6, 2023)
• Release notes for WebView2
  • Release notes for the WebView2 Runtime
  • Release notes for WebView2 SDKs