Prerelease SDK 1.0.1671-prerelease, for Runtime 112 (Feb. 15, 2023)

Release notes for Microsoft Edge WebView2 Prerelease SDK, release date: Feb. 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 later; see Runtime 112.0.1722.45 (Apr. 13, 2023).

Detailed contents:

• Experimental APIs (Phase 1: Experimental in Prerelease)
  • Experimental File API
• Promotions to Phase 2 (Stable in Prerelease)
  • SharedBuffer API
  • Permission API
  • ScriptLocale API
• Bug fixes
• See also

Experimental APIs (Phase 1: Experimental in Prerelease)

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

Experimental File API

Added support for the Experimental File API.

.NET/C#

• CoreWebView2File Class
  • CoreWebView2File.Path Property
• CoreWebView2WebMessageReceivedEventArgs Class

WinRT/C#

• CoreWebView2File Class
  • CoreWebView2File.Path Property
• CoreWebView2WebMessageReceivedEventArgs Class

Win32/C++

• ICoreWebView2ExperimentalFile
  • ICoreWebView2ExperimentalFile::get_Path
• ICoreWebView2ExperimentalWebMessageReceivedEventArgs

Also added support for Experimental Object Collection View API:

• ICoreWebView2ExperimentalObjectCollectionView
  • ICoreWebView2ExperimentalObjectCollectionView::get_Count
  • ICoreWebView2ExperimentalObjectCollectionView::GetValueAtIndex

The above interface is currently being used for:

• ICoreWebView2ExperimentalWebMessageReceivedEventArgs::get_AdditionalObjects

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.

SharedBuffer API

The SharedBuffer API.

Previous phase: Access shared buffer from script of main frame or iframe in Prerelease SDK 1.0.1466-prerelease, for Runtime 109 (Oct. 31, 2022).

.NET/C#

• CoreWebView2 Class
  • CoreWebView2.PostSharedBufferToScript Method
• CoreWebView2Environment Class
  • ICoreWebView2Environment.CreateSharedBuffer Method
• CoreWebView2Frame Class
  • CoreWebView2Frame.PostSharedBufferToScript Method
• CoreWebView2SharedBuffer Class
  • CoreWebView2SharedBuffer.Buffer Property
  • CoreWebView2SharedBuffer.FileMappingHandle Property
  • CoreWebView2SharedBuffer.Size Property
  • CoreWebView2SharedBuffer.Close Method
  • CoreWebView2SharedBuffer.OpenStream Method

WinRT/C#

• CoreWebView2 Class
  • CoreWebView2.PostSharedBufferToScript Method
• CoreWebView2Environment Class
  • ICoreWebView2Environment.CreateSharedBuffer Method
• CoreWebView2Frame Class
  • CoreWebView2Frame.PostSharedBufferToScript Method
• CoreWebView2SharedBuffer Class
  • CoreWebView2SharedBuffer.Buffer Property
  • CoreWebView2SharedBuffer.Size Property
  • CoreWebView2SharedBuffer.Close Method
  • CoreWebView2SharedBuffer.OpenStream Method

Win32/C++

• ICoreWebView2_17
  • ICoreWebView2_17::PostSharedBufferToScript
• ICoreWebView2Environment12
  • ICoreWebView2Environment12::CreateSharedBuffer
• ICoreWebView2Frame4
  • ICoreWebView2Frame4::PostSharedBufferToScript
• ICoreWebView2SharedBuffer
  • ICoreWebView2SharedBuffer::OpenStream
  • ICoreWebView2SharedBuffer::Close
  • ICoreWebView2SharedBuffer::get_Size
  • ICoreWebView2SharedBuffer::get_Buffer
  • ICoreWebView2SharedBuffer::get_FileMappingHandle

Permission API

The Permission API.

.NET/C#

• CoreWebView2PermissionSetting Class
  • CoreWebView2PermissionSetting.PermissionKind Property
  • CoreWebView2PermissionSetting.PermissionOrigin Property
  • CoreWebView2PermissionSetting.PermissionState Property
• CoreWebView2Profile Class
  • CoreWebView2Profile.GetNonDefaultPermissionSettingsAsync Method
  • CoreWebView2Profile.SetPermissionStateAsync Method

WinRT/C#

• CoreWebView2PermissionSetting Class
  • CoreWebView2PermissionSetting.PermissionKind Property
  • CoreWebView2PermissionSetting.PermissionOrigin Property
  • CoreWebView2PermissionSetting.PermissionState Property
• CoreWebView2Profile Class
  • CoreWebView2Profile.GetNonDefaultPermissionSettingsAsync Method
  • CoreWebView2Profile.SetPermissionStateAsync Method

Win32/C++

• ICoreWebView2GetNonDefaultPermissionSettingsCompletedHandler
• ICoreWebView2PermissionSetting
  • ICoreWebView2PermissionSetting::get_PermissionKind
  • ICoreWebView2PermissionSetting::get_PermissionOrigin
  • ICoreWebView2PermissionSetting::get_PermissionState
• ICoreWebView2PermissionSettingCollectionView
  • ICoreWebView2PermissionSettingCollectionView::GetValueAtIndex
  • ICoreWebView2PermissionSettingCollectionView::get_Count
• ICoreWebView2Profile4
  • ICoreWebView2Profile4::SetPermissionState
  • ICoreWebView2Profile4::GetNonDefaultPermissionSettings
• ICoreWebView2SetPermissionStateCompletedHandler

ScriptLocale API

The ScriptLocale API.

.NET/C#

• CoreWebView2ControllerOptions Class
  • CoreWebView2ControllerOptions.ScriptLocale Property

Previous name in 1619-prerelease:

• CoreWebView2ControllerOptions.LocaleRegion Property

WinRT/C#

• CoreWebView2ControllerOptions Class
  • CoreWebView2ControllerOptions.ScriptLocale Property

Previous name in 1619-prerelease:

• CoreWebView2ControllerOptions.LocaleRegion Property

Win32/C++

• ICoreWebView2ControllerOptions2
  • ICoreWebView2ControllerOptions2::get_ScriptLocale
  • ICoreWebView2ControllerOptions2::put_ScriptLocale

Previous name in 1619-prerelease:

• ICoreWebView2ExperimentalControllerOptions::get_LocaleRegion
• ICoreWebView2ExperimentalControllerOptions::put_LocaleRegion

Bug fixes

• In the DownloadStarting event, the ResultFilePath previously wasn't showing the correct download location for UWP applications when the DownloadStarting event handler was attached. This has been fixed; the correct ResultFilePath is now shown.

• Fixed a bug where System.ArgumentException was thrown when a call to the HostObject method returns a non-generic task. (Issue #2787)

• Fully enabled Open file dialog support for elevated apps on Windows 7.

• Fixed a bug where owned windows were not appearing for UWP.

See also

• Runtime 112.0.1722.45 (Apr. 13, 2023)
• Release notes for WebView2
  • Release notes for the WebView2 Runtime
  • Release notes for WebView2 SDKs