Prerelease SDK 1.0.1988-prerelease, for Runtime 117 (Jul. 24, 2023)

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

Detailed contents:

• Experimental APIs (Phase 1: Experimental in Prerelease)
  • Desktop notifications through WebView2
  • Monitoring iframe's runtime memory usage
  • Support for browser extensions in WebView2
  • Specifying the text direction
• Bug fixes
• See also

Experimental APIs (Phase 1: Experimental in Prerelease)

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

Desktop notifications through WebView2

Supports desktop notifications through WebView2:

.NET/C#

• CoreWebView2 Class:
  • CoreWebView2.NotificationReceived Event
• CoreWebView2Notification Class
• CoreWebView2NotificationReceivedEventArgs Class

WinRT/C#

• CoreWebView2 Class:
  • CoreWebView2.NotificationReceived Event
• CoreWebView2Notification Class
• CoreWebView2NotificationReceivedEventArgs Class

Win32/C++

• ICoreWebView2Experimental22
  • ICoreWebView2Experimental22::add_NotificationReceived event
  • ICoreWebView2Experimental22::remove_NotificationReceived event
• ICoreWebView2ExperimentalNotification
• ICoreWebView2ExperimentalNotificationCloseRequestedEventHandler
• ICoreWebView2ExperimentalNotificationReceivedEventArgs
• ICoreWebView2ExperimentalNotificationReceivedEventHandler

Monitoring iframe's runtime memory usage

Supports monitoring iframe's runtime memory usage by getting process info details of iframes.

.NET/C#

• CoreWebView2 Class:
  • CoreWebView2.FrameId Property
• CoreWebView2Environment Class:
  • CoreWebView2Environment.GetProcessInfosWithDetailsAsync Method
• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameId Property
• CoreWebView2FrameInfo Class:
  • CoreWebView2FrameInfo.FrameId Property
  • CoreWebView2FrameInfo.FrameKind Property
  • CoreWebView2FrameInfo.ParentFrameInfo Property
• CoreWebView2FrameKind Enum
  • Iframe
  • MainFrame
  • Other
• CoreWebView2ProcessInfo Class:
  • CoreWebView2ProcessInfo.AssociatedFrameInfos Property

WinRT/C#

• CoreWebView2 Class:
  • CoreWebView2.FrameId Property
• CoreWebView2Environment Class:
  • CoreWebView2Environment.GetProcessInfosWithDetailsAsync Method
• CoreWebView2Frame Class:
  • CoreWebView2Frame.FrameId Property
• CoreWebView2FrameInfo Class:
  • CoreWebView2FrameInfo.FrameId Property
  • CoreWebView2FrameInfo.FrameKind Property
  • CoreWebView2FrameInfo.ParentFrameInfo Property
• CoreWebView2FrameKind Enum
  • Other
  • MainFrame
  • Iframe
• CoreWebView2ProcessInfo Class:
  • CoreWebView2ProcessInfo.AssociatedFrameInfos Property

Win32/C++

• ICoreWebView2Experimental23

  • ICoreWebView2Experimental23::get_FrameId

• ICoreWebView2ExperimentalEnvironment11

  • ICoreWebView2ExperimentalEnvironment11::GetProcessInfosWithDetails

• ICoreWebView2ExperimentalFrame5

  • ICoreWebView2ExperimentalFrame5::get_FrameId

• ICoreWebView2ExperimentalFrameInfo

  • ICoreWebView2FrameInfo::get_FrameId
  • ICoreWebView2FrameInfo::get_FrameKind
  • ICoreWebView2FrameInfo::get_ParentFrameInfo

• COREWEBVIEW2_FRAME_KIND enum

  • COREWEBVIEW2_FRAME_KIND_OTHER
  • COREWEBVIEW2_FRAME_KIND_MAIN_FRAME
  • COREWEBVIEW2_FRAME_KIND_IFRAME

• ICoreWebView2ExperimentalGetProcessInfosWithDetailsCompletedHandler

