Microsoft Edge WebView2 プレリリース SDK のリリース ノート、リリース日: 2026 年 9 月 11 日。
WebView2 SDK 1.0.4255-prerelease 用 NuGet パッケージ
API の完全な互換性のために、このプレリリース版の WebView2 SDK には、Microsoft Edge バージョン 154.0.4255.0 以降に付属する WebView2 ランタイムが必要です。 ランタイム 154.0.4258.31 (2026 年 9 月 28 日) を参照してください。
詳細な内容:
試験的な API (フェーズ 1: プレリリースでの試験段階)
次の API はフェーズ 1: プレリリースの試験段階にあり、このプレリリース SDK に追加されています。
フレーム レベルの LaunchingExternalUriScheme API
LaunchingExternalUriScheme イベントは、CoreWebView2に加えて CoreWebView2Frame でも発生するようになりました。 これにより、ホストは、外部 URI スキームの起動 ( mailto:、 tel:、カスタム プロトコルなど) を、それを開始した特定の iframe に属性付けできます。 これは、iframe が同じオリジンを共有する場合など、複数のサブアプリが iframe でホストされている場合に便利です。
LaunchingExternalUriScheme イベントは、frame内またはその中にネストされたiframe内のコンテンツが外部 URI スキームを起動しようとしたときに発生します。 起動がネストされた iframeから始まる場合、イベントは、追跡されている CoreWebView2Frame の親要素を外側にバブル (最も近い (最も内側の) 追跡されたフレームから始めて、最上位のフレームに向かって進行し、最後に CoreWebView2にバブルします。 各呼び出しのイベント送信者は、イベントを受信する CoreWebView2Frame です。
CoreWebView2LaunchingExternalUriSchemeEventArgs 新しい Handled プロパティがあります。 フレーム レベル ハンドラーは、 CoreWebView2 レベル ハンドラーの前に呼び出されます。フレーム レベル ハンドラーが Handled を TRUE に設定した場合、イベントは残りの親 CoreWebView2フレームでは発生しません。
Cancel は引き続き URI を起動するかどうかを制御し、 Handled は残りのハンドラーが呼び出されるかどうかを制御します。 引数 ( Cancel と Handled を含む) は階層間で共有されます。 Deferralを実行するときに WebView レベルのハンドラーを抑制するには、延期を行う前に Handled を設定します。
CoreWebView2Frameクラス:CoreWebView2LaunchingExternalUriSchemeEventArgsクラス:
共有クラスター環境 API
Shared Cluster Environment API を使用すると、 ClusterNameに同意することで、協力するホスト アプリケーションが、1 つのブラウザー プロセスと 1 つのユーザー データ フォルダーを含む WebView2 環境を明示的に共有できます。 アプリケーションはユーザー データのフォルダー パスを提供しません。WebView2 ランタイムは、クラスター名からこれを派生させます。
ホスト アプリは、CoreWebView2ClusterEnvironmentOptions インスタンスを使用してCoreWebView2Environment.CreateOrJoinClusterEnvironmentAsyncを呼び出します。 クラスターを確立する最初のホストによって、プロセス全体のオプションが決まります。 後でホストは、オプションが一致すると参加します。 これらのオプションは、共有ブラウザー プロセスが実行されている間、信頼できる状態を維持します。システムが終了すると、次のホストはさまざまなオプションを使用してクラスターを確立できます。
上記の操作は、Statusを含むCoreWebView2ClusterEnvironmentCreateResultを返し、成功した場合は共有CoreWebView2Environmentを返します。 指定可能な Status値:
Succeeded成功を示します。 共有CoreWebView2Environmentが作成され、返されます。OptionsMismatch実行中のクラスターに異なるオプションがあることを示します。 共有CoreWebView2Environmentは作成および返されません。NotSupportedホストがサンドボックス化されたAppContainerプロセスなどのクラスター環境を使用できないことを示します。 共有CoreWebView2Environmentは作成および返されません。
操作を開始または完了できなかった場合は、.NET と WinRT では例外として、Win32 では戻り値 HRESULT 失敗として個別に報告されます。
CoreWebView2Environment.GetClusterEnvironmentOptions を呼び出して、ブラウザーを起動せずに実行中のクラスターのオプションを読み取る。 クラスターが実行されていない場合、またはホストがクラスター環境を使用できない場合は、 null を返します。 推奨されるフローは、現在のオプションを読み取り、使用可能な場合は再利用してから、作成または参加することです。 別のホストがこれらの呼び出しの間にクラスターを確立できるため、アプリケーションは引き続き、オプションを再度読み取って再試行するか、プライベート環境を使用して OptionsMismatch を処理する必要があります。
PerHostProfileIsolation 既定で有効になっており、偶発的なプロファイル共有を防ぐために、ホスト アプリケーションごとに名前空間プロファイル名が使用されます。 これはセキュリティ境界ではありません。クラスター メンバーは相互に信頼する必要があります。 共有は、同じユーザーとログオン セッション内でサポートされ、ホストが同じ整合性レベル、昇格状態、および解決された WebView2 ランタイムを使用します。 アプリケーションは、ランタイム サポートをチェックし、API が使用できない場合はプライベート環境にフォールバックする必要があります。
共有 WebView2 クラスター 環境 API の仕様を参照してください。
-
CoreWebView2ClusterEnvironmentOptions クラス
- CoreWebView2ClusterEnvironmentOptions.AdditionalBrowserArguments プロパティ
- CoreWebView2ClusterEnvironmentOptions.AllowSingleSignOnUsingOSPrimaryAccount プロパティ
- CoreWebView2ClusterEnvironmentOptions.AreBrowserExtensionsEnabled プロパティ
- CoreWebView2ClusterEnvironmentOptions.ChannelSearchKind プロパティ
- CoreWebView2ClusterEnvironmentOptions.ClusterName プロパティ
- CoreWebView2ClusterEnvironmentOptions.CustomSchemeRegistrations プロパティ
- CoreWebView2ClusterEnvironmentOptions.EnableTrackingPrevention プロパティ
- CoreWebView2ClusterEnvironmentOptions.Language プロパティ
- CoreWebView2ClusterEnvironmentOptions.PerHostProfileIsolation プロパティ
- CoreWebView2ClusterEnvironmentOptions.ReleaseChannels プロパティ
-
CoreWebView2ClusterEnvironmentStatus 列挙型
NotSupportedOptionsMismatchSucceeded