Compartir a través de

Marcas del explorador WebView2

  • Artículo

Una de las maneras en que puede interactuar con Microsoft Edge WebView2 y el comportamiento de impacto es pasando marcas de explorador (argumentos o modificadores) a WebView2. Estas marcas de explorador son útiles para probar las próximas características y diagnosticar problemas.

Advertencia

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

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

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

Establecimiento de marcas de explorador en el entorno de dispositivo local

Para probar las próximas características o diagnosticar problemas, se recomienda usar marcas de explorador en el entorno del dispositivo local, mediante la configuración de la WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS variable de entorno o mediante claves del Registro. Para obtener más información, consulte la siguiente referencia de api de Win32: CreateCoreWebView2EnvironmentWithOptions.

Establecimiento de marcas de explorador mediante programación a través del código

En lugar de establecer marcas de explorador en el entorno de dispositivo local, un enfoque alternativo consiste en establecer las marcas de explorador mediante programación, pasando las marcas de explorador como propiedad AdditionalBrowserArguments de CoreWebView2EnvironmentOptions. Si establece marcas de explorador mediante programación, asegúrese de quitar las marcas en el código antes de enviar la aplicación para evitar el envío accidental de las marcas en producción.

Marcas de explorador WebView2 disponibles

A continuación se muestran algunas de las marcas que hemos visto usar.

