Prerelease SDK 1.0.2646-prerelease, for Runtime 128 (Jun. 19, 2024)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Jun. 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 later; see Runtime 128.0.2739.15 (Aug. 26, 2024).

Detailed contents:

• General features
• Experimental features
• Experimental APIs (Phase 1: Experimental in Prerelease)
  • Configure the security warning when saving a file (SaveFileSecurityCheckStarting event)
  • Control whether the screen capture UI is shown (ScreenCaptureStarting event)
  • GetComICoreWebView2 method
• Promotions to Phase 2 (Stable in Prerelease)
  • WebMessageObjects API: Inject DOM objects; file system handle
• See also

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 in WebResourceResponseReceived.

Experimental APIs (Phase 1: Experimental in Prerelease)

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

Configure the security warning when saving a file (SaveFileSecurityCheckStarting event)

Added a new SaveFileSecurityCheckStarting event. Your app can register a handler on this event to get the file path, filename extension, and document origin URI information. You can then 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.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.SaveFileSecurityCheckStarting Event

• CoreWebView2SaveFileSecurityCheckStartingEventArgs Class

  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.SaveFileSecurityCheckStarting Event

• CoreWebView2SaveFileSecurityCheckStartingEventArgs Class

  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method

Win32/C++

• ICoreWebView2Experimental27

  • ICoreWebView2Experimental27::add_SaveFileSecurityCheckStarting
  • ICoreWebView2Experimental27::remove_SaveFileSecurityCheckStarting

• ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs

  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::get_CancelSave
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::get_DocumentOriginUri
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::get_FileExtension
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::get_FilePath
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::get_SuppressDefaultPolicy
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::GetDeferral
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::put_CancelSave
  • ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventArgs::put_SuppressDefaultPolicy

• ICoreWebView2ExperimentalSaveFileSecurityCheckStartingEventHandler

Control whether the screen capture UI is shown (ScreenCaptureStarting event)

Added a new ScreenCaptureStarting event. This event is raised whenever the WebView2 and/or iframe that corresponds to the CoreWebView2Frame (or to any of its descendant iframes) requests permission to use the Screen Capture API before the UI is shown. The app can then block the UI from being displayed, or allow the UI to be displayed.

.NET/C#

• CoreWebView2 Class:

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame Class:

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2ScreenCaptureStartingEventArgs Class:

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel Property
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled Property
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo Property
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral Method

WinRT/C#

• CoreWebView2 Class:

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame Class:

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2ScreenCaptureStartingEventArgs Class:

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel Property
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled Property
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo Property
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral Method

Win32/C++

• ICoreWebView2Experimental26

  • ICoreWebView2Experimental26::add_ScreenCaptureStarting
  • ICoreWebView2Experimental26::remove_ScreenCaptureStarting

• ICoreWebView2ExperimentalFrame6

  • ICoreWebView2ExperimentalFrame6::add_ScreenCaptureStarting
  • ICoreWebView2ExperimentalFrame6::remove_ScreenCaptureStarting

• ICoreWebView2ExperimentalFrameScreenCaptureStartingEventHandler

• ICoreWebView2ExperimentalScreenCaptureStartingEventArgs

  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::get_Cancel
  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::get_Handled
  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::get_OriginalSourceFrameInfo
  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::GetDeferral
  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::put_Cancel
  • ICoreWebView2ExperimentalScreenCaptureStartingEventArgs::put_Handled

• ICoreWebView2ExperimentalScreenCaptureStartingEventHandler

GetComICoreWebView2 method

Added a new GetComICoreWebView2 method to the CoreWebView2 .NET class that enables you to convert a CoreWebView2 between .NET and COM.

Added a new WinRT interface that enables you to convert a CoreWebView2 between WinRT and COM. This allows you to interoperate between libraries that are written in different languages.

.NET/C#

• CoreWebView2 Class:
  • CoreWebView2.GetComICoreWebView2 Method

WinRT/C#

• ICoreWebView2Interop2 Interface:
  • ICoreWebView2Interop2::GetComICoreWebView2 Method

Win32/C++

Not applicable.

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.

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.

Previous phase: WebMessageObjects API: Inject DOM objects; file system handle in Prerelease SDK 1.0.2470-prerelease, for Runtime 124 (Mar. 25, 2024).

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

• ICoreWebView2_23

  • ICoreWebView2_23::PostWebMessageAsJsonWithAdditionalObjects

• ICoreWebView2Environment14

  • ICoreWebView2Environment14::CreateObjectCollection
  • ICoreWebView2Environment14::CreateWebFileSystemDirectoryHandle
  • ICoreWebView2Environment14::CreateWebFileSystemFileHandle

• ICoreWebView2FileSystemHandle

  • ICoreWebView2FileSystemHandle::get_Kind
  • ICoreWebView2FileSystemHandle::get_Path
  • ICoreWebView2FileSystemHandle::get_Permission

• ICoreWebView2ObjectCollection

  • ICoreWebView2ObjectCollection::InsertValueAtIndex
  • ICoreWebView2ObjectCollection::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

See also

• Release SDK 1.0.2739.15, for Runtime 128 (Aug. 26, 2024)
• Prerelease SDK 1.0.2730-prerelease, for Runtime 128 (Aug. 7, 2024)
• Runtime 128.0.2739.15 (Aug. 26, 2024)
• Release notes for WebView2
  • Release notes for the WebView2 Runtime
  • Release notes for WebView2 SDKs