次の方法で共有

WebView2 ブラウザー フラグ

  • [アーティクル]

Microsoft Edge WebView2 と対話し、動作に影響を与える方法の 1 つは、ブラウザー フラグ (引数、またはスイッチ) を WebView2 に渡すことです。 これらのブラウザー フラグは、今後の機能のテストや問題の診断に役立ちます。

警告

運用環境のアプリでは WebView2 ブラウザー フラグを使用しないでください。これらのフラグは、いつでも削除または変更される可能性があり、必ずしも長期的にサポートされるとは限りません。

一般に、フラグは Chromium と Microsoft Edge の両方によって所有されます。 Chromiumフラグは Microsoft Edge によって所有または制御されていないため、Microsoft Edge では、フラグの動作でフラグを削除または変更するタイミングや方法を制御できません。

ローカル デバイス環境でブラウザー フラグを設定したり、コードを使用してブラウザー フラグをプログラムで設定したりできます。 どちらの方法も以下で説明します。

ローカル デバイス環境でのブラウザー フラグの設定

今後の機能をテストしたり、問題を診断したりするには、 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 環境変数を設定するか、レジストリ キーを使用して、ローカル デバイス環境でブラウザー フラグを使用することをお勧めします。 詳細については、「Win32 API リファレンス: CreateCoreWebView2EnvironmentWithOptions」を参照してください。

コードを使用してブラウザー フラグをプログラムで設定する

ローカル デバイス環境でブラウザー フラグを設定する代わりに、ブラウザー フラグをプログラムで設定し、ブラウザー フラグを CoreWebView2EnvironmentOptions の AdditionalBrowserArguments プロパティとして渡す方法もあります。 ブラウザー フラグをプログラムで設定する場合は、アプリを配布する前にコード内のフラグを削除して、運用環境でフラグが誤って出荷されないようにしてください。

使用可能な WebView2 ブラウザー フラグ

使用されているフラグの一部を次に示します。