Flag Descripción
accept-lang Especifica que se Accept-Language enviará a los 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 omitir los errores TLS/SSL en localhost, de modo que no se realiza ninguna intersticial y no se realiza 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 iniciar como Sistema). Esta marca omite esa comprobación, de modo que incluso si el explorador WebView perimetral se inicia como Sistema, el explorador WebView perimetral no se cierra.
allow-running-insecure-content Habilita el contenido no seguro en Cast Web Runtime. 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 DevTools para cada pestaña. Para que lo usen los desarrolladores y la automatización.
AutofillReplaceCachedWebElementsByRendererIds Si está habilitado, reemplaza los elementos web almacenados en caché en AutofillAgent y FormTracker por sus identificadores de representador.
autoplay-policy Nombre de la marca de 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 Si truees , se producirá un error en todas las ventanas emergentes y llamadas.window.open
BreakoutBoxPreferCaptureTimestampInVideoFrames Revierte el comportamiento de la Timestamp propiedad de la clase para que coincida con el CoreWebView2Texture comportamiento heredado de WebView2 Runtime versión 124 y anteriores.
disable-background-timer-throttling Deshabilita la limitación de tareas de las tareas del 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 GPU. Si un representador de software no está en su lugar, el proceso de GPU no se inicia.
disable-gpu-driver-bug-workarounds Deshabilita las soluciones alternativas para varios errores de controladores de GPU.
disable-site-isolation-trials Deshabilita el aislamiento del sitio.
disable-web-security Deshabilita la directiva entre orígenes y no aplica la directiva del mismo origen. Use solo para las pruebas del sitio web.
disk-cache-size Fuerza el espacio máximo en disco que va a usar la memoria caché de disco, en bytes.
do-not-de-elevate Evita la des elevación de WebView2 al iniciarse. Se usa después de desalentar, para evitar bucles infinitos.
edge-webview-debugging-script Ejecuta PostWebMessage el script de forma asincrónica.
edge-webview-enable-mojo-ipcz Habilita MojoIpcz (mojo-ipcz) para las aplicaciones que usan WebView2.
edge-webview-foreground-boost-opt-in Opta por aumentar el primer plano.
edge-webview-foreground-boost-opt-out Opta por no aumentar el primer plano.
edge-webview-force-personal-context Obliga a que los procesos del explorador WebView de Edge se ejecuten en el contexto personal de WIP.
edge-webview-interactive-dragging Permite que los eventos de puntero y los eventos de foco se produzcan en elementos que tienen el --app-region: drag atributo . Los elementos de arrastre son interactivos de forma predeterminada.
edge-webview-disable-interactive-dragging Deshabilita los eventos de puntero y los eventos de foco para que no se produzcan en 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-is-background Indica que WebView se inicia en segundo plano.
edge-webview-no-dpi-workaround Deshabilita la solución alternativa "Compatibilidad con compatibilidad con la aplicación de reconocimiento de PPP", que inicia el proceso del explorador WebView de Edge a través de un shell, de modo que el proceso no herede la corrección de compatibilidad de "compatibilidad de aplicaciones".
edge-webview-run-with-package-id Ejecuta procesos de WebView con una identidad de paquete (id. de paquete) para una aplicación de escritorio puente.
edge-webview-run-without-package-id Ejecuta procesos de WebView sin una identidad de paquete (identificador de paquete) para una aplicación de escritorio puente.
embedded-browser-webview-dpi-awareness Establece el nivel de reconocimiento de PPP de los procesos del lado servidor.
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 que todos los monitores se traten como si tuvieran el perfil de color especificado. Valores válidos: srgb, generic-rgb.
force-device-scale-factor Invalida el factor de escala del dispositivo para la interfaz de usuario del explorador WebView perimetral y el contenido.
force-fieldtrials Se puede usar para forzar las pruebas de campo al probar los cambios localmente. El argumento es una lista de pares nombre-valor, separados por barras diagonales. Si un nombre de prueba tiene el prefijo de asterisco, se iniciará la prueba. Por ejemplo, el argumento siguiente define dos pruebas, con la segunda activada: EdgeNow/Enable/*MaterialDesignNTP/Default/. El proceso del explorador también puede usar esta opción para enviar la lista de pruebas a un proceso que no sea del explorador, con el mismo formato.
force-fieldtrial-params Se puede usar para forzar parámetros de pruebas de campo al probar los cambios localmente. El argumento es una lista de parámetros de pares (clave, valor), precedida 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 la disable-renderer-accessibility marca está presente.
HardwareMediaKeyHandling Permite el control de claves multimedia de hardware para controlar los medios.
ignore-certificate-errors Omite los errores relacionados con el certificado.
ignore-gpu-blocklist Si se debe omitir la lista de bloqueos de GPU.
incognito Fuerza el modo incógnito incluso si se especifica el directorio de datos del usuario mediante la --user-data-dir marca .
isolate-origins Requerir procesos dedicados para un conjunto de orígenes, especificados como una lista separada por comas. Por ejemplo: --isolate-origins=https://www.foo.com,https://www.bar.com.
js-flags Especifica las marcas que se pasan al motor js.
lang El archivo de idioma que WebView2 quiere intentar abrir. Del idioma del formulario[-país] donde idioma es el código de 2 letras de ISO-639.
log-net-log Permite guardar eventos de registro de red en un archivo. Si se especifica un valor, ese valor se usa como la ruta de acceso del directorio y el nombre de archivo. Si no se especifica ningún valor, el archivo se denomina netlog.jsony se coloca en el directorio de datos del usuario.
msAbydos Habilita la experiencia "escritura a mano a texto".
msAbydosGestureSupport Permite a los usuarios usar gestos (como el gesto de borrador) para eliminar texto mediante un lápiz. Solo es válido si la msAbydos marca está habilitada.
msAbydosHandwritingAttr Si la experiencia "escritura a mano a texto" está habilitada para los elementos de entrada en el nivel DOM. Solo es válido si la msAbydos marca está habilitada.
msEdgeDesignerUI Use esta marca para deshabilitar la aplicación Designer Shoreline. Esta característica no se admite en WebView2.
msEdgeHubAppDesigner Use esta marca para deshabilitar la aplicación Designer Shoreline. Esta característica no se admite en WebView2.
msEdgeDesignerDriverFix Use esta marca para deshabilitar la obtención de contenido y mostrar automáticamente la característica de Designer. Esta característica no se admite en WebView2.
msEdgeFluentOverlayScrollbar Fuerza las barras de desplazamiento de Fluent Overlay, reemplazando cualquier valor kFluentScrollbar que pueda contener en este momento.
msEdgeDevToolsWdpRemoteDebugging Habilita la depuración remota. Consulta Depuración remota de aplicaciones WebView2 WinUI 2 (UWP) y Depuración remota de dispositivos Windows.
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs Si esta marca está habilitada, el AddWebResourceRequestedFilter método (incluidas las sobrecargas) también se aplicará a iframes fuera de proceso.
.NET: AddWebResourceRequestedFilter
WinRT: AddWebResourceRequestedFilter
Win32: AddWebResourceRequestedFilterWithRequestSourceKinds
msEnhancedTextContrast Mejora la mejora del contraste de texto y la corrección gamma para que coincidan 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 de texto y la corrección gamma.
msEnhancedTrackingPreventionEnabled Habilita características nativas de protección de privacidad, como el bloqueo de cookies y solicitudes web que residen en dominios que se sabe que son dominios de seguimiento.
msFloatyMode Si falsees , deshabilita la característica Floaty. Use esta marca para deshabilitar la característica Floaty, ya que WebView no admite experimentos de retención de exploradores.
msFloatyShouldHonorIndiaHoldout Si truees , respeta el grupo de exclusión de la India. Use esta marca, establecida en false, para deshabilitar la característica Floaty que está habilitada si el usuario forma parte del grupo de exclusión de La India, ya que WebView no admite experimentos de retención de exploradores.
msOverlayScrollbarWinStyle Si los usuarios pueden cambiar entre los modos de superposición y no superposición para las barras de desplazamiento de Fluent.
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.
msSingleSignOnOSForPrimaryAccountIsShared Si está habilitado, permite el inicio de sesión implícito en páginas web de Microsoft mediante cualquier cuenta, mediante la información de la cuenta del sistema operativo principal.
msSmartScreenProtection Si está habilitada, la protección smartscreen estará disponible.
msUseSpellCheckCorrectionsCard Si está habilitada, se muestra una nueva interfaz de usuario de tarjeta de correcciones cuando el usuario hace clic en una palabra mal escrita.
msWebView2CancelInitialNavigation Si está habilitado, cancela la navegación inicial en WebView2 para mejorar el rendimiento de inicio.
msWebView2CodeCache Si está habilitado, los recursos de JavaScript que se cargan en una aplicación WebView2 a través SetVirtualHostNameToFolderMapping de o add_WebResourceRequested son aptos para el almacenamiento en caché del código de bytes, lo que debería acelerar la tercera y posterior carga. 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 DevTools para proporcionar respuestas personalizadas (consulte Administración personalizada de solicitudes de red).
msWebView2EnableDownloadContentInWebResourceResponseReceived Si está habilitado, permita que las respuestas de las navegación que se convierten en descargas estén disponibles en WebResourceResponseReceived
msWebView2TextureStream Si está habilitado, permite transmitir fotogramas de vídeo capturados o compuestos a WebView2, donde JavaScript puede representar o interactuar con los fotogramas a través de las API DOM estándar de W3C, incluido el elemento Video y MediaStream.
msWebView2EnableDraggableRegions Si truees , permite que las páginas web de WebView2 usen el app-region: drag\|nodrag estilo CSS, lo que hace que los elementos con ese estilo se comporten como una barra de título. Sin esta marca, el app-region: drag\|nodrag estilo CSS no tiene ningún efecto.
msWebView2CodeCache Si está habilitado, los recursos de JavaScript que se cargan en una aplicación WebView2 a través SetVirtualHostNameToFolderMapping de o add_WebResourceRequested son aptos para el almacenamiento en caché del código de bytes, lo que debería acelerar la tercera y posterior carga. 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 DevTools para proporcionar respuestas personalizadas.
msWebView2NativeEventDispatch Si está habilitado, usa una conexión mojo nativa para enviar eventos internos, como mensajes web a un proceso de representador.
msWebView2SimulateMemoryPressureWhenInactive Si está habilitado, simula la presión de memoria para un WebView inactivo.
msWebView2TreatAppSuspendAsDeviceSuspend Si está habilitado, cuando se suspenden todas las vistas web, WebView2 trata la aplicación como si el dispositivo estuviera suspendido y pausa todas las tareas retrasadas y los temporizadores.
no-proxy-server Invalida cualquier otra marca de servidor proxy que se pase.
net-log-capture-mode Establece la granularidad de los eventos que se van a capturar en el registro de red. Valores válidos: Default, IncludeSensitive, Everything.
no-network-profile-warning Si está habilitado, el explorador advierte si la UDF está en un recurso compartido de red. Esta marca solo se admite en Windows; esta marca se omite en otras plataformas.
no-sandbox Deshabilita el espacio aislado para todos los tipos de proceso que normalmente están en espacio aislado. Está pensado para usarse como una marca de nivel de explorador solo con fines de prueba.
no-first-run Omite First-Run tareas, independientemente de si realmente es la primera ejecución, y omite la visualización de la página Novedades. Esta marca se reemplaza por kForceFirstRun (para la experiencia de First-Run (FRE)) y por kForceWhatsNew (para mostrar las novedades). Esta marca no quita el sentinel de primera ejecución y, por tanto, no impide que la experiencia de First-Run se produzca la próxima vez que se inicie el explorador WebView perimetral sin esta marca. Esta marca no actualiza el último hito de Novedades, por lo que no impide que lo nuevo se muestre la próxima vez que se inicie el explorador WebView perimetral sin esta marca.
PartitionedCookies Cuando están habilitados, los sitios pueden participar en la creación de particiones de cookies por parte del sitio de nivel superior mediante el Partitioned atributo . Las cookies con particiones solo se envían cuando el explorador está en el mismo sitio de nivel superior en el que estaba cuando se estableció la cookie.
proxy-auto-detect Fuerza la detección automática del proxy.
proxy-bypass-list Lista de hosts para los que se omite la configuración del 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 Servidor proxy que invalida la configuración del sistema. Esta marca solo afecta a las solicitudes HTTP y HTTPS.
remote-allow-origins Habilita solo las conexiones de socket web desde 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 el representador AppContainer.
Restart Indica que se ha reiniciado el proceso del explorador WebView2 de Microsoft Edge (por ejemplo, después de un cambio de marca). Use esta marca para omitir el inicio al registrar la Launch.Mode2 métrica.
sdsm-state El estado "Modo seguro de Super Duper". Valores válidos: off, basic, balanced, strict.
SharedArrayBuffer Si está habilitado, indica que hay un SharedArrayBuffer subproceso presente.
SpareRendererForSitePerProcess Si esta marca está habilitada, el proceso del representador de reserva de Edge Webview intenta tener siempre un proceso de representador de reserva en caliente que se ejecute para el más reciente solicitado BrowserContext. Esta característica solo se consulta en el modo sitio por proceso.
ThirdPartyStoragePartitioning Permite la creación de particiones de almacenamiento de terceros, como IndexedDB o CacheStorage, por el sitio de nivel superior, para reducir la huella digital.
unsafely-treat-insecure-origin-as-secure Trata orígenes determinados (no seguros) como orígenes seguros. Se pueden especificar varios orígenes, como una lista separada por comas. Para obtener la definición de contextos seguros, vea Contextos seguros, incluida la sección ¿Es origin potencialmente de confianza? Ejemplo: --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test
use-fake-device-for-media-stream Usa un dispositivo falso para media Stream para reemplazar una cámara y un micrófono reales.
use-fake-ui-for-media-stream Omite la barra de información de secuencias multimedia; para ello, selecciona el dispositivo predeterminado para las secuencias multimedia (por ejemplo, WebRTC). Funciona con --use-fake-device-for-media-stream. Prefiere usar --auto-accept-camera-and-microphone-capture en su lugar, lo 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 de resolución de proxy normal 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 después de la migración de datos de usuario.
UseBackgroundNativeThreadPool Si está habilitado, WebView2 ThreadPoolImpl usará un ThreadGroup en segundo plano respaldado por una implementación de grupo de subprocesos nativa.
UseNativeThreadPool Si está habilitado, WebView2 ThreadPoolImpl usa un primer plano ThreadGroup respaldado por una implementación del grupo de subprocesos nativo.
V8Maglev Habilita el compilador de Maglev. Esto solo establece la marca V8 cuando se invalida manualmente; De lo contrario, se aplaza a lo que sea el valor predeterminado de V8.

Vea también