Partager via

Indicateurs de navigateur WebView2

  • Article

L’une des façons d’interagir avec Microsoft Edge WebView2 et d’avoir un impact sur le comportement consiste à passer des indicateurs de navigateur (arguments ou commutateurs) à WebView2. Ces indicateurs de navigateur sont utiles pour tester les fonctionnalités à venir et pour diagnostiquer les problèmes.

Avertissement

Les applications en production ne doivent pas utiliser les indicateurs de navigateur WebView2, car ces indicateurs peuvent être supprimés ou modifiés à tout moment et ne sont pas nécessairement pris en charge à long terme.

En règle générale, les indicateurs appartiennent à Chromium et à Microsoft Edge. Chromium indicateurs ne sont pas détenus ou contrôlés par Microsoft Edge, de sorte que Microsoft Edge n’a pas de contrôle sur le moment ou la façon dont les indicateurs sont supprimés ou modifiés dans leur comportement.

Vous pouvez définir des indicateurs de navigateur dans votre environnement d’appareil local ou définir des indicateurs de navigateur par programmation via du code. Les deux approches sont décrites ci-dessous.

Définition des indicateurs de navigateur dans votre environnement d’appareil local

Pour tester les fonctionnalités à venir ou diagnostiquer les problèmes, nous vous recommandons d’utiliser des indicateurs de navigateur dans votre environnement d’appareil local, en définissant la WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS variable d’environnement ou via des clés de Registre. Pour plus d’informations, consultez les informations de référence sur l’API Win32 suivantes : CreateCoreWebView2EnvironmentWithOptions.

Définition des indicateurs de navigateur par programmation par le biais du code

Au lieu de définir des indicateurs de navigateur dans votre environnement d’appareil local, une autre approche consiste à définir des indicateurs de navigateur par programme, en transmettant les indicateurs de navigateur comme AdditionalBrowserArguments propriété de CoreWebView2EnvironmentOptions. Si vous définissez des indicateurs de navigateur par programme, veillez à supprimer les indicateurs dans le code avant d’envoyer votre application, afin d’éviter d’envoyer accidentellement les indicateurs en production.

Indicateurs de navigateur WebView2 disponibles

Voici quelques-uns des indicateurs que nous avons vus utilisés.

