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 Accept-LanguageNavigator.language DOM プロパティを使用してサーバーに送信し、JavaScript に公開することを指定します。 形式は です language[-country]。ここで language 、ISO-639 の 2 文字のコードです。
allow-file-access-from-files 他file://の URI から URI を読み取file://ることができます。
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 。
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 対話型ドラッグを有効にします。
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 オーバーライドします。
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 デバイスのリモート デバッグ」を参照してください。
msEnhancedTextContrast 他のネイティブ Windows アプリケーションの品質と明瞭さに合わせて、テキスト コントラストの強化とガンマ補正を改善します。 このフラグを使用すると、フォント レンダリングでは、テキスト コントラストの強化とガンマ補正を適用するときに、ユーザーの ClearType チューナー設定が尊重されます。
msEnhancedTrackingPreventionEnabled 追跡ドメインと認識されているドメインに存在する Cookie や Web 要求のブロックなど、ネイティブのプライバシー保護機能を有効にします。
msFloatyMode の場合 false、Floaty 機能が無効になります。 WebView ではブラウザーの保持実験がサポートされていないため、このフラグを使用して Floaty 機能を無効にします。
msFloatyShouldHonorIndiaHoldout の場合 trueは、インドのホールドアウト グループが優先されます。 WebView ではブラウザーの保持実験がサポートされていないため、ユーザーがインドのホールドアウト グループの一部である場合に有効になる Floaty 機能を無効にするには、このフラグを に設定 falseします。
msOverlayScrollbarWinStyle Fluent スクロール バーのオーバーレイ モードと非オーバーレイ モードをユーザーが変更できるかどうか。
msPdfEnableAsPreview この機能により、PDF ビューアーは最小限のツール バーと読み取り専用プレビュー モードで起動できます。
msSmartScreenProtection 有効にすると、SmartScreen 保護が使用可能になります。
msUseSpellCheckCorrectionsCard 有効にすると、ユーザーがスペルミスの単語をクリックすると、UI カード新しい修正が表示されます。
msWebView2CodeCache 有効にした場合、WebView2 アプリSetVirtualHostNameToFolderMappingadd_WebResourceRequestedに読み込まれる JavaScript リソースは、バイトコード キャッシュの対象となります。これにより、3 回目以降の読み込みが高速化されます。 この機能により、DevTools ネットワーク インターセプト メカニズムを使用してカスタム応答を提供するその他のコンポーネントのバイトコード キャッシュも可能になります ( 「ネットワーク要求のカスタム管理」を参照)。
msWebView2TextureStream 有効にすると、キャプチャまたは構成されたビデオ フレームを WebView2 にストリーミングできます。JavaScript は、Video 要素や MediaStream を含む W3C 標準 DOM API を介してフレームをレンダリングまたは操作できます。
msWebView2EnableDraggableRegions の場合 true、WebView2 内の Web ページで CSS スタイルを app-region: drag\|nodrag 使用できるようになります。これにより、そのスタイルの要素がタイトル バーのように動作します。 このフラグがないと、CSS スタイル app-region: drag\|nodrag は効果がありません。
msWebView2CodeCache 有効にした場合、WebView2 アプリSetVirtualHostNameToFolderMappingadd_WebResourceRequestedに読み込まれる JavaScript リソースは、バイトコード キャッシュの対象となります。これにより、3 回目以降の読み込みが高速化されます。 この機能により、DevTools ネットワーク インターセプト メカニズムを使用してカスタム応答を提供するその他のコンポーネントのバイトコード キャッシュも可能になります。
msWebView2NativeEventDispatch 有効な場合は、ネイティブ mojo 接続を使用して、Web メッセージなどの内部イベントをレンダラー プロセスにディスパッチします。
msWebView2SimulateMemoryPressureWhenInactive 有効にした場合、非アクティブな WebView のメモリ負荷をシミュレートします。
msWebView2TreatAppSuspendAsDeviceSuspend 有効にすると、すべての WebView が中断されると、WebView2 はアプリをデバイスが中断されたかのように扱い、遅延したすべてのタスクとタイマーを一時停止します。
no-proxy-server 渡されるその他のプロキシ サーバー フラグをオーバーライドします。
net-log-capture-mode ネットワーク ログでキャプチャするイベントの粒度を設定します。 有効な値: Default、、IncludeSensitiveEverything。
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、balancedstrict。
SharedArrayBuffer 有効になっている場合は、スレッドが存在することを SharedArrayBuffer 示します。
SpareRendererForSitePerProcess このフラグが有効になっている場合、Edge Webview スペア レンダラー プロセスでは、最新の要求に対してウォーム スペア レンダラー プロセスが常に実行されます BrowserContext。 この機能は、サイトごとのプロセス モードでのみ参照されます。
ThirdPartyStoragePartitioning フィンガープリントを減らすために、最上位サイトによる、または CacheStorageなどのIndexedDBサード パーティ製ストレージのパーティション分割を有効にします。
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 このプロセスは、ユーザー データの移行後の再起動の結果であることを示します。
UseNativeThreadPool 有効にした場合、WebView2 ThreadPoolImpl はネイティブ スレッド プールの実装によってサポートされるフォアグラウンド ThreadGroup を使用します。
UseBackgroundNativeThreadPool これが有効になっている場合、WebView2 ThreadPoolImpl はネイティブ スレッド プールの実装によってサポートされるバックグラウンド ThreadGroup を使用します。
V8Maglev Maglev コンパイラを有効にします。 これは、手動でオーバーライドされた場合にのみ V8 フラグを設定します。それ以外の場合は、V8 の既定値が何であれに延期されます。

関連項目