Flag 説明
accept-lang Navigator.language DOM プロパティを使用して、サーバーに送信して JavaScript に公開するAccept-Languageを指定します。 形式は language[-country]で、 language は ISO-639 の 2 文字のコードです。
allow-file-access-from-files 他のfile:// URI からfile:// URI を読み取ることができます。
allow-insecure-localhost localhost の TLS/SSL エラーを無視して、スポットが行われず、要求のブロックが行われないようにします。
allow-run-as-system 既定では、Edge WebView ブラウザーはシステムとして起動すると終了します (システムとして起動することはお勧めしません)。 このフラグは、そのチェックバイパスされるため、Edge WebView ブラウザーがシステムとして起動されても、Edge WebView ブラウザーは終了しません。
allow-running-insecure-content キャスト Web ランタイムで安全でないコンテンツを有効にします。 このフラグは、HTTP ソースからのコンテンツを提供する MSP のブロックを解除します。
auto-open-devtools-for-tabs Edge WebView で各タブの DevTools ウィンドウが自動的に開きます。開発者と自動化で使用します。
AutofillReplaceCachedWebElementsByRendererIds 有効にすると、AutofillAgent と FormTracker のキャッシュされた Web 要素がレンダラー ID に置き換えられます。
autoplay-policy 自動再生ポリシーを設定するコマンド ライン フラグ名。
BlockInsecurePrivateNetworkRequests この機能を有効にすると、 public アドレス空間内のセキュリティで保護されていないコンテキストから開始されたプライベート ネットワーク要求がブロックされます。
block-new-web-contents trueすると、window.openへのすべてのポップアップと呼び出しが失敗します。
BreakoutBoxPreferCaptureTimestampInVideoFrames WebView2 Runtime バージョン 124 以前の従来の動作と一致するように、CoreWebView2Texture クラスの Timestamp プロパティの動作を元に戻します。
disable-background-timer-throttling バックグラウンド ページからのタイマー タスクのタスク調整を無効にします。
disable-domain-action-user-agent-override ドメイン アクション機能からドメインごとのユーザー エージェントのオーバーライドを無効にします。
disable-gpu GPU ハードウェア アクセラレータを無効にします。 ソフトウェア レンダラーが配置されていない場合、GPU プロセスは起動しません。
disable-gpu-driver-bug-workarounds さまざまな GPU ドライバーのバグの回避策を無効にします。
disable-site-isolation-trials サイトの分離を無効にします。
disable-web-security クロスオリジン ポリシーを無効にし、同じ配信元ポリシーを適用しません。 Web サイトのテストにのみ使用します。
disk-cache-size ディスク キャッシュによって使用される最大ディスク領域を強制的にバイト単位で指定します。
do-not-de-elevate 起動時に WebView2 の昇格を解除できないようにします。 昇格解除後に、無限ループを防ぐために使用されます。
edge-webview-debugging-script スクリプト PostWebMessage 非同期的に実行します。
edge-webview-enable-mojo-ipcz WebView2 を使用するアプリの MojoIpcz (mojo-ipcz) を有効にします。
edge-webview-foreground-boost-opt-in フォアグラウンド ブーストにオプトインします。
edge-webview-foreground-boost-opt-out フォアグラウンド ブーストからオプトアウトします。
edge-webview-force-personal-context Edge WebView ブラウザー プロセスを WIP 個人用コンテキストで強制的に実行します。
edge-webview-interactive-dragging ポインター イベントとフォーカス イベントを、 --app-region: drag 属性を持つ要素で発生できるようにします。 ドラッグ要素は既定で対話型です。
edge-webview-disable-interactive-dragging --app-region: drag属性を持つ要素でポインター イベントとフォーカス イベントが発生しないようにします。 このフラグが設定されていない場合、ドラッグ要素は既定で対話型です。
edge-webview-is-background WebView がバックグラウンドで起動されていることを示します。
edge-webview-no-dpi-workaround "DPI 対応アプリの互換性 shim" 回避策を無効にします。これにより、シェルを介して Edge WebView ブラウザー プロセスが起動され、プロセスが "app compat" shim を継承しないようにします。
edge-webview-run-with-package-id ブリッジされたデスクトップ アプリのパッケージ ID (パッケージ ID) を使用して WebView プロセスを実行します。
edge-webview-run-without-package-id ブリッジされたデスクトップ アプリのパッケージ ID (パッケージ ID) なしで WebView プロセスを実行します。
embedded-browser-webview-dpi-awareness サーバー側プロセスの DPI 認識レベルを設定します。
enable-experimental-web-platform-features 開発中の Web プラットフォーム機能を有効にします。
enable-logging エラー レベルでログ記録を有効にします。
force-color-profile 指定したカラー プロファイルがあるかのように、すべてのモニターを強制的に処理します。 有効な値: srgb、 generic-rgb。
force-device-scale-factor Edge WebView ブラウザー UI とコンテンツのデバイス スケール ファクターをオーバーライドします。
force-fieldtrials ローカルで変更をテストするときにフィールドトライアルを強制するために使用できます。 引数は、スラッシュで区切られた名前と値のペアのリストです。 試用版名のプレフィックスにアスタリスクが付いている場合、その試用版がアクティブ化されます。 たとえば、次の引数は 2 つの試用版を定義し、2 つ目の試用版は EdgeNow/Enable/*MaterialDesignNTP/Default/ をアクティブにします。 このオプションをブラウザー プロセスで使用して、同じ形式を使用して、ブラウザー以外のプロセスに試用版の一覧を送信することもできます。
force-fieldtrial-params ローカルで変更をテストするときにフィールド 試行のパラメーターを強制するために使用できます。 引数は (キー、値) ペアのパラメーター リストで、関連付けられた (試用版、グループ) ペアのプレフィックスが付いています。 複数の (試用版、グループ) ペアの場合は、コンマ区切り記号を使用します。
force-renderer-accessibility スクリーン リーダーが検出されたときにレンダラーアクセシビリティをオンデマンドで有効にするのではなく、レンダラーのアクセシビリティを強制的にオンにするかどうか。 disable-renderer-accessibility フラグが存在する場合、disable-renderer-accessibility フラグはこのフラグをオーバーライドします。
HardwareMediaKeyHandling メディアを制御するためのハードウェア メディア キーの処理を有効にします。
ignore-certificate-errors 証明書関連のエラーを無視します。
ignore-gpu-blocklist GPU ブロックリストを無視するかどうか。
incognito --user-data-dir フラグを使用してユーザー データ ディレクトリを指定した場合でも、シークレット モードを強制します。
isolate-origins コンマ区切りリストとして指定された一連の配信元に対して専用プロセスを必要とします。 たとえば、--isolate-origins=https://www.foo.com、https://www.bar.com.
js-flags JS エンジンに渡されるフラグを指定します。
lang WebView2 が開こうとする言語ファイル。 言語が ISO-639 の 2 文字コードであるフォーム言語 [-country] の。
log-net-log ファイルへのネット ログ イベントの保存を有効にします。 値が指定されている場合、その値はディレクトリ パスとファイル名として使用されます。 値が指定されていない場合、ファイルには netlog.json という名前が付けられ、ユーザー データ ディレクトリに配置されます。
msAbydos "手書きテキスト変換" エクスペリエンスを有効にします。
msAbydosGestureSupport ユーザーがジェスチャ (スクラッチアウト ジェスチャなど) を使用して、ペンを使用してテキストを削除できるようにします。 msAbydos フラグが有効になっている場合にのみ有効です。
msAbydosHandwritingAttr DOM レベルの入力要素に対して "手書きテキスト変換" エクスペリエンスが有効になっているかどうか。 msAbydos フラグが有効になっている場合にのみ有効です。
msEdgeDesignerUI このフラグを使用して、Designer Shoreline アプリを無効にします。 この機能は、WebView2 ではサポートされていません。
msEdgeHubAppDesigner このフラグを使用して、Designer Shoreline アプリを無効にします。 この機能は、WebView2 ではサポートされていません。
msEdgeDesignerDriverFix このフラグを使用して、コンテンツの取得を無効にし、Designer機能を自動的に表示します。 この機能は、WebView2 ではサポートされていません。
msEdgeFluentOverlayScrollbar Fluent Overlay スクロール バーを強制的に有効にし、現時点で保持できる値 kFluentScrollbar オーバーライドします。
msEdgeDevToolsWdpRemoteDebugging リモート デバッグを有効にします。 「WebView2 WinUI 2 (UWP) アプリのリモート デバッグ、Windows デバイスのリモート デバッグ」を参照してください。
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs このフラグが有効になっている場合、 AddWebResourceRequestedFilter メソッド (オーバーロードを含む) もプロセス外の iframe に適用されます。
.NET: AddWebResourceRequestedFilter
WinRT: AddWebResourceRequestedFilter
Win32: AddWebResourceRequestedFilterWithRequestSourceKinds
msEnhancedTextContrast 他のネイティブ Windows アプリケーションの品質と明瞭さに合わせて、テキスト コントラストの強化とガンマ補正を改善します。 このフラグを使用すると、フォント レンダリングでは、テキスト コントラストの強化とガンマ補正を適用するときに、ユーザーの ClearType チューナー設定が尊重されます。
msEnhancedTrackingPreventionEnabled 追跡ドメインと認識されているドメインに存在する Cookie や Web 要求のブロックなど、ネイティブのプライバシー保護機能を有効にします。
msFloatyMode false場合は、Floaty 機能を無効にします。 WebView ではブラウザーの保持実験がサポートされていないため、このフラグを使用して Floaty 機能を無効にします。
msFloatyShouldHonorIndiaHoldout true場合は、インドのホールドアウト グループを尊重します。 WebView ではブラウザー保持実験がサポートされていないため、ユーザーがインドのホールドアウト グループの一部である場合に有効になっている Floaty 機能を無効にするには、このフラグを [ false] に設定して使用します。
msOverlayScrollbarWinStyle Fluent スクロール バーのオーバーレイ モードと非オーバーレイ モードをユーザーが変更できるかどうか。
msPdfEnableAsPreview この機能により、PDF ビューアーは最小限のツール バーと読み取り専用プレビュー モードで起動できます。
msSingleSignOnOSForPrimaryAccountIsShared 有効にした場合、プライマリ OS アカウントの情報を使用して、任意のアカウントを使用して Microsoft Web ページへの暗黙的なサインインを許可します。
msSmartScreenProtection 有効にすると、SmartScreen 保護が使用可能になります。
msUseSpellCheckCorrectionsCard 有効にすると、ユーザーがスペルミスの単語をクリックすると、UI カード新しい修正が表示されます。
msWebView2CancelInitialNavigation 有効にすると、WebView2 の初期ナビゲーションが取り消され、スタートアップ パフォーマンスが向上します。
msWebView2CodeCache 有効にすると、 SetVirtualHostNameToFolderMapping または add_WebResourceRequested を介して WebView2 アプリに読み込まれる JavaScript リソースはバイトコード キャッシュの対象となり、3 回目以降の読み込みが高速化されます。 この機能により、DevTools ネットワーク インターセプト メカニズムを使用してカスタム応答を提供するその他のコンポーネントのバイトコード キャッシュも可能になります ( 「ネットワーク要求のカスタム管理」を参照)。
msWebView2EnableDownloadContentInWebResourceResponseReceived 有効にした場合は、ダウンロードされるナビゲーションの応答をで使用できるようにする WebResourceResponseReceived
msWebView2TextureStream 有効にすると、キャプチャまたは構成されたビデオ フレームを WebView2 にストリーミングできます。JavaScript は、Video 要素や MediaStream を含む W3C 標準 DOM API を介してフレームをレンダリングまたは操作できます。
msWebView2EnableDraggableRegions true場合、WebView2 内の Web ページで app-region: drag\|nodrag CSS スタイルを使用できるようになります。これにより、そのスタイルを持つ要素がタイトル バーのように動作します。 このフラグがないと、 app-region: drag\|nodrag CSS スタイルは効果がありません。
msWebView2CodeCache 有効にすると、 SetVirtualHostNameToFolderMapping または add_WebResourceRequested を介して WebView2 アプリに読み込まれる JavaScript リソースはバイトコード キャッシュの対象となり、3 回目以降の読み込みが高速化されます。 この機能により、DevTools ネットワーク インターセプト メカニズムを使用してカスタム応答を提供するその他のコンポーネントのバイトコード キャッシュも可能になります。
msWebView2NativeEventDispatch 有効な場合は、ネイティブ mojo 接続を使用して、Web メッセージなどの内部イベントをレンダラー プロセスにディスパッチします。
msWebView2SimulateMemoryPressureWhenInactive 有効にした場合、非アクティブな WebView のメモリ負荷をシミュレートします。
msWebView2TreatAppSuspendAsDeviceSuspend 有効にすると、すべての WebView が中断されると、WebView2 はアプリをデバイスが中断されたかのように扱い、遅延したすべてのタスクとタイマーを一時停止します。
no-proxy-server 渡されるその他のプロキシ サーバー フラグをオーバーライドします。
net-log-capture-mode ネットワーク ログでキャプチャするイベントの粒度を設定します。 有効な値: Default、 IncludeSensitive、 Everything。
no-network-profile-warning 有効にすると、UDF がネットワーク共有上にあるかどうかがブラウザーによって警告されます。 このフラグは Windows でのみサポートされています。このフラグは、他のプラットフォームでは無視されます。
no-sandbox 通常サンドボックス化されているすべてのプロセスの種類のサンドボックスを無効にします。 テスト目的でのみブラウザー レベルのフラグとして使用されることを意味します。
no-first-run 実際に最初の実行であるかどうかに関係なく、First-Run タスクをスキップし、[新機能] ページの表示をスキップします。 このフラグは、 kForceFirstRun (First-Run エクスペリエンス (FRE) の場合) と kForceWhatsNew (新機能の表示) によってオーバーライドされます。 このフラグは First Run Sentinel を削除しないため、このフラグなしで次に Edge WebView ブラウザーを起動した場合に First-Run エクスペリエンスが発生するのを防ぐわけではありません。 このフラグでは、最後の [新着情報] マイルストーンは更新されないため、このフラグなしで Edge WebView ブラウザーが次回起動したときに新着情報が表示されるのを防ぐわけではありません。
PartitionedCookies 有効にすると、サイトは Partitioned 属性を使用して、トップレベル サイトによって Cookie をパーティション分割することをオプトインできます。 パーティション分割された Cookie は、ブラウザーが Cookie が設定されたときと同じトップレベル サイト上にある場合にのみ送信されます。
proxy-auto-detect プロキシ自動検出を強制します。
proxy-bypass-list プロキシ設定がバイパスされるホストの一覧。指定したホストは、代わりに直接接続を使用します。 --proxy-serverも指定されていない限り、このフラグは無視されます。 複数のホストをコンマ区切りリストとして指定できます。
proxy-server システム設定をオーバーライドするプロキシ サーバー。 このフラグは、HTTP 要求と HTTPS 要求にのみ影響します。
remote-allow-origins 指定された配信元からの Web ソケット接続のみを有効にします。 * ワイルドカードを使用すると、任意の配信元を使用できます。
remote-debugging-port 指定したポートで HTTP 経由でリモート デバッグを有効にします。
RendererAppContainer レンダラーの AppContainerを有効にします。
Restart Microsoft Edge WebView2 ブラウザー プロセスが再起動されたことを示します (フラグの変更後など)。 このフラグを使用して、 Launch.Mode2 メトリックを記録するときに起動を無視します。
sdsm-state "Super Duper Secure Mode" 状態。 有効な値: off、 basic、 balanced、 strict。
SharedArrayBuffer 有効になっている場合は、 SharedArrayBuffer スレッドが存在することを示します。
SpareRendererForSitePerProcess このフラグが有効になっている場合、Edge Webview スペア レンダラー プロセスは、最新の要求された BrowserContextに対してウォーム スペア レンダラー プロセスを常に実行しようとします。 この機能は、サイトごとのプロセス モードでのみ参照されます。
ThirdPartyStoragePartitioning IndexedDBやCacheStorageなどのサード パーティ製ストレージの最上位サイトによるパーティション分割を有効にして、フィンガープリントを減らします。
unsafely-treat-insecure-origin-as-secure 指定された (安全でない) 配信元を安全な配信元として扱います。 複数の配信元をコンマ区切りリストとして指定できます。 セキュリティで保護されたコンテキストの定義については、「セキュリティで保護されたコンテキスト」セクションを参照してください。「origin信頼できる可能性がありますか?」を参照してください。 例: --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test
use-fake-device-for-media-stream メディア Streamの偽のデバイスを使用して、実際のカメラとマイクを置き換えます。
use-fake-ui-for-media-stream メディア ストリームの既定のデバイス (WebRTC など) を選択して、メディア ストリーム情報バーをバイパスします。 --use-fake-device-for-media-streamで動作します。 代わりに --auto-accept-camera-and-microphone-capture を使用することを好みます。これは、ブラウザー タブのキャプチャなど、画面キャプチャとは対話しません。
use-system-proxy-resolver WinHttp を使用して、WebView2 の通常のプロキシ解決ロジックを使用する代わりにプロキシを解決します。 このフラグは Windows でのみサポートされています。
user-agent 既定のユーザー エージェントをカスタム ユーザー エージェントでオーバーライドするために使用される文字列。
user-data-migrated このプロセスは、ユーザー データの移行後の再起動の結果であることを示します。
UseBackgroundNativeThreadPool これが有効になっている場合、WebView2 ThreadPoolImpl はネイティブ スレッド プールの実装によってサポートされるバックグラウンド ThreadGroup を使用します。
UseNativeThreadPool 有効にすると、WebView2 ThreadPoolImpl では、ネイティブ スレッド プールの実装によってサポートされるフォアグラウンド ThreadGroup が使用されます。
V8Maglev Maglev コンパイラを有効にします。 これは、手動でオーバーライドされた場合にのみ V8 フラグを設定します。それ以外の場合は、V8 の既定値が何であれに延期されます。

関連項目