Freigeben über

WebView2-Browserflags

  • Artikel

Eine der Möglichkeiten, mit Microsoft Edge WebView2 zu interagieren und das Verhalten auswirkungen zu beeinflussen, besteht darin, Browserflags (Argumente oder Schalter) an WebView2 zu übergeben. Diese Browserflags sind nützlich, um zukünftige Features zu testen und Probleme zu diagnostizieren.

Warnung

Apps in der Produktion sollten keine WebView2-Browserflags verwenden, da diese Flags jederzeit entfernt oder geändert werden können und nicht unbedingt langfristig unterstützt werden.

Im Allgemeinen gehören die Flags sowohl Chromium als auch Microsoft Edge. Chromium Flags nicht im Besitz von Microsoft Edge sind oder von Microsoft Edge gesteuert werden, sodass Microsoft Edge keine Kontrolle darüber hat, wann und wie die Flags entfernt oder in ihrem Verhalten geändert werden.

Sie können Browserflags in Ihrer lokalen Geräteumgebung festlegen oder Browserflags programmgesteuert über Code festlegen. Beide Ansätze werden unten beschrieben.

Festlegen von Browserflags in Ihrer lokalen Geräteumgebung

Um zukünftige Features zu testen oder Probleme zu diagnostizieren, empfehlen wir die Verwendung von Browserflags in Ihrer lokalen Geräteumgebung durch Festlegen der Umgebungsvariable WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS oder über Registrierungsschlüssel. Weitere Informationen finden Sie in der folgenden Win32-API-Referenz: CreateCoreWebView2EnvironmentWithOptions.

Programmgesteuertes Festlegen von Browserflags über Code

Anstatt Browserflags in Ihrer lokalen Geräteumgebung festzulegen, besteht ein alternativer Ansatz darin, Browserflags programmgesteuert festzulegen, indem die Browserflags als AdditionalBrowserArguments -Eigenschaft von CoreWebView2EnvironmentOptionsübergeben werden. Wenn Sie Browserflags programmgesteuert festlegen, entfernen Sie die Flags im Code vor dem Versand Ihrer App, um zu vermeiden, dass die Flags versehentlich in der Produktion versendet werden.

Verfügbare WebView2-Browserflags

Im Folgenden finden Sie einige der verwendeten Flags.

