Marcas del explorador WebView2

Una de las maneras en que puede interactuar con Microsoft Edge WebView2 e influir en el comportamiento es pasar marcas del explorador (argumentos o modificadores) a WebView2. Estas marcas del explorador son útiles para probar características futuras y para diagnosticar problemas.

En el caso de las aplicaciones de producción, no use estas marcas. Durante el desarrollo, si la marca está presente, se produce el comportamiento que se especifica a continuación.

Advertencia

Las aplicaciones en producción no deben usar marcas del explorador WebView2, ya que estas marcas pueden quitarse o modificarse en cualquier momento y no son necesariamente compatibles a largo plazo.

Por lo general, las marcas son propiedad tanto de Chromium como de Microsoft Edge. Microsoft Edge no posee ni controla las marcas de Chromium, por lo que Microsoft Edge no tiene control sobre cuándo o cómo se quitan o modifican en su comportamiento.

Puede establecer las marcas del explorador en el entorno del dispositivo local o establecerlas mediante programación mediante código. Ambos enfoques se describen a continuación.

Configuración de marcas del explorador en el entorno del dispositivo local

Para probar las próximas funciones o diagnosticar problemas, recomendamos usar marcas del explorador en el entorno del dispositivo local, mediante la configuración de la variable de entorno o mediante las WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS claves del registro. Para obtener más información, consulte la siguiente referencia de API de Win32: CreateCoreWebView2EnvironmentWithOptions.

Las aplicaciones con privilegios elevados ignoran las banderas que se establecen a través del entorno del dispositivo local; Consulte Para una aplicación de host con privilegios elevados, use las marcas de invalidación adecuadas en Desarrollar aplicaciones WebView2 seguras.

Configuración de las marcas del explorador mediante programación mediante código

En lugar de establecer indicadores del explorador en el entorno del dispositivo local, un enfoque alternativo es establecer los indicadores del explorador mediante programación, pasando los indicadores del explorador como propiedad AdditionalBrowserArguments de CoreWebView2EnvironmentOptions. Si estableces las marcas del explorador mediante programación, asegúrate de quitar las marcas en el código antes de enviar la aplicación, para evitar enviar accidentalmente las marcas en producción.

Las aplicaciones elevadas respetan las banderas que se establecen mediante código; Consulte Para una aplicación de host con privilegios elevados, use las marcas de invalidación adecuadas en Desarrollar aplicaciones WebView2 seguras.

Marcas de explorador WebView2 disponibles

Las siguientes marcas del explorador WebView2 están disponibles para su uso durante el desarrollo.

En el caso de las aplicaciones de producción, no use estas marcas. Durante el desarrollo, si la marca está presente, se produce el comportamiento que se especifica a continuación.