Flag Description
accept-lang Spécifie Accept-Language d’envoyer aux serveurs et d’exposer à JavaScript via la propriété DOM Navigator.language . Le format est language[-country], où language est le code à 2 lettres de la norme ISO-639.
allow-file-access-from-files Autorise la lecture file:// des URI à partir d’autres file:// URI.
allow-insecure-localhost Permet d’ignorer les erreurs TLS/SSL sur localhost, de sorte qu’aucune opération d’interaction n’est effectuée et qu’aucun blocage des requêtes n’est effectué.
allow-run-as-system Par défaut, le navigateur Edge WebView se ferme s’il est lancé en tant que Système (le lancement en tant que système n’est pas recommandé). Cet indicateur ignore cette case activée, de sorte que même si le navigateur Edge WebView est lancé en tant que système, le navigateur Edge WebView ne se ferme pas.
allow-running-insecure-content Active le contenu non sécurisé dans Cast Web Runtime. Cet indicateur débloque les msp qui servent du contenu à partir de sources HTTP.
auto-open-devtools-for-tabs Permet à Edge WebView d’ouvrir automatiquement la fenêtre DevTools pour chaque onglet. Pour une utilisation par les développeurs et par l’automatisation.
AutofillReplaceCachedWebElementsByRendererIds Si cette option est activée, remplace les éléments web mis en cache dans AutofillAgent et FormTracker par leurs ID de convertisseur.
autoplay-policy Nom de l’indicateur de ligne de commande pour définir la stratégie de lecture automatique.
BlockInsecurePrivateNetworkRequests Lorsque cette fonctionnalité est activée, les demandes de réseau privé lancées à partir de contextes non sécurisés dans l’espace d’adressage public sont bloquées.
block-new-web-contents Si truela valeur est , toutes les fenêtres contextuelles et les appels échouent window.open .
BreakoutBoxPreferCaptureTimestampInVideoFrames Rétablit le comportement de la Timestamp propriété de la CoreWebView2Texture classe pour qu’il corresponde au comportement hérité de WebView2 Runtime version 124 et antérieure.
disable-background-timer-throttling Désactive la limitation des tâches du minuteur à partir des pages d’arrière-plan.
disable-domain-action-user-agent-override Désactive le remplacement de l’agent utilisateur par domaine à partir de la fonctionnalité Actions de domaine.
disable-gpu Désactive l’accélération matérielle GPU. Si aucun convertisseur logiciel n’est en place, le processus GPU ne se lance pas.
disable-gpu-driver-bug-workarounds Désactive les solutions de contournement pour différents bogues de pilote GPU.
disable-site-isolation-trials Désactive l’isolation du site.
disable-web-security Désactive la stratégie cross-origin et n’applique pas la stratégie de même origine. Utilisez uniquement pour les tests de site web.
disk-cache-size Force l’espace disque maximal à utiliser par le cache du disque, en octets.
do-not-de-elevate Empêche la déélévation du WebView2 au lancement. Utilisé après la suppression de l’élévation, pour empêcher les boucles infinies.
edge-webview-debugging-script Exécute le PostWebMessage script de façon asynchrone.
edge-webview-enable-mojo-ipcz Active MojoIpcz (mojo-ipcz) pour les applications qui utilisent WebView2.
edge-webview-foreground-boost-opt-in Optez pour l’amélioration au premier plan.
edge-webview-foreground-boost-opt-out Optez pour l’activation au premier plan.
edge-webview-force-personal-context Force les processus du navigateur Edge WebView à s’exécuter dans le contexte personnel WIP.
edge-webview-interactive-dragging Permet aux événements de pointeur et aux événements de focus de se produire sur les éléments qui ont l’attribut --app-region: drag . Les éléments de glissement sont interactifs par défaut.
edge-webview-disable-interactive-dragging Désactive les événements de pointeur et les événements de focus sur les éléments qui ont l’attribut --app-region: drag . Si cet indicateur n’est pas défini, les éléments glisser sont interactifs par défaut.
edge-webview-is-background Indique que WebView est lancé en arrière-plan.
edge-webview-no-dpi-workaround Désactive la solution de contournement « Shim de compatibilité des applications de reconnaissance de la résolution », qui lance le processus de navigateur Edge WebView via un interpréteur de commandes, afin que le processus n’hérite pas du shim « app compat ».
edge-webview-run-with-package-id Exécute les processus WebView avec une identité de package (ID de package) pour une application de bureau avec pont.
edge-webview-run-without-package-id Exécute des processus WebView sans identité de package (ID de package) pour une application de bureau avec pont.
embedded-browser-webview-dpi-awareness Définit le niveau de sensibilisation ppp des processus côté serveur.
enable-experimental-web-platform-features Active les fonctionnalités de plateforme web en cours de développement.
enable-logging Activez la journalisation au niveau de l’erreur.
force-color-profile Forcer tous les moniteurs à être traités comme s’ils ont le profil de couleur spécifié. Valeurs valides : srgb, generic-rgb.
force-device-scale-factor Remplace le facteur de mise à l’échelle de l’appareil pour l’interface utilisateur du navigateur Edge WebView et le contenu.
force-fieldtrials Peut être utilisé pour forcer les essais sur le terrain lors du test local des modifications. L’argument est une liste de paires nom/valeur, séparées par des barres obliques. Si un nom d’essai est précédé d’un astérisque, cet essai commence à être activé. Par exemple, l’argument suivant définit deux essais, avec le deuxième activé : EdgeNow/Enable/*MaterialDesignNTP/Default/. Cette option peut également être utilisée par le processus du navigateur pour envoyer la liste des essais à un processus non-navigateur, en utilisant le même format.
force-fieldtrial-params Peut être utilisé pour forcer les paramètres des essais sur le terrain lors du test local des modifications. L’argument est une liste de paramètres de paires (clé, valeur), précédée d’une paire associée (essai, groupe). Pour plusieurs paires (essai, groupe), utilisez un séparateur de virgules.
force-renderer-accessibility Indique s’il faut forcer l’accessibilité du renderer à être activée, au lieu d’activer l’accessibilité du renderer à la demande lorsqu’un lecteur d’écran est détecté. L’indicateur disable-renderer-accessibility remplace cet indicateur, s’il disable-renderer-accessibility est présent.
HardwareMediaKeyHandling Active la gestion des clés multimédias matérielles pour le contrôle des médias.
ignore-certificate-errors Ignore les erreurs liées au certificat.
ignore-gpu-blocklist Indique s’il faut ignorer la liste de blocage gpu.
incognito Force le mode incognito même si le répertoire de données utilisateur est spécifié à l’aide de l’indicateur --user-data-dir .
isolate-origins Exiger des processus dédiés pour un ensemble d’origines, spécifiées sous la forme d’une liste séparée par des virgules. Par exemple : --isolate-origins=https://www.foo.com,https://www.bar.com.
js-flags Spécifie les indicateurs passés au moteur JS.
lang Fichier de langue que WebView2 souhaite essayer d’ouvrir. De la forme language[-country] où language est le code à 2 lettres de la norme ISO-639.
log-net-log Permet d’enregistrer des événements de journal net dans un fichier. Si une valeur est donnée, cette valeur est utilisée comme chemin d’accès au répertoire et comme nom de fichier. Si aucune valeur n’est donnée, le fichier est nommé netlog.jsonet est placé dans le répertoire de données utilisateur.
msAbydos Active l’expérience « écriture manuscrite en texte ».
msAbydosGestureSupport Permet aux utilisateurs d’utiliser des mouvements (tels que le mouvement de suppression) pour supprimer du texte à l’aide d’un stylet. Valide uniquement si l’indicateur msAbydos est activé.
msAbydosHandwritingAttr Indique si l’expérience « écriture manuscrite en texte » est activée pour les éléments d’entrée au niveau DOM. Valide uniquement si l’indicateur msAbydos est activé.
msEdgeDesignerUI Utilisez cet indicateur pour désactiver l’application Designer Shoreline. Cette fonctionnalité n’est pas prise en charge dans WebView2.
msEdgeHubAppDesigner Utilisez cet indicateur pour désactiver l’application Designer Shoreline. Cette fonctionnalité n’est pas prise en charge dans WebView2.
msEdgeDesignerDriverFix Utilisez cet indicateur pour désactiver l’obtention de contenu et l’affichage automatique de la fonctionnalité Designer. Cette fonctionnalité n’est pas prise en charge dans WebView2.
msEdgeFluentOverlayScrollbar Force l’activation des barres de défilement de superposition Fluent, en remplaçant toute valeur kFluentScrollbar pouvant contenir pour le moment.
msEdgeDevToolsWdpRemoteDebugging Active le débogage à distance. Consultez Débogage à distance des applications WebView2 WinUI 2 (UWP),Déboguer à distance des appareils Windows.
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs Si cet indicateur est activé, la AddWebResourceRequestedFilter méthode (y compris les surcharges) s’applique également aux iframes hors processus.
.NET : AddWebResourceRequestedFilter
WinRT : AddWebResourceRequestedFilter
Win32 : AddWebResourceRequestedFilterWithRequestSourceKinds
msEnhancedTextContrast Améliore l’amélioration du contraste du texte et la correction gamma pour correspondre à la qualité et à la clarté d’autres applications Windows natives. Lorsque cet indicateur est utilisé, le rendu des polices respecte les paramètres de l’utilisateur ClearType Tuner lors de l’application de l’amélioration du contraste du texte et de la correction gamma.
msEnhancedTrackingPreventionEnabled Active les fonctionnalités natives de protection de la confidentialité, telles que le blocage des cookies et des requêtes web qui résident dans des domaines connus pour être des domaines de suivi.
msFloatyMode Si falsela valeur est , désactive la fonctionnalité Floaty. Utilisez cet indicateur pour désactiver la fonctionnalité Floaty, car WebView ne prend pas en charge les expériences de rétention de navigateur.
msFloatyShouldHonorIndiaHoldout Si truela valeur est , honore le groupe d’attente Inde. Utilisez cet indicateur, défini sur false, pour désactiver la fonctionnalité Floaty activée si l’utilisateur fait partie du groupe d’attente Inde, car WebView ne prend pas en charge les expériences de rétention de navigateur.
msOverlayScrollbarWinStyle Indique si les utilisateurs peuvent basculer entre les modes de superposition et non-superposition pour les barres de défilement Fluent.
msPdfEnableAsPreview Cette fonctionnalité permet à la visionneuse PDF de se lancer avec une barre d’outils minimale et en mode d’aperçu en lecture seule.
msSingleSignOnOSForPrimaryAccountIsShared Si cette option est activée, autorise la connexion implicite aux pages web Microsoft à l’aide de n’importe quel compte, en utilisant les informations du compte de système d’exploitation principal.
msSmartScreenProtection Si elle est activée, la protection SmartScreen est disponible.
msUseSpellCheckCorrectionsCard Si cette option est activée, une nouvelle correction carte’interface utilisateur s’affiche lorsque l’utilisateur clique sur un mot mal orthographié.
msWebView2CancelInitialNavigation Si cette option est activée, annule la navigation initiale dans WebView2 pour améliorer les performances de démarrage.
msWebView2CodeCache Si cette option est activée, les ressources JavaScript chargées dans une application WebView2 via SetVirtualHostNameToFolderMapping ou add_WebResourceRequested sont éligibles pour la mise en cache de bytecode, ce qui devrait accélérer le troisième chargement et les chargements suivants. Cette fonctionnalité permet également la mise en cache des bytecodes pour tous les autres composants qui utilisent le mécanisme d’interception réseau DevTools pour fournir des réponses personnalisées (voir Gestion personnalisée des demandes réseau).
msWebView2EnableDownloadContentInWebResourceResponseReceived Si cette option est activée, autorisez les réponses des navigations qui deviennent des téléchargements à être disponibles dans WebResourceResponseReceived
msWebView2TextureStream Si cette option est activée, permet de diffuser en continu des images vidéo capturées ou composées vers WebView2, où JavaScript peut afficher ou interagir avec les images via les API DOM W3C standard, y compris l’élément Video et MediaStream.
msWebView2EnableDraggableRegions Si truela valeur est , permet aux pages web dans WebView2 d’utiliser le style CSS, ce qui entraîne le app-region: drag\|nodrag comportement des éléments avec ce style comme une barre de titre. Sans cet indicateur, le app-region: drag\|nodrag style CSS n’a aucun effet.
msWebView2CodeCache Si cette option est activée, les ressources JavaScript chargées dans une application WebView2 via SetVirtualHostNameToFolderMapping ou add_WebResourceRequested sont éligibles pour la mise en cache de bytecode, ce qui devrait accélérer le troisième chargement et les chargements suivants. Cette fonctionnalité permet également la mise en cache des bytecodes pour tous les autres composants qui utilisent le mécanisme d’interception réseau DevTools pour fournir des réponses personnalisées.
msWebView2NativeEventDispatch Si cette option est activée, utilise une connexion mojo native pour distribuer des événements internes, tels que des messages web vers un processus de renderer.
msWebView2SimulateMemoryPressureWhenInactive Si cette option est activée, simule la sollicitation de la mémoire pour un WebView inactif.
msWebView2TreatAppSuspendAsDeviceSuspend Si cette option est activée, lorsque tous les webviews sont suspendus, WebView2 traite l’application comme si l’appareil était suspendu et suspend toutes les tâches et minuteurs retardés.
no-proxy-server Remplace tous les autres indicateurs de serveur proxy qui sont passés.
net-log-capture-mode Définit la granularité des événements à capturer dans le journal réseau. Valeurs valides : Default, IncludeSensitive, Everything.
no-network-profile-warning Si cette option est activée, le navigateur avertit si la fonction définie par l’utilisateur se trouve sur un partage réseau. Cet indicateur est uniquement pris en charge sur Windows ; cet indicateur est ignoré sur d’autres plateformes.
no-sandbox Désactive le bac à sable pour tous les types de processus normalement en bac à sable. Destiné à être utilisé comme indicateur au niveau du navigateur à des fins de test uniquement.
no-first-run Ignore First-Run tâches, qu’il s’agisse de la première exécution ou non, et ignore l’affichage de la page Nouveautés. Cet indicateur est remplacé par kForceFirstRun (pour l’expérience First-Run )) et par kForceWhatsNew (pour afficher les nouveautés). Cet indicateur ne supprime pas la sentinelle de première exécution et n’empêche donc pas l’expérience First-Run de se produire la prochaine fois que le navigateur Edge WebView est lancé sans cet indicateur. Cet indicateur ne met pas à jour le dernier jalon Nouveautés. Il n’empêche donc pas l’affichage des nouveautés lors du prochain lancement du navigateur Edge WebView sans cet indicateur.
PartitionedCookies Lorsqu’il est activé, les sites peuvent choisir de partitionner leurs cookies par le site de niveau supérieur à l’aide de l’attribut Partitioned . Les cookies partitionnés ne sont envoyés que lorsque le navigateur se trouve sur le même site de niveau supérieur que celui sur lequel le cookie a été défini.
proxy-auto-detect Force la détection automatique du proxy.
proxy-bypass-list Liste des hôtes pour lesquels les paramètres de proxy sont ignorés ; les hôtes spécifiés utilisent ensuite des connexions directes à la place. Cet indicateur est ignoré, sauf si --proxy-server est également spécifié. Plusieurs hôtes peuvent être fournis sous la forme d’une liste séparée par des virgules.
proxy-server Un serveur proxy qui remplace les paramètres système. Cet indicateur affecte uniquement les requêtes HTTP et HTTPS.
remote-allow-origins Active uniquement les connexions de socket web à partir des origines spécifiées. Le * caractère générique autorise n’importe quelle origine.
remote-debugging-port Active le débogage à distance via HTTP sur le port spécifié.
RendererAppContainer Active renderer AppContainer.
Restart Indique que le processus du navigateur Microsoft Edge WebView2 a été redémarré (par exemple, après un changement d’indicateur). Utilisez cet indicateur pour ignorer le lancement lors de l’enregistrement de la Launch.Mode2 métrique.
sdsm-state État « Mode sécurisé Super Duper ». Valeurs valides : off, basic, balanced, strict.
SharedArrayBuffer Si cette option est activée, indique qu’un SharedArrayBuffer thread est présent.
SpareRendererForSitePerProcess Si cet indicateur est activé, le processus de renderer de rechange Edge Webview tente de toujours avoir un processus de renderer de secours à chaud en cours d’exécution pour le dernier demandé BrowserContext. Cette fonctionnalité est uniquement consultée en mode site par processus.
ThirdPartyStoragePartitioning Permet le partitionnement du stockage tiers, tel que IndexedDB ou CacheStorage, par le site de niveau supérieur, pour réduire l’empreinte digitale.
unsafely-treat-insecure-origin-as-secure Traite les origines données (non sécurisées) comme des origines sécurisées. Plusieurs origines peuvent être spécifiées, sous la forme d’une liste séparée par des virgules. Pour la définition des contextes sécurisés, consultez Contextes sécurisés, y compris la section Est-il origin potentiellement digne de confiance ?. Exemple : --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test
use-fake-device-for-media-stream Utilise un appareil factice pour Media Stream pour remplacer une caméra et un microphone réels.
use-fake-ui-for-media-stream Contourne la barre d’informations du flux multimédia en sélectionnant l’appareil par défaut pour les flux multimédias (par exemple, WebRTC). Fonctionne avec --use-fake-device-for-media-stream. Préférez utiliser à la --auto-accept-camera-and-microphone-capture place, qui n’interagit pas avec la capture d’écran, comme la capture d’un onglet de navigateur.
use-system-proxy-resolver Utilise WinHttp pour résoudre les proxys au lieu d’utiliser la logique de résolution de proxy normale de WebView2. Cet indicateur est uniquement pris en charge dans Windows.
user-agent Chaîne utilisée pour remplacer l’agent utilisateur par défaut par un agent utilisateur personnalisé.
user-data-migrated Indique que ce processus est le produit d’une relance après la migration des données utilisateur.
UseBackgroundNativeThreadPool Si cette option est activée, WebView2 ThreadPoolImpl utilise un ThreadGroup en arrière-plan soutenu par une implémentation de pool de threads natif.
UseNativeThreadPool Si cette option est activée, WebView2 ThreadPoolImpl utilise un premier plan ThreadGroup soutenu par une implémentation de pool de threads natif.
V8Maglev Active le compilateur Maglev. Cela définit uniquement l’indicateur V8 en cas de substitution manuelle . dans le cas contraire, elle s’en remet à la valeur par défaut de la V8.

Voir aussi