Flag Beschreibung
accept-lang Gibt an Accept-Language , dass über die Navigator.language-DOM-Eigenschaft an Server gesendet und für JavaScript verfügbar gemacht werden soll. Das Format ist language[-country], wobei language der 2-Buchstaben-Code aus ISO-639 ist.
allow-file-access-from-files Ermöglicht das Lesen file:// von URIs aus anderen file:// URIs.
allow-insecure-localhost Ermöglicht es, TLS/SSL-Fehler auf localhost zu ignorieren, sodass keine Interstitiale erfolgen und keine Blockierung von Anforderungen erfolgt.
allow-run-as-system Standardmäßig wird der Edge WebView-Browser beendet, wenn er als System gestartet wird (das Starten als System wird nicht empfohlen). Dieses Flag umgeht diese Überprüfung, sodass selbst wenn der Edge WebView-Browser als System gestartet wird, der Edge WebView-Browser nicht beendet wird.
allow-running-insecure-content Aktiviert unsichere Inhalte in Cast Web Runtime. Dieses Flag hebt die Blockierung von MSPs auf, die Inhalte aus HTTP-Quellen bereitstellen.
auto-open-devtools-for-tabs Bewirkt, dass Edge WebView das DevTools-Fenster für jede Registerkarte automatisch öffnet. Zur Verwendung durch Entwickler und durch Automatisierung.
AutofillReplaceCachedWebElementsByRendererIds Wenn diese Option aktiviert ist, werden zwischengespeicherte Webelemente in AutofillAgent und FormTracker durch ihre Renderer-IDs ersetzt.
autoplay-policy Name des Befehlszeilenflags zum Festlegen der Richtlinie für die automatische Wiedergabe.
BlockInsecurePrivateNetworkRequests Wenn dieses Feature aktiviert ist, werden private Netzwerkanforderungen blockiert, die public von nicht sicheren Kontexten im Adressraum initiiert werden.
block-new-web-contents Gibt truean, dass alle Popups und Aufrufe von window.open fehlschlagen.
BreakoutBoxPreferCaptureTimestampInVideoFrames Stellt das Verhalten der Timestamp -Eigenschaft der CoreWebView2Texture -Klasse so zurück, dass es dem Legacyverhalten von WebView2 Runtime Version 124 und früher entspricht.
disable-background-timer-throttling Deaktiviert die Taskdrosselung von Zeitgeberaufgaben von Hintergrundseiten.
disable-domain-action-user-agent-override Deaktiviert die Domänen-Benutzer-Agent-Außerkraftsetzung aus dem Feature "Domänenaktionen".
disable-gpu Deaktiviert die GPU-Hardwarebeschleunigung. Wenn kein Softwarerenderer vorhanden ist, wird der GPU-Prozess nicht gestartet.
disable-gpu-driver-bug-workarounds Deaktiviert Problemumgehungen für verschiedene GPU-Treiberfehler.
disable-site-isolation-trials Deaktiviert die Websiteisolation.
disable-web-security Deaktiviert die ursprungsübergreifende Richtlinie und erzwingt nicht die Richtlinie desselben Ursprungs. Verwenden Sie nur für Websitetests.
disk-cache-size Erzwingt, dass der maximale Speicherplatz vom Datenträgercache in Bytes verwendet wird.
do-not-de-elevate Verhindert das Aufheben der Rechteerweiterung von WebView2 beim Start. Wird nach dem Aufheben der Erhöhten verwendet, um Endlosschleifen zu verhindern.
edge-webview-debugging-script Führt das Skript asynchron aus PostWebMessage .
edge-webview-enable-mojo-ipcz Aktiviert MojoIpcz (mojo-ipcz) für Apps, die WebView2 verwenden.
edge-webview-foreground-boost-opt-in Aktiviert die Vordergrundverstärkung.
edge-webview-foreground-boost-opt-out Deaktiviert die Vordergrundverstärkung.
edge-webview-force-personal-context Erzwingt die Ausführung von Edge WebView-Browserprozessen im persönlichen WIP-Kontext.
edge-webview-interactive-dragging Ermöglicht Zeigerereignissen und Fokusereignissen für Elemente, die über das --app-region: drag -Attribut verfügen. Drag-Elemente sind standardmäßig interaktiv.
edge-webview-disable-interactive-dragging Deaktiviert Zeigerereignisse und Fokusereignisse, die für Elemente auftreten, die über das --app-region: drag -Attribut verfügen. Wenn dieses Flag nicht festgelegt ist, sind Ziehelemente standardmäßig interaktiv.
edge-webview-is-background Gibt an, dass WebView im Hintergrund gestartet wird.
edge-webview-no-dpi-workaround Deaktiviert die Problemumgehung "DPI-Kompatibilitäts-App-Kompatibilitäts-Shim", die den Edge WebView-Browserprozess über eine Shell startet, sodass der Prozess nicht den Shim "App compat" erbt.
edge-webview-run-with-package-id Führt WebView-Prozesse mit einer Paketidentität (Paket-ID) für eine Überbrückungs-Desktop-App aus.
edge-webview-run-without-package-id Führt WebView-Prozesse ohne Paketidentität (Paket-ID) für eine Überbrückungs-Desktop-App aus.
embedded-browser-webview-dpi-awareness Legt den DPI-Bekanntheitsgrad der serverseitigen Prozesse fest.
enable-experimental-web-platform-features Aktiviert Webplattformfeatures, die sich in der Entwicklung befinden.
enable-logging Aktivieren Sie die Protokollierung auf Der Fehlerebene.
force-color-profile Erzwingen Sie, dass alle Monitore so behandelt werden, als hätten sie das angegebene Farbprofil. Gültige Werte: srgb, generic-rgb.
force-device-scale-factor Überschreibt den Geräteskalierungsfaktor für die Benutzeroberfläche des Edge WebView-Browsers und den Inhalt.
force-fieldtrials Kann verwendet werden, um Feldversuche zu erzwingen, wenn Änderungen lokal getestet werden. Das Argument ist eine Liste von Name-Wert-Paaren, die durch Schrägstriche getrennt sind. Wenn einem Testnamen ein Sternchen vorangestellt ist, wird diese Testversion aktiviert. Das folgende Argument definiert beispielsweise zwei Testversionen, wobei die zweite aktiviert ist: EdgeNow/Enable/*MaterialDesignNTP/Default/. Diese Option kann auch vom Browserprozess verwendet werden, um die Liste der Testversionen im gleichen Format an einen Nicht-Browserprozess zu senden.
force-fieldtrial-params Kann verwendet werden, um Parameter von Feldversuchen zu erzwingen, wenn Änderungen lokal getestet werden. Das Argument ist eine Parameterliste von (Schlüssel-, Wert-)Paaren, die einem zugeordneten Paar (Testversion, Gruppe) vorangestellt sind. Verwenden Sie für mehrere Paare (Testversion, Gruppe) ein Kommatrennzeichen.
force-renderer-accessibility Gibt an, ob die Barrierefreiheit des Renderers aktiviert werden soll, anstatt die Barrierefreiheit des Renderers bei Bedarf zu aktivieren, wenn eine Sprachausgabe erkannt wird. Das disable-renderer-accessibility Flag setzt dieses Flag außer Kraft, wenn das disable-renderer-accessibility Flag vorhanden ist.
HardwareMediaKeyHandling Ermöglicht die Behandlung von Hardwaremedientasten zum Steuern von Medien.
ignore-certificate-errors Ignoriert zertifikatbezogene Fehler.
ignore-gpu-blocklist Gibt an, ob die GPU-Sperrliste ignoriert werden soll.
incognito Erzwingt den Inkognito-Modus, auch wenn das Benutzerdatenverzeichnis mithilfe des --user-data-dir Flags angegeben wird.
isolate-origins Erfordert dedizierte Prozesse für eine Gruppe von Ursprüngen, die als durch Trennzeichen getrennte Liste angegeben sind. Beispiel: --isolate-origins=https://www.foo.com,https://www.bar.com.
js-flags Gibt die Flags an, die an die JS-Engine übergeben werden.
lang Die Sprachdatei, die WebView2 öffnen möchte. Der Formularsprache [-country], wobei sprache der 2-Buchstaben-Code aus ISO-639 ist.
log-net-log Ermöglicht das Speichern von Net Log-Ereignissen in einer Datei. Wenn ein Wert angegeben wird, wird dieser Wert als Verzeichnispfad und Dateiname verwendet. Wenn kein Wert angegeben wird, hat die Datei den Namen netlog.jsonund wird im Benutzerdatenverzeichnis abgelegt.
msAbydos Aktiviert die Benutzeroberfläche "Handschrift in Text".
msAbydosGestureSupport Ermöglicht Benutzern das Verwenden von Gesten (z. B. der Scratchout-Geste), um Text mithilfe eines Stifts zu löschen. Nur gültig, wenn das msAbydos Flag aktiviert ist.
msAbydosHandwritingAttr Gibt an, ob die Benutzeroberfläche "Handschrift in Text" für Eingabeelemente auf DOM-Ebene aktiviert ist. Nur gültig, wenn das msAbydos Flag aktiviert ist.
msEdgeDesignerUI Verwenden Sie dieses Flag, um die Designer Shoreline-App zu deaktivieren. Dieses Feature wird in WebView2 nicht unterstützt.
msEdgeHubAppDesigner Verwenden Sie dieses Flag, um die Designer Shoreline-App zu deaktivieren. Dieses Feature wird in WebView2 nicht unterstützt.
msEdgeDesignerDriverFix Verwenden Sie dieses Flag, um das Abrufen von Inhalten zu deaktivieren und das feature Designer automatisch anzuzeigen. Dieses Feature wird in WebView2 nicht unterstützt.
msEdgeFluentOverlayScrollbar Erzwingt die Fluent-Überlagerungs-Scrollleisten und überschreibt einen beliebigen Wert kFluentScrollbar , der derzeit enthalten sein kann.
msEdgeDevToolsWdpRemoteDebugging Aktiviert das Remotedebuggen. Weitere Informationen finden Sie unter Remotedebuggen von WebView2 WinUI 2(UWP)-Apps, Remotedebuggen von Windows-Geräten.
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs Wenn dieses Flag aktiviert ist, gilt die AddWebResourceRequestedFilter Methode (einschließlich Überladungen) auch für Iframes außerhalb des Prozesses.
.NET: AddWebResourceRequestedFilter
WinRT: AddWebResourceRequestedFilter
Win32: AddWebResourceRequestedFilterWithRequestSourceKinds
msEnhancedTextContrast Verbessert die Verbesserung des Textkontrasts und die Gammakorrektur, um die Qualität und Klarheit anderer nativer Windows-Anwendungen zu verbessern. Wenn dieses Flag verwendet wird, berücksichtigt das Rendern von Schriftarten die ClearType Tuner-Einstellungen des Benutzers beim Anwenden von Textkontrastverbesserung und Gammakorrektur.
msEnhancedTrackingPreventionEnabled Aktiviert native Datenschutzfeatures, z. B. das Blockieren von Cookies und Webanforderungen, die sich in Domänen befinden, von denen bekannt ist, dass sie Nachverfolgungsdomänen sind.
msFloatyMode Bei falsewird das Floaty-Feature deaktiviert. Verwenden Sie dieses Flag, um das Floaty-Feature zu deaktivieren, da WebView keine Browseraufbewahrungsexperimente unterstützt.
msFloatyShouldHonorIndiaHoldout Wenn der Wert trueist, wird die Zurückhaltungsgruppe Indien berücksichtigt. Verwenden Sie dieses Flag, legen Sie auf falsefest, um das Floaty-Feature zu deaktivieren, das aktiviert ist, wenn der Benutzer Teil der Sperrgruppe Indien ist, da WebView keine Browseraufbewahrungsexperimente unterstützt.
msOverlayScrollbarWinStyle Gibt an, ob die Benutzer zwischen Überlagerungs- und Nicht-Überlagerungsmodi für Fluent-Scrollleisten wechseln können.
msPdfEnableAsPreview Mit diesen Features kann der PDF-Viewer mit einer minimalen Symbolleiste und im schreibgeschützten Vorschaumodus gestartet werden.
msSingleSignOnOSForPrimaryAccountIsShared Wenn diese Option aktiviert ist, wird die implizite Anmeldung bei Microsoft-Webseiten mithilfe eines beliebigen Kontos mithilfe der Informationen aus dem primären Betriebssystemkonto ermöglicht.
msSmartScreenProtection Wenn diese Option aktiviert ist, ist der SmartScreen-Schutz verfügbar.
msUseSpellCheckCorrectionsCard Wenn diese Option aktiviert ist, wird eine neue Korrektur Karte Benutzeroberfläche angezeigt, wenn der Benutzer auf ein falsch geschriebenes Wort klickt.
msWebView2CancelInitialNavigation Wenn diese Option aktiviert ist, bricht die anfängliche Navigation in WebView2 ab, um die Startleistung zu verbessern.
msWebView2CodeCache Wenn diese Option aktiviert ist, sind JavaScript-Ressourcen, die über SetVirtualHostNameToFolderMapping oder add_WebResourceRequested in eine WebView2-App geladen werden, für die Bytecodezwischenspeicherung geeignet, wodurch der dritte und nachfolgende Ladevorgang beschleunigt werden sollte. Dieses Feature ermöglicht auch das Zwischenspeichern von Bytecode für alle anderen Komponenten, die den DevTools-Netzwerkabfangmechanismus verwenden, um benutzerdefinierte Antworten bereitzustellen (siehe Benutzerdefinierte Verwaltung von Netzwerkanforderungen).
msWebView2EnableDownloadContentInWebResourceResponseReceived Wenn diese Option aktiviert ist, können Antworten von Navigationen, die zu Downloads werden, in verfügbar sein. WebResourceResponseReceived
msWebView2TextureStream Wenn diese Option aktiviert ist, können aufgezeichnete oder zusammengesetzte Videoframes an webView2 gestreamt werden, wo JavaScript die Frames über W3C-Standard-DOM-APIs wie das Video-Element und MediaStream rendern oder anderweitig mit diesen interagieren kann.
msWebView2EnableDraggableRegions Gibt truean, dass Webseiten in WebView2 den app-region: drag\|nodrag CSS-Stil verwenden, wodurch sich Elemente mit dieser Formatvorlage wie eine Titelleiste verhalten. Ohne dieses Flag hat der app-region: drag\|nodrag CSS-Stil keine Auswirkungen.
msWebView2CodeCache Wenn diese Option aktiviert ist, sind JavaScript-Ressourcen, die über SetVirtualHostNameToFolderMapping oder add_WebResourceRequested in eine WebView2-App geladen werden, für die Bytecodezwischenspeicherung geeignet, wodurch der dritte und nachfolgende Ladevorgang beschleunigt werden sollte. Dieses Feature ermöglicht auch das Zwischenspeichern von Bytecode für alle anderen Komponenten, die den DevTools-Netzwerkabfangmechanismus verwenden, um benutzerdefinierte Antworten bereitzustellen.
msWebView2NativeEventDispatch Wenn diese Option aktiviert ist, wird eine native Mojo-Verbindung verwendet, um interne Ereignisse wie Webnachrichten an einen Rendererprozess zu senden.
msWebView2SimulateMemoryPressureWhenInactive Wenn diese Option aktiviert ist, wird die Arbeitsspeicherauslastung für eine inaktive WebView simuliert.
msWebView2TreatAppSuspendAsDeviceSuspend Wenn diese Option aktiviert ist und alle WebViews angehalten werden, behandelt WebView2 die App so, als wäre das Gerät angehalten, und alle verzögerten Aufgaben und Timer werden angehalten.
no-proxy-server Überschreibt alle anderen übergebenen Proxyserverflags.
net-log-capture-mode Legt die Granularität von Ereignissen fest, die im Netzwerkprotokoll erfasst werden sollen. Gültige Werte: Default, IncludeSensitive, Everything.
no-network-profile-warning Wenn diese Option aktiviert ist, warnt der Browser, wenn sich die UDF auf einer Netzwerkfreigabe befindet. Dieses Flag wird nur unter Windows unterstützt. Dieses Flag wird auf anderen Plattformen ignoriert.
no-sandbox Deaktiviert die Sandbox für alle Prozesstypen, die normalerweise als Sandkasten verwendet werden. Dient nur zur Verwendung als Flag auf Browserebene zu Testzwecken.
no-first-run Überspringt First-Run Aufgaben, unabhängig davon, ob es sich tatsächlich um die erste Ausführung handelt, und überspringt das Anzeigen der Seite Neues. Dieses Flag wird überschrieben von kForceFirstRun (für die First-Run Experience (FRE)) und von kForceWhatsNew (zum Anzeigen von Neuerungen). Dieses Flag löscht den Sentinel für die erste Ausführung nicht und verhindert daher nicht, dass die First-Run Erfahrung auftritt, wenn der Edge WebView-Browser das nächste Mal ohne dieses Flag gestartet wird. Dieses Flag aktualisiert den letzten Neuerungs-Meilenstein nicht, sodass nicht verhindert wird, dass Neuigkeiten angezeigt werden, wenn der Edge WebView-Browser das nächste Mal ohne dieses Flag gestartet wird.
PartitionedCookies Wenn diese Option aktiviert ist, können Websites ihre Cookies mithilfe des -Attributs durch die Website der Partitioned obersten Ebene partitionieren lassen. Partitionierte Cookies werden nur gesendet, wenn sich der Browser auf derselben Website der obersten Ebene befindet, auf der er sich befand, als das Cookie gesetzt wurde.
proxy-auto-detect Erzwingt die automatische Proxyerkennung.
proxy-bypass-list Eine Liste der Hosts, für die Proxyeinstellungen umgangen werden; Die angegebenen Hosts verwenden dann stattdessen direkte Verbindungen. Dieses Flag wird ignoriert, es sei denn --proxy-server , es wird ebenfalls angegeben. Mehrere Hosts können als durch Trennzeichen getrennte Liste bereitgestellt werden.
proxy-server Ein Proxyserver, der Systemeinstellungen überschreibt. Dieses Flag wirkt sich nur auf HTTP- und HTTPS-Anforderungen aus.
remote-allow-origins Aktiviert nur Websocketverbindungen von den angegebenen Ursprüngen. Der * -Wildcard lässt einen beliebigen Ursprung zu.
remote-debugging-port Ermöglicht das Remotedebuggen über HTTP am angegebenen Port.
RendererAppContainer Aktiviert renderer AppContainer.
Restart Gibt an, dass der Microsoft Edge WebView2-Browserprozess neu gestartet wurde (z. B. nach einer Flagänderung). Verwenden Sie dieses Flag, um den Start beim Aufzeichnen der Launch.Mode2 Metrik zu ignorieren.
sdsm-state Der Status "Super Duper Secure Mode". Gültige Werte: off, basic, balanced, strict.
SharedArrayBuffer Wenn aktiviert, gibt an, dass ein SharedArrayBuffer Thread vorhanden ist.
SpareRendererForSitePerProcess Wenn dieses Flag aktiviert ist, versucht der Edge Webview-Ersatzrendererprozess, immer einen warmen Ersatzrendererprozess für den zuletzt angeforderten BrowserContextauszuführen. Dieses Feature wird nur im Site-pro-Prozess-Modus abgerufen.
ThirdPartyStoragePartitioning Ermöglicht die Partitionierung von Drittanbieterspeichern, z IndexedDB . B. oder CacheStorage, durch den Standort der obersten Ebene, um den Fingerabdruck zu reduzieren.
unsafely-treat-insecure-origin-as-secure Behandelt angegebene (unsichere) Ursprünge als sichere Ursprünge. Mehrere Ursprünge können als durch Trennzeichen getrennte Liste angegeben werden. Informationen zur Definition von sicheren Kontexten finden Sie unter Sichere Kontexte, einschließlich des Abschnitts Ist origin potenziell vertrauenswürdig?. Beispiel: --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test
use-fake-device-for-media-stream Verwendet ein gefälschtes Gerät für Media Stream, um eine tatsächliche Kamera und ein Mikrofon zu ersetzen.
use-fake-ui-for-media-stream Umgeht die Infoleiste des Medienstreams, indem das Standardgerät für Medienstreams (z. B. WebRTC) ausgewählt wird. Funktioniert mit --use-fake-device-for-media-stream. Bevorzugen Sie stattdessen die Verwendung --auto-accept-camera-and-microphone-capture von , die nicht mit der Bildschirmaufnahme interagiert, z. B. das Erfassen einer Browserregisterkarte.
use-system-proxy-resolver Verwendet WinHttp, um Proxys aufzulösen, anstatt die normale Proxyauflösungslogik von WebView2 zu verwenden. Dieses Flag wird nur in Windows unterstützt.
user-agent Eine Zeichenfolge, die verwendet wird, um den Standardbenutzer-Agent mit einem benutzerdefinierten Benutzer-Agent zu überschreiben.
user-data-migrated Gibt an, dass dieser Prozess das Produkt eines Neustarts nach der Migration von Benutzerdaten ist.
UseBackgroundNativeThreadPool Wenn dies aktiviert ist, verwendet WebView2 ThreadPoolImpl eine ThreadGroup im Hintergrund, die von einer nativen Threadpoolimplementierung unterstützt wird.
UseNativeThreadPool Wenn diese Option aktiviert ist, verwendet WebView2 ThreadPoolImpl einen Vordergrund ThreadGroup , der von einer nativen Threadpoolimplementierung unterstützt wird.
V8Maglev Aktiviert den Maglev-Compiler. Dadurch wird das V8-Flag nur beim manuellen Überschreiben festgelegt. Andernfalls wird auf den V8-Standardwert zurückgesetzt.

Siehe auch