Flag Description
accept-lang Especifica Accept-Language que se enviará a servidores y se expondrá a JavaScript a través de la propiedad DOM Navigator.language . El formato es language[-country], donde language es el código de 2 letras de ISO-639.
allow-file-access-from-files Permite leer file:// URI de otros file:// URI.
allow-insecure-localhost Permite ignorar los errores de TLS/SSL en localhost, de modo que no se realice ningún intersticial y ningún bloqueo de solicitudes.
allow-run-as-system De forma predeterminada, el explorador Edge WebView se cierra si se inicia como Sistema (no se recomienda iniciarlo como Sistema). Esta marca omite esa comprobación, de modo que incluso si el explorador Edge WebView se inicia como Sistema, el explorador Edge WebView no se cierra.
allow-running-insecure-content Habilita el contenido no seguro en el tiempo de ejecución de transmisión web. Esta marca desbloquea los MSP que sirven contenido de orígenes HTTP.
auto-open-devtools-for-tabs Hace que Edge WebView abra automáticamente la ventana de DevTools para cada pestaña. Para uso de desarrolladores y automatización.
AutofillReplaceCachedWebElementsByRendererIds Reemplaza los elementos web almacenados en caché en AutofillAgent y FormTracker por sus identificadores de representador.
autoplay-policy Nombre del marcador de la línea de comandos para establecer la directiva de reproducción automática.
BlockInsecurePrivateNetworkRequests Cuando esta característica está habilitada, se bloquean las solicitudes de red privada que se inician desde contextos no seguros en el public espacio de direcciones.
block-new-web-contents Toma un valor o truefalse . Si true, hace que todas las ventanas emergentes y llamadas window.open fallen. Si false, las ventanas emergentes y las llamadas a window.open son respetadas.
BreakoutBoxPreferCaptureTimestampInVideoFrames Revierte el comportamiento de la Timestamp propiedad de la clase para que coincida con el comportamiento heredado de WebView2 CoreWebView2Texture Runtime versión 124 y anteriores.
disable-background-timer-throttling Deshabilita la limitación de tareas de las tareas de temporizador de las páginas en segundo plano.
disable-domain-action-user-agent-override Deshabilita la invalidación del agente de usuario por dominio de la característica Acciones de dominio.
disable-gpu Deshabilita la aceleración de hardware de la GPU. Si no hay un representador de software en su lugar, el proceso de GPU no se inicia.
disable-gpu-driver-bug-workarounds Deshabilita las soluciones alternativas para varios errores del controlador de GPU.
disable-site-isolation-trials Deshabilita el aislamiento de sitio.
disable-web-security Deshabilita la directiva entre orígenes y no aplica la directiva del mismo origen. Úsalo solo para pruebas de sitios web.
disk-cache-size Fuerza el espacio en disco máximo que utilizará la caché de disco, en bytes.
do-not-de-elevate Impide la deselevación de WebView2 en el inicio. Se usa después de la deselevación, para evitar bucles infinitos.
edge-webview-debugging-script Ejecuta el PostWebMessage script de forma asincrónica.
edge-webview-disable-interactive-dragging Deshabilita los eventos de puntero y foco para que no se produzcan en los elementos que tienen el --app-region: drag atributo. Si no se establece esta marca, los elementos de arrastre son interactivos de forma predeterminada.
edge-webview-enable-mojo-ipcz Habilita MojoIpcz (mojo-ipcz) para las aplicaciones que usan WebView2.
edge-webview-force-personal-context Fuerza los procesos del explorador Edge WebView para que se ejecuten en el contexto personal de WIP.
edge-webview-foreground-boost-opt-in Opta por el impulso en primer plano.
edge-webview-foreground-boost-opt-out Opta por no participar en el impulso de primer plano.
edge-webview-interactive-dragging Permite que los eventos de puntero y de foco se produzcan en los elementos que tienen el --app-region: drag atributo. Los elementos de arrastre son interactivos de forma predeterminada.
edge-webview-is-background Indica que WebView se está iniciando en segundo plano.
edge-webview-no-dpi-workaround Deshabilita la solución alternativa "compatibilidad de aplicaciones con reconocimiento de PPP", que inicia el proceso del explorador Edge WebView a través de un shell, para que el proceso no herede las correcciones de compatibilidad de "compatibilidad con aplicaciones".
edge-webview-run-with-package-id Ejecuta procesos WebView con una identidad de paquete (id. de paquete) para una aplicación de escritorio puenteada.
edge-webview-run-without-package-id Ejecuta procesos WebView sin una identidad de paquete (id. de paquete) para una aplicación de escritorio puenteada.
edge-webview-unique-window-class Hace que WebView2 registre clases de ventana específicas del módulo anexando automáticamente un sufijo derivado del nombre de archivo del módulo de cliente, sin detalles de ruta de acceso o extensión. Por ejemplo, para el nombre EmbeddedBrowserWebView.dllde archivo , se anexa un sufijo de EmbeddedBrowserWebView a Chrome_WidgetWin_0, formando Chrome_WidgetWin_0_EmbeddedBrowserWebView. Habilite esta marca para evitar un bloqueo que se puede producir cuando diferentes versiones de WebView2 y Chromium Embedded Framework (CEF) coexisten en el mismo proceso e intentan interactuar con ventanas que comparten la misma clase.
embedded-browser-webview-dpi-awareness Establece el nivel de reconocimiento de PPP de los procesos del lado servidor.
enable-aggressive-domstorage-flushing Permite el vaciado agresivo del almacenamiento DOM para minimizar la pérdida de datos.
enable-blink-features enable-blink-features=DragAndDropJSFileObjectshabilita arrastrar objetos construidos File con JavaScript desde el control WebView2 a aplicaciones nativas de Windows y a otras aplicaciones basadas en el motor del explorador Chromium. Actualmente limitado a los tipos MIME de imagen. Sin esta marca, los bytes de archivo se descartan y solo el nombre de archivo se entrega como texto sin formato. Los Files que se entregan a través de esta ruta no reciben ninguna Mark de las marcas Web.
enable-experimental-web-platform-features Habilita las características de la plataforma web que están en desarrollo.
enable-logging Habilite el registro en el nivel de error.
force-color-profile Forzar el tratamiento de todos los monitores como si tuvieran el perfil de color especificado. Valores válidos: srgb, generic-rgb.
force-device-scale-factor Reemplaza el factor de escala del dispositivo para la interfaz de usuario del explorador Edge WebView y el contenido.
force-fieldtrials Se puede usar para forzar pruebas de campo al probar cambios localmente. El argumento es una lista de pares nombre-valor, separados por barras diagonales. Si un nombre de prueba tiene el prefijo de un asterisco, esa prueba comenzará a activarse. Ejemplo: El siguiente argumento define dos ensayos, con el segundo activado: EdgeNow/Enable/*MaterialDesignNTP/Default/. Esta opción también puede ser usada por el proceso del navegador para enviar la lista de pruebas a un proceso que no es del navegador, utilizando el mismo formato.
force-fieldtrial-params Se puede utilizar para forzar parámetros de pruebas de campo al probar cambios localmente. El argumento es una lista de parámetros de pares (clave, valor), prefijados por un par asociado (prueba, grupo). Para varios pares (prueba, grupo), use un separador de comas.
force-renderer-accessibility Si se debe forzar la accesibilidad del representador para que esté activada, en lugar de habilitar la accesibilidad del representador a petición cuando se detecta un lector de pantalla. La disable-renderer-accessibility marca invalida esta marca, si está disable-renderer-accessibility presente.
HardwareMediaKeyHandling Habilita la gestión de las claves multimedia de hardware para controlar los medios.
ignore-certificate-errors Omite los errores relacionados con los certificados.
ignore-gpu-blocklist Si se omite la lista de bloqueo de la GPU.
incognito Fuerza el modo InPrivate (incógnito) incluso si el directorio de datos de usuario se especifica mediante la --user-data-dir marca.
isolate-origins Requieren procesos dedicados para un conjunto de orígenes, especificados como una lista separada por comas. Ejemplo: --isolate-origins=https://www.foo.com,https://www.bar.com.
js-flags Especifica las marcas pasadas al motor JS. Indicadores disponibles: scavenger_max_new_space_capacity_mb: especifica el límite máximo (en MB) para los recolectores de basura (menores) en el motor V8 de JavaScript.
Un límite de memoria de barrido inferior reduce el uso de memoria y aumenta la frecuencia con la que se ejecutan recolectores de elementos no utilizados menores.
Un límite de memoria de barrido más alto aumenta el uso de memoria y reduce la frecuencia con la que se ejecutan recolectores de elementos no utilizados menores. Ejemplo: --js-flags=--scavenger_max_new_space_capacity_mb=8.
lang El archivo de idioma que WebView2 desea intentar abrir. De la forma language[-country] donde el lenguaje es el código de 2 letras de ISO-639.
log-net-log Habilita guardar eventos de registro de red en un archivo. Si se proporciona un valor, ese valor se usa como ruta de acceso al directorio y nombre de archivo. Si no se proporciona ningún valor, el archivo se denomina netlog.jsony se coloca en el directorio de datos de usuario.
long-animation-frame-timing Proporciona intervalos detallados para fotogramas de animación largos, que son fotogramas que superan la duración estándar de 16,67 ms (60 fps). Esto ayuda durante la depuración y el análisis de rendimiento, a identificar y optimizar los cuellos de botella de rendimiento para las aplicaciones con mucho uso intensivo de animación.
msAbydos Habilita la experiencia "escritura a mano a texto".
msAbydosGestureSupport Permite a los usuarios usar gestos (como el gesto de tachado) para eliminar texto con un lápiz. Válido solo si la msAbydos marca está habilitada.
msAbydosHandwritingAttr Si la experiencia de "escritura a mano" está habilitada para los elementos de entrada en el nivel de DOM. Válido solo si la msAbydos marca está habilitada.
msAbydosForWindowlessWV2 Habilita la funcionalidad ShellHandwriting (Windows Shell Handwriting) en el modo de hospedaje de Windows a visual. Válido solo si la msAbydos marca está habilitada. Vea también Hospedaje en ventanas frente a visual de WebView2.
msAllowAmbientAuthInPrivateWebView2 Esta marca se usará junto con la marca del explorador para habilitar el inicio de sesión único (SSO) con el flujo de credenciales predeterminado o el msSingleSignOnForInPrivateWebView2 flujo de autenticación del entorno.
msEdgeDesignerDriverFix Habilita obtener contenido y mostrar automáticamente la característica de Designer. La característica Designer no es compatible con WebView2.
msEdgeDesignerUI Habilita la aplicación Designer Shoreline. La aplicación Designer Shoreline no es compatible con WebView2.
msEdgeDevToolsWdpRemoteDebugging Habilita la depuración remota. Consulte Depuración remota de aplicaciones WebView2 WinUI 2 (UWP),Depuración remota de dispositivos Windows.
msEdgeFluentOverlayScrollbar Habilita forzosamente las barras de desplazamiento de Fluent Overlay, invalidando cualquier valor kFluentScrollbar que pueda contener en ese momento.
msEdgeHubAppDesigner Habilita la aplicación Designer Shoreline. La aplicación Designer Shoreline no es compatible con WebView2.
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs Hace que el método (incluidas las AddWebResourceRequestedFilter sobrecargas) también se aplique a iframes fuera de proceso.
.NET: AddWebResourceRequestedFilter
WinRT: AddWebResourceRequestedFilter
Win32: AddWebResourceRequestedFilterWithRequestSourceTypes
msEnhancedTextContrast Mejora la mejora del contraste del texto y la corrección gamma para que coincida con la calidad y claridad de otras aplicaciones nativas de Windows. Cuando se usa esta marca, la representación de fuentes respeta la configuración del sintonizador ClearType del usuario al aplicar la mejora del contraste del texto y la corrección gamma.
msEnhancedTrackingPreventionEnabled Habilita las características nativas de protección de la privacidad, como el bloqueo de cookies y solicitudes web que residen en dominios que se sabe que son de seguimiento de dominios.
msFloatyMode Toma un valor o truefalse . Si true, habilita la característica flotante. Si false, deshabilita la característica flotante. Use esta marca para deshabilitar la característica Floaty, ya que WebView no admite experimentos de retención del explorador.
msFloatyShouldHonorIndiaHoldout Toma un valor o truefalse . Si true, honra al grupo de resistencia de la India. Si false, deshabilita la característica Floaty que está habilitada si el usuario forma parte del grupo de exclusión de India, porque WebView no admite experimentos de retención del explorador.
msOverlayScrollbarWinStyle Si los usuarios pueden cambiar entre los modos de superposición y sin superposición para las barras de desplazamiento de Fluent.
msPageInteractionManagerWebview2 De forma predeterminada, la API del Administrador de restricción de interacción de página está deshabilitada para WebView2. Si una aplicación necesita habilitar la configuración de esta API en WebView2, la aplicación debe habilitar esta marca.
msPdfEnableAsPreview Esta característica permite que el visor de PDF se inicie con una barra de herramientas mínima y en modo de vista previa de solo lectura.
msSingleSignOnForInPrivateWebView2 Esta marca habilita el flujo de inicio de sesión único (SSO) para las sesiones de InPrivate (incógnito) de WebView2. Habilita el SSO basado en el navegador en modo InPrivate (incógnito).
msSingleSignOnOSForPrimaryAccountIsShared Permite el inicio de sesión implícito en páginas web de Microsoft con cualquier cuenta, mediante la información de la cuenta principal del sistema operativo.
msSmartScreenProtection Hace que la protección de SmartScreen esté disponible.
msUseSpellCheckCorrectionsCard Hace que se muestre una interfaz de usuario de tarjeta de correcciones cuando el usuario hace clic en una palabra mal escrita.
msWebViewAllowLocalNetworkAccessChecks Habilita las comprobaciones de seguridad de acceso a la red local que restringen el contenido web de orígenes públicos para que no acceda a los recursos de red locales y de bucle invertido, a menos que se permita explícitamente. Deshabilitado de manera predeterminada; debe estar habilitado por la aplicación para configurar el comportamiento de acceso a la red local en WebView2.
Nota: Esta marca de característica se aplicará hasta que las API estén completamente incorporadas y su adopción alcance un estado estable, después de lo cual esta marca quedará en desuso.
msWebView2BrowserHitTransparent Hace que los eventos de mouse y teclado pasen a través del control WebView2 a la aplicación subyacente para permitir que la aplicación controle estos eventos en lugar de que el control WebView2 controle los eventos. Cuando esta marca no está habilitada, el control WebView2 controla los eventos del mouse y del teclado; Los eventos no pasan a la aplicación subyacente. Esta marca permite probar cómo se comporta la aplicación cuando el control WebView2 no intercepta los eventos de entrada, para escenarios en los que la aplicación necesita controlar los eventos de entrada directamente. Esta marca no toma ningún valor. Esta marca puede hacer que la aplicación se bloquee o se bloquee.
msWebView2CancelInitialNavigation Cancela la navegación inicial en WebView2 para mejorar el rendimiento de inicio.
msWebView2CodeCache Hace que los recursos de JavaScript que se cargan en una aplicación WebView2 a través del SetVirtualHostNameToFolderMapping almacenamiento en caché de código de bytes o add_WebResourceRequested sean aptos para ello, lo que debería acelerar la tercera carga y las siguientes. Esta característica también habilita el almacenamiento en caché de código de bytes para cualquier otro componente que use el mecanismo de interceptación de red de DevTools para proporcionar respuestas personalizadas; consulte Gestión personalizada de solicitudes de red.
msWebView2EnableDownloadContentInWebResourceResponseReceived Permite que las respuestas de las navegaciones que se convierten en descargas estén disponibles en WebResourceResponseReceived.
msWebView2EnableDraggableRegions Toma un valor o truefalse . Si true, las páginas web en WebView2 usan el estilo CSS, que hace que los app-region: drag\|nodrag elementos con ese estilo se comporten como una barra de título. Si false, o sin esta marca, el app-region: drag\|nodrag estilo CSS no tiene ningún efecto.
msWebView2NativeEventDispatch Usa una conexión de mojo nativa para distribuir eventos internos, como mensajes web, a un proceso de representación.
msWebView2SimulateMemoryPressureWhenInactive Simula la presión de memoria para un WebView inactivo.
msWebView2TextureStream Permite transmitir fotogramas de vídeo capturados o compuestos al control WebView2, donde JavaScript puede representar o interactuar de otro modo con los fotogramas a través de las API DOM estándar de W3C, incluido el elemento Video Embed y MediaStream.
msWebView2TreatAppSuspendAsDeviceSuspend Cuando se suspenden todas las vistas Web, WebView2 trata la aplicación como si el dispositivo estuviera suspendido y pausa todas las tareas y temporizadores retrasados.
no-proxy-server Reemplaza cualquier otra marca de servidor proxy que se transmita.
net-log-capture-mode Establece la granularidad de los eventos que se capturarán en el registro de red. Valores válidos: Default, IncludeSensitive, Everything.
no-network-profile-warning Hace que el explorador avise si la UDF se encuentra en un recurso compartido de red. Esta marca solo se admite en Windows; Esta marca se ignora en otras plataformas.
no-sandbox Deshabilita el espacio aislado para todos los tipos de procesos que normalmente están aislados. Diseñado para usarse como marcador a nivel de explorador solo con fines de prueba.
no-first-run Omite First-Run tareas, independientemente de si se trata de la primera ejecución, y omite la visualización de la página Novedades. Esta marca se invalida por kForceFirstRun (para la experiencia de First-Run [FRE]) y por kForceWhatsNew (para mostrar las novedades). Esta marca no quita el centinela de primera ejecución y, por lo tanto, no impide que la experiencia de First-Run se produzca la próxima vez que se inicie el explorador Edge WebView sin esta marca. Esta marca no actualiza el último hito de Novedades, por lo que no impide que se muestre Novedades la próxima vez que se inicie el explorador Edge WebView sin esta marca.
PartitionedCookies Permite a los sitios optar por que el sitio de nivel superior particione sus cookies mediante el uso del Partitioned atributo. Las cookies con particiones solo se envían cuando el explorador está en el mismo sitio de nivel superior en el que se encontraba cuando se estableció la cookie.
proxy-auto-detect Fuerza la detección automática de proxy.
proxy-bypass-list Una lista de hosts para los que se omite la configuración de proxy; Los hosts especificados usan conexiones directas en su lugar. Esta marca se omite a menos que --proxy-server también se especifique. Se pueden proporcionar varios hosts como una lista separada por comas.
proxy-server Un servidor proxy que invalida la configuración del sistema. Esta marca solo afecta a las solicitudes HTTP y HTTPS.
remote-allow-origins Solo permite conexiones de socket web de los orígenes especificados. El * carácter comodín permite cualquier origen.
remote-debugging-port Habilita la depuración remota a través de HTTP en el puerto especificado.
RendererAppContainer Habilita Renderer AppContainer.
Restart Indica que el proceso del explorador WebView2 de Microsoft Edge se reinició (por ejemplo, después de un cambio de marca). Use esta marca para ignorar el lanzamiento al registrar la Launch.Mode2 métrica.
sdsm-state El estado "Modo seguro Super Duper". Valores válidos: off, basic, balanced, strict.
SharedArrayBuffer Indica que hay un SharedArrayBuffer subproceso presente.
SpareRendererForSitePerProcess Hace que el proceso del procesador de repuesto de Edge Webview intente tener siempre un proceso de procesador de repuesto en ejecución para el archivo solicitado BrowserContextmás recientemente. Esta característica solo se consulta en modo sitio por proceso.
ThirdPartyStoragePartitioning Habilita la creación de particiones en el almacenamiento de terceros, como IndexedDB o CacheStorage, por el sitio de nivel superior, para reducir la toma de huellas digitales.
unsafely-treat-insecure-origin-as-secure Trata orígenes dados (inseguros) como orígenes seguros. Se pueden especificar varios orígenes, como una lista separada por comas. Para obtener la definición de contextos seguros, consulte Contextos seguros, incluida la sección ¿Es origin potencialmente confiable?. Ejemplo: --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test.
use-fake-device-for-media-stream Usa un dispositivo falso para que Media Stream reemplace una cámara y un micrófono reales.
use-fake-ui-for-media-stream Para omitir la barra de información de secuencias multimedia, seleccione el dispositivo predeterminado para las secuencias multimedia (como WebRTC). Funciona con --use-fake-device-for-media-stream. Prefiera usar --auto-accept-camera-and-microphone-capture en su lugar, que no interactúa con la captura de pantalla, como capturar una pestaña del explorador.
use-system-proxy-resolver Usa WinHttp para resolver servidores proxy en lugar de usar la lógica normal de resolución de proxy de WebView2. Esta marca solo se admite en Windows.
user-agent Cadena que se usa para invalidar el agente de usuario predeterminado con un agente de usuario personalizado.
user-data-migrated Indica que este proceso es el producto de un relanzamiento tras la migración de datos de usuario.
UseBackgroundNativeThreadPool Hace que WebView2 ThreadPoolImpl use un ThreadGroup en segundo plano respaldado por una implementación de grupo de subprocesos nativa.
UseNativeThreadPool Hace que WebView2 ThreadPoolImpl use un primer plano ThreadGroup respaldado por una implementación de grupo de subprocesos nativos.
V8Maglev Habilita el compilador de levitación magnética. Esto solo establece la bandera V8 cuando se anula manualmente; de lo contrario, se remite al valor predeterminado del V8.

Vea también

  • Last updated on