• ICoreWebView2ExperimentalProcessInfo

  • ICoreWebView2ExperimentalProcessInfo::get_AssociatedFrameInfos

Support for browser extensions in WebView2

Supports browser extensions in WebView2.

.NET/C#

• CoreWebView2BrowserExtension Class
• CoreWebView2EnvironmentOptions Class:
  • CoreWebView2EnvironmentOptions.AreBrowserExtensionsEnabled Property
• CoreWebView2Profile Class:
  • CoreWebView2Profile.AddBrowserExtensionAsync Method
  • CoreWebView2Profile.GetBrowserExtensionsAsync Method

WinRT/C#

• CoreWebView2BrowserExtension Class
• CoreWebView2EnvironmentOptions Class:
  • CoreWebView2EnvironmentOptions.AreBrowserExtensionsEnabled Property
• CoreWebView2Profile Class:
  • CoreWebView2Profile.AddBrowserExtensionAsync Method

Win32/C++

• ICoreWebView2ExperimentalBrowserExtension
  • ICoreWebView2ExperimentalBrowserExtension::get_IsEnabled
  • ICoreWebView2ExperimentalBrowserExtension::get_Name
• ICoreWebView2ExperimentalBrowserExtensionEnableCompletedHandler
• ICoreWebView2ExperimentalBrowserExtensionList
• ICoreWebView2ExperimentalBrowserExtensionRemoveCompletedHandler
• ICoreWebView2ExperimentalEnvironmentOptions
  • ICoreWebView2ExperimentalEnvironmentOptions::get_AreBrowserExtensionsEnabled
  • ICoreWebView2ExperimentalEnvironmentOptions::put_AreBrowserExtensionsEnabled property
• ICoreWebView2ExperimentalProfile12
  • ICoreWebView2ExperimentalProfile12::AddBrowserExtension
  • ICoreWebView2ExperimentalProfile12::GetBrowserExtensions
• ICoreWebView2ExperimentalProfileAddBrowserExtensionCompletedHandler
• ICoreWebView2ExperimentalProfileGetBrowserExtensionsCompletedHandler

Specifying the text direction

The TextDirectionKind enum specifies the text direction as left to right or right to left.

.NET/C#

• CoreWebView2TextDirectionKind Enum
  • Default
  • LeftToRight
  • RightToLeft

WinRT/C#

• CoreWebView2TextDirectionKind Enum
  • Default
  • LeftToRight
  • RightToLeft

Win32/C++

• COREWEBVIEW2_TEXT_DIRECTION_KIND enum
  • COREWEBVIEW2_TEXT_DIRECTION_KIND_DEFAULT
  • COREWEBVIEW2_TEXT_DIRECTION_KIND_LEFT_TO_RIGHT
  • COREWEBVIEW2_TEXT_DIRECTION_KIND_RIGHT_TO_LEFT

Bug fixes

• Fixed a CoreWebView2Frame.ExecuteScriptAsync hang that occurred when a frame was destroyed during script execution. Issue 3124

• Fixed a COMException when reading WebResourceResponse content after a redirect. Issue 3229

• Fixed an issue where PrintAsync fails when PrinterName contains Chinese characters. Issue 3379

• Fixed an issue to disable the context menu in print pages when AreDefaultContextMenusEnabled is set to false. Issue 3548

• Fixed an issue that caused PrintAsync and PrintToPdfStreamAsync to fail when print settings are null.

• Fixed an issue to ensure that WebVivew2Loader can be loaded from a UNC path. Issue 3465

• Fixed invalid CoreWebView2PdfToolbarItems.FullScreen and CoreWebView2PdfToolbarItems.MoreSettings.

• Fixed configuration options that (CoreWebView2PdfToolbarItems.MoreSettings, CoreWebView2PdfToolbarItems.FullScreen) are not valid in PDF preview mode. Issue 3324

See also

• Runtime 117.0.2045.28 (Sep. 18, 2023)
• Release notes for WebView2
  • Release notes for the WebView2 Runtime
  • Release notes for WebView2 SDKs