Prerelease SDK 1.0.2470-prerelease, for Runtime 124 (Mar. 25, 2024)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Mar. 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 later; see Runtime 124.0.2478.35 (Apr. 22, 2024).

Detailed contents:

• Experimental APIs (Phase 1: Experimental in Prerelease)
  • Fluent Style Overlay Scrollbar
  • WebMessageObjects API: Inject DOM objects; file system handle
• Promotions to Phase 2 (Stable in Prerelease)
  • Runtime selection
  • FailureSourceModulePath property
• See also

Experimental APIs (Phase 1: Experimental in Prerelease)

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

Fluent Style Overlay Scrollbar

Support for the Fluent Style Overlay Scrollbar.

.NET/C#

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.ScrollBarStyle Property

• CoreWebView2ScrollbarStyle Enum

  • Default
  • FluentOverlay

WinRT/C#

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.ScrollBarStyle Property

• CoreWebView2ScrollbarStyle Enum

  • Default
  • FluentOverlay

Win32/C++

• ICoreWebView2ExperimentalEnvironmentOptions2

  • ICoreWebView2ExperimentalEnvironmentOptions2::get_ScrollBarStyle
  • ICoreWebView2ExperimentalEnvironmentOptions2::put_ScrollBarStyle

• COREWEBVIEW2_SCROLLBAR_STYLE enum

  • COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT
  • COREWEBVIEW2_SCROLLBAR_STYLE_FLUENT_OVERLAY

WebMessageObjects API: Inject DOM objects; file system handle

Updated the WebMessageObjects API to allow injecting DOM objects into WebView2 content that's constructed via the app and via the CoreWebView2.PostWebMessage API in the other direction.

Added a new web object type (CoreWebView2FileSystemHandle) to represent a file system handle that can be posted to the web content to provide it with file system access.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.PostWebMessageAsJsonWithAdditionalObjects Method

• CoreWebView2Environment Class:

  • CoreWebView2Environment.CreateWebFileSystemDirectoryHandle Method
  • CoreWebView2Environment.CreateWebFileSystemFileHandle Method

• CoreWebView2FileSystemHandle Class:

  • CoreWebView2FileSystemHandle.Kind Property
  • CoreWebView2FileSystemHandle.Path Property
  • CoreWebView2FileSystemHandle.Permission Property

• CoreWebView2FileSystemHandleKind Enum

  • File
  • Directory

• CoreWebView2FileSystemHandlePermission Enum

  • ReadOnly
  • ReadWrite

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.PostWebMessageAsJsonWithAdditionalObjects Method

• CoreWebView2Environment Class:

  • CoreWebView2Environment.CreateWebFileSystemDirectoryHandle Method
  • CoreWebView2Environment.CreateWebFileSystemFileHandle Method

• CoreWebView2FileSystemHandle Class:

  • CoreWebView2FileSystemHandle.Kind Property
  • CoreWebView2FileSystemHandle.Path Property
  • CoreWebView2FileSystemHandle.Permission Property

• CoreWebView2FileSystemHandleKind Enum

  • File
  • Directory

• CoreWebView2FileSystemHandlePermission Enum

  • ReadOnly
  • ReadWrite

Win32/C++

• ICoreWebView2Experimental24

  • ICoreWebView2Experimental24::PostWebMessageAsJsonWithAdditionalObjects

• ICoreWebView2ExperimentalEnvironment14

  • ICoreWebView2ExperimentalEnvironment14::CreateObjectCollection
  • ICoreWebView2ExperimentalEnvironment14::CreateWebFileSystemDirectoryHandle
  • ICoreWebView2ExperimentalEnvironment14::CreateWebFileSystemFileHandle

• ICoreWebView2ExperimentalFileSystemHandle

  • ICoreWebView2ExperimentalFileSystemHandle::get_Kind
  • ICoreWebView2ExperimentalFileSystemHandle::get_Path
  • ICoreWebView2ExperimentalFileSystemHandle::get_Permission

• ICoreWebView2ExperimentalObjectCollection

  • ICoreWebView2ExperimentalObjectCollection::InsertValueAtIndex
  • ICoreWebView2ExperimentalObjectCollection::RemoveValueAtIndex

• COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND enum

  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND_FILE
  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND_DIRECTORY

• COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION enum

  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION_READ_ONLY
  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION_READ_WRITE

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.

Runtime selection

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, and ChannelSearchKind to select a search order.

Previous phase: Runtime selection in Prerelease SDK 1.0.2357-prerelease, for Runtime 122 (Jan. 30, 2024).

.NET/C#

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.ChannelSearchKind Property
  • CoreWebView2EnvironmentOptions.ReleaseChannels Property

• CoreWebView2ChannelSearchKind Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels Enum

  • None
  • Stable
  • Beta
  • Dev
  • Canary

WinRT/C#

• CoreWebView2EnvironmentOptions Class:

  • CoreWebView2EnvironmentOptions.ChannelSearchKind Property
  • CoreWebView2EnvironmentOptions.ReleaseChannels Property

• CoreWebView2ChannelSearchKind Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels Enum

  • None
  • Stable
  • Beta
  • Dev
  • Canary

Win32/C++

• ICoreWebView2EnvironmentOptions7

  • ICoreWebView2EnvironmentOptions7::get_ChannelSearchKind
  • ICoreWebView2EnvironmentOptions7::put_ChannelSearchKind
  • ICoreWebView2EnvironmentOptions7::get_ReleaseChannels
  • ICoreWebView2EnvironmentOptions7::put_ReleaseChannels

• COREWEBVIEW2_CHANNEL_SEARCH_KIND enum

  • COREWEBVIEW2_CHANNEL_SEARCH_KIND_MOST_STABLE
  • COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE

• COREWEBVIEW2_RELEASE_CHANNELS enum

  • COREWEBVIEW2_RELEASE_CHANNELS_NONE
  • COREWEBVIEW2_RELEASE_CHANNELS_STABLE
  • COREWEBVIEW2_RELEASE_CHANNELS_BETA
  • COREWEBVIEW2_RELEASE_CHANNELS_DEV
  • COREWEBVIEW2_RELEASE_CHANNELS_CANARY

FailureSourceModulePath property

Added the FailureSourceModulePath property to the ProcessFailedEventArgs 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 with STATUS_INVALID_IMAGE_HASH.

Previous phase: FailureSourceModulePath property in Prerelease SDK 1.0.2164-prerelease, for Runtime 120 (Oct. 18, 2023).

.NET/C#

• CoreWebView2ProcessFailedEventArgs Class:
  • CoreWebView2ProcessFailedEventArgs.FailureSourceModulePath Property

WinRT/C#

• CoreWebView2ProcessFailedEventArgs Class:
  • CoreWebView2ProcessFailedEventArgs.FailureSourceModulePath Property

Win32/C++

• ICoreWebView2ProcessFailedEventArgs3
  • ICoreWebView2ProcessFailedEventArgs3::get_FailureSourceModulePath

See also

• Runtime 124.0.2478.35 (Apr. 22, 2024)
• Release notes for WebView2
  • Release notes for the WebView2 Runtime
  • Release notes for WebView2 SDKs