Compartilhar via

Sinalizadores do browser WebView2

Uma das formas de interagir com o Microsoft Edge WebView2 e o comportamento de impacto é ao transmitir sinalizadores do browser (argumentos ou comutadores) para o WebView2. Estes sinalizadores do browser são úteis para testar funcionalidades futuras e para diagnosticar problemas.

Para aplicações de produção, não utilize estes sinalizadores. Durante o desenvolvimento, se o sinalizador estiver presente, o comportamento especificado abaixo dos resultados.

Aviso

As aplicações em produção não devem utilizar sinalizadores do browser WebView2, uma vez que estes sinalizadores podem ser removidos ou alterados a qualquer momento e não são necessariamente suportados a longo prazo.

Geralmente, os sinalizadores pertencem ao Chromium e ao Microsoft Edge. Chromium sinalizadores não são propriedade ou controlados pelo Microsoft Edge, pelo que o Microsoft Edge não tem controlo sobre quando ou como os sinalizadores são removidos ou alterados no seu comportamento.

Pode definir sinalizadores de browser no ambiente do dispositivo local ou definir sinalizadores do browser programaticamente através de código. Ambas as abordagens são descritas abaixo.

Definir sinalizadores do browser no seu ambiente de dispositivo local

Para testar as funcionalidades futuras ou diagnosticar problemas, recomendamos a utilização de sinalizadores de browser no seu ambiente de dispositivo local, através da definição da variável de WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS ambiente ou através de chaves de registo. Para obter mais informações, veja a seguinte Referência da API Win32: CreateCoreWebView2EnvironmentWithOptions.

Definir sinalizadores do browser programaticamente através de código

Em vez de definir sinalizadores de browser no seu ambiente de dispositivo local, uma abordagem alternativa é definir sinalizadores do browser programaticamente ao passar os sinalizadores do browser como propriedade AdditionalBrowserArguments de CoreWebView2EnvironmentOptions. Se definir sinalizadores de browser programaticamente, certifique-se de que remove os sinalizadores no código antes de enviar a sua aplicação, para evitar enviar acidentalmente os sinalizadores em produção.

Sinalizadores do browser WebView2 disponíveis

Os seguintes sinalizadores de browser WebView2 estão disponíveis para utilização durante o desenvolvimento.

Para aplicações de produção, não utilize estes sinalizadores. Durante o desenvolvimento, se o sinalizador estiver presente, o comportamento especificado abaixo dos resultados.

Flag Descrição
accept-lang Accept-Language Especifica para enviar para servidores e expor para JavaScript através da propriedade DOM Navigator.language. O formato é language[-country], onde language está o código de duas letras de ISO-639.
allow-file-access-from-files Permite a leitura file:// de URIs de outros file:// URIs.
allow-insecure-localhost Permite que os erros TLS/SSL no localhost sejam ignorados, para que não seja feito nenhum interstitial e não seja feito nenhum bloqueio de pedidos.
allow-run-as-system Por predefinição, o browser Edge WebView sai se for iniciado como Sistema (a iniciação como Sistema não é recomendada). Este sinalizador ignora esse marcar, para que, mesmo que o browser Edge WebView seja iniciado como Sistema, o browser Edge WebView não saia.
allow-running-insecure-content Ativa conteúdos inseguros no Runtime web cast. Este sinalizador desbloqueia MSPs que servem conteúdos de origens HTTP.
auto-open-devtools-for-tabs Faz com que o Edge WebView abra automaticamente a janela DevTools para cada separador. Para utilização por programadores e por automatização.
AutofillReplaceCachedWebElementsByRendererIds Substitui os elementos Web em cache em AutofillAgent e FormTracker pelos respetivos IDs de compositor.
autoplay-policy Nome do sinalizador da linha de comandos para definir a política de reprodução automática.
BlockInsecurePrivateNetworkRequests Quando esta funcionalidade está ativada, os pedidos de rede privada iniciados a partir de contextos não seguros no public espaço de endereços são bloqueados.
block-new-web-contents Utiliza um true valor ou false . Se true, faz com que todos os pop-ups e chamadas window.open falhem. Se false, os pop-ups e as chamadas para window.open são respeitados.
BreakoutBoxPreferCaptureTimestampInVideoFrames Reverte o comportamento da Timestamp propriedade da CoreWebView2Texture classe para corresponder ao comportamento legado da versão 124 e anterior do WebView2 Runtime.
disable-background-timer-throttling Desativa a limitação de tarefas de temporizador a partir de páginas de fundo.
disable-domain-action-user-agent-override Desativa a substituição do Agente de Utilizador por domínio da funcionalidade Ações de Domínio.
disable-gpu Desativa a aceleração de hardware da GPU. Se um compositor de software não estiver implementado, o processo de GPU não é iniciado.
disable-gpu-driver-bug-workarounds Desativa as soluções para vários erros do controlador de GPU.
disable-site-isolation-trials Desativa o isolamento do site.
disable-web-security Desativa a política de várias origens e não impõe a política de origem idêntica. Utilize apenas para testes de sites.
disk-cache-size Força o espaço máximo em disco a ser utilizado pela cache do disco, em bytes.
do-not-de-elevate Impede a eliminação da elevação do WebView2 ao iniciar. Utilizado após a eliminação da elevação, para evitar ciclos infinitos.
edge-webview-debugging-script Executa PostWebMessage o script de forma assíncrona.
edge-webview-enable-mojo-ipcz Ativa o MojoIpcz (mojo-ipcz) para aplicações que utilizam o WebView2.
edge-webview-foreground-boost-opt-in Opts-in to foreground boost.
edge-webview-foreground-boost-opt-out Opts-out of foreground boost.
edge-webview-force-personal-context Força os processos do browser Edge WebView a serem executados no contexto pessoal do WIP.
edge-webview-interactive-dragging Permite que eventos de ponteiro e eventos de foco ocorram em elementos com o --app-region: drag atributo . Os elementos de arrastar são interativos por predefinição.
edge-webview-disable-interactive-dragging Desativa a ocorrência de eventos de ponteiro e eventos de foco em elementos que têm o --app-region: drag atributo . Se este sinalizador não estiver definido, os elementos de arrastar são interativos por predefinição.
edge-webview-is-background Indica que o WebView está a ser iniciado em segundo plano.
edge-webview-no-dpi-workaround Desativa a solução "Shim de compatibilidade da aplicação de deteção de DPI", que inicia o processo do browser Edge WebView através de uma shell, para que o processo não herda o shim "app compat".
edge-webview-run-with-package-id Executa processos WebView com uma identidade de pacote (ID do pacote) para uma aplicação de Ambiente de Trabalho com bridge.
edge-webview-run-without-package-id Executa processos WebView sem uma identidade de pacote (ID de pacote) para uma aplicação de Ambiente de Trabalho com bridge.
embedded-browser-webview-dpi-awareness Define o nível de deteção de DPI dos processos do lado do servidor.
enable-aggressive-domstorage-flushing Permite uma descarga agressiva do Armazenamento DOM para minimizar a perda de dados.
enable-experimental-web-platform-features Ativa as funcionalidades da Plataforma Web que estão em desenvolvimento.
enable-logging Ative o registo ao nível do erro.
force-color-profile Forçar todos os monitores a serem tratados como se tivessem o perfil de cor especificado. Valores válidos: srgb, generic-rgb.
force-device-scale-factor Substitui o fator de dimensionamento do dispositivo para a IU do browser Edge WebView e os conteúdos.
force-fieldtrials Pode ser utilizado para forçar as tentativas de campo ao testar as alterações localmente. O argumento é uma lista de pares nome/valor, separados por barras reencaminhadas. Se um nome de avaliação tiver um prefixo com um asterisco, essa versão de avaliação será iniciada ativada. Exemplo: o seguinte argumento define duas tentativas, com a segunda ativada: EdgeNow/Enable/*MaterialDesignNTP/Default/. Esta opção também pode ser utilizada pelo processo do browser para enviar a lista de avaliações para um processo que não seja do browser, utilizando o mesmo formato.
force-fieldtrial-params Pode ser utilizado para forçar parâmetros de avaliações de campo ao testar as alterações localmente. O argumento é uma lista de parâmetros de pares (chave, valor), com o prefixo de um par associado (avaliação, grupo). Para vários pares (avaliação, grupo), utilize um separador de vírgulas.
force-renderer-accessibility Se pretende forçar a acessibilidade do compositor a ser ativada, em vez de ativar a acessibilidade do compositor a pedido quando um leitor de ecrã é detetado. O disable-renderer-accessibility sinalizador substitui este sinalizador, se o disable-renderer-accessibility sinalizador estiver presente.
HardwareMediaKeyHandling Permite o processamento de chaves de multimédia de hardware para controlar os suportes de dados.
ignore-certificate-errors Ignora erros relacionados com o certificado.
ignore-gpu-blocklist Se pretende ignorar a lista de bloqueios de GPU.
incognito Força o modo InPrivate (Incógnito), mesmo que o diretório de dados do utilizador seja especificado com o --user-data-dir sinalizador .
isolate-origins Exigir processos dedicados para um conjunto de origens, especificado como uma lista separada por vírgulas. Exemplo: --isolate-origins=https://www.foo.com,https://www.bar.com.
js-flags Especifica os sinalizadores transmitidos ao motor JS. Sinalizadores disponíveis: scavenger_max_new_space_capacity_mbespecifica o limite máximo (em MB) para recoletores de lixo (menores) do motor JavaScript V8.
Um limite de memória mais baixo reduz a utilização da memória e aumenta a frequência de execução de pequenos recoletores de lixo.
Um limite de memória mais elevado aumenta a utilização da memória e reduz a frequência de execução de pequenos recoletores de lixo. Exemplo: --js-flags=--scavenger_max_new_space_capacity_mb=8.
lang O ficheiro de idioma que o WebView2 quer tentar abrir. Da linguagem de formulário[-país] em que o idioma é o código de duas letras de ISO-639.
log-net-log Permite guardar eventos de registo de rede num ficheiro. Se for atribuído um valor, esse valor é utilizado como o caminho do diretório e o nome do ficheiro. Se não for dado nenhum valor, o ficheiro é denominado netlog.jsone é colocado no diretório de dados do utilizador.
long-animation-frame-timing Fornece temporização detalhada para molduras de animação longas, que são fotogramas que excedem a duração padrão de 16,67 ms (60fps). Isto ajuda durante a depuração e análise de desempenho, para identificar e otimizar estrangulamentos de desempenho para aplicações de animação intensiva.
msAbydos Ativa a experiência "escrita manual em texto".
msAbydosGestureSupport Permite que os utilizadores utilizem gestos (como o gesto de rascunho) para eliminar texto utilizando uma caneta. Válido apenas se o msAbydos sinalizador estiver ativado.
msAbydosHandwritingAttr Se a experiência "escrita manual em texto" está ativada para elementos de entrada ao nível do DOM. Válido apenas se o msAbydos sinalizador estiver ativado.
msAllowAmbientAuthInPrivateWebView2 Este sinalizador deve ser utilizado juntamente com o sinalizador do browser para ativar o msSingleSignOnForInPrivateWebView2 início de sessão único (SSO) com o fluxo de credenciais predefinido ou o fluxo de autenticação ambiente.
msEdgeDesignerUI Ativa a Aplicação Designer Shoreline. A Aplicação Designer Shoreline não é suportada no WebView2.
msEdgeHubAppDesigner Ativa a Aplicação Designer Shoreline. A Aplicação Designer Shoreline não é suportada no WebView2.
msEdgeDesignerDriverFix Ativa a obtenção de conteúdo e a apresentação automática da funcionalidade Designer. A funcionalidade Designer não é suportada no WebView2.
msEdgeFluentOverlayScrollbar Force-enables Fluent Overlay scrollbars, substituindo qualquer valor kFluentScrollbar que possa conter no momento.
msEdgeDevToolsWdpRemoteDebugging Ativa a depuração remota. Veja Depuração remota de aplicações WebView2 WinUI 2 (UWP), Depurarremotamente dispositivos Windows.
msEdgeWebViewApplyWebResourceRequestedFilterForOOPIFs Faz com que o AddWebResourceRequestedFilter método (incluindo sobrecargas) também se aplique a iframes fora do processo.
.NET: AddWebResourceRequestedFilter
WinRT: AddWebResourceRequestedFilter
Win32: AddWebResourceRequestedFilterWithRequestSourceKinds
msEnhancedTextContrast Melhora o melhoramento do contraste de texto e a correção gama para corresponder à qualidade e clareza de outras aplicações nativas do Windows. Quando este sinalizador é utilizado, a composição do tipo de letra respeita as definições do Sintonizador ClearType ao aplicar melhorias de contraste de texto e correção gama.
msEnhancedTrackingPreventionEnabled Ativa funcionalidades de proteção de privacidade nativas, tais como bloquear cookies e pedidos Web que residem em domínios conhecidos por serem domínios de controlo.
msFloatyMode Utiliza um true valor ou false . Se true, ativa a funcionalidade Floaty. Se false, desativa a funcionalidade Floaty. Utilize este sinalizador para desativar a funcionalidade Floaty, porque o WebView não suporta experimentações de retenção do browser.
msFloatyShouldHonorIndiaHoldout Utiliza um true valor ou false . Se true, honra o grupo de retenção da Índia. Se false, desativar a funcionalidade Floaty que está ativada se o utilizador fizer parte do grupo de retenção da Índia, porque o WebView não suporta experimentações de retenção do browser.
msOverlayScrollbarWinStyle Se os utilizadores podem alterar entre os modos de sobreposição e não sobreposição para barras de deslocamento Fluent.
msPdfEnableAsPreview Estas funcionalidades permitem ao visualizador de PDF iniciar com uma barra de ferramentas mínima e no modo de pré-visualização só de leitura.
msSingleSignOnForInPrivateWebView2 Este sinalizador ativa o fluxo de início de sessão único (SSO) para sessões InPrivate (Anónimas) do WebView2. Ativa o SSO baseado no browser no modo InPrivate (Incógnito).
msSingleSignOnOSForPrimaryAccountIsShared Permite o início de sessão implícito em páginas Web da Microsoft através de qualquer conta, utilizando as informações da conta de SO principal.
msSmartScreenProtection Disponibiliza a proteção SmartScreen.
msUseSpellCheckCorrectionsCard Faz com que seja apresentada uma correção card IU quando o utilizador clica numa palavra com erro ortográfico.
msWebView2BrowserHitTransparent Faz com que os eventos do rato e do teclado passem pelo controlo WebView2 para a aplicação subjacente, para permitir que a aplicação processe estes eventos em vez do controlo WebView2 que processa os eventos. Quando este sinalizador não está ativado, o controlo WebView2 processa eventos de rato e teclado; os eventos não passam para a aplicação subjacente. Este sinalizador permite testar o comportamento da aplicação quando o controlo WebView2 não interceta eventos de entrada, para cenários em que a aplicação precisa de processar eventos de entrada diretamente. Este sinalizador não tem um valor. Este sinalizador pode fazer com que a aplicação falhe ou congele.
msWebView2CancelInitialNavigation Cancela a navegação inicial no WebView2 para melhorar o desempenho do arranque.
msWebView2CodeCache Torna os recursos JavaScript carregados numa aplicação WebView2 através SetVirtualHostNameToFolderMapping ou add_WebResourceRequested elegíveis para colocação em cache bytecode, o que deve acelerar a terceira carga e as cargas subsequentes. Esta funcionalidade também permite a colocação em cache bytecode para quaisquer outros componentes que utilizem o mecanismo de intercepção de rede DevTools para fornecer respostas personalizadas; veja Gestão personalizada de pedidos de rede.
msWebView2EnableDownloadContentInWebResourceResponseReceived Permite que as respostas de navegação que se tornam transferências estejam disponíveis no WebResourceResponseReceived.
msWebView2TextureStream Permite a transmissão em fluxo de fotogramas de vídeo capturados ou compostos para o controlo WebView2, onde o JavaScript pode compor ou interagir com os frames através de APIs DOM padrão W3C, incluindo o elemento Incorporação de Vídeo e o MediaStream.
msWebView2EnableDraggableRegions Utiliza um true valor ou false . Se true, ativar páginas Web no WebView2, utilize o estilo CSS, o app-region: drag\|nodrag que faz com que os elementos com esse estilo se comportem como uma barra de título. Se false, ou sem este sinalizador, o app-region: drag\|nodrag estilo CSS não tem efeito.
msWebView2NativeEventDispatch Utiliza uma ligação mojo nativa para enviar eventos internos, como mensagens Web para um processo de composição.
msWebView2SimulateMemoryPressureWhenInactive Simula a pressão da memória para um WebView inativo.
msWebView2TreatAppSuspendAsDeviceSuspend Quando todos os WebViews estão suspensos, o Faz com que o WebView2 trate a aplicação como se o dispositivo estivesse suspenso e coloca em pausa todas as tarefas e temporizadores atrasados.
no-proxy-server Substitui quaisquer outros sinalizadores de servidor proxy que são transmitidos.
net-log-capture-mode Define a granularidade dos eventos a capturar no registo de rede. Valores válidos: Default, , IncludeSensitiveEverything.
no-network-profile-warning Faz com que o browser avise se o UDF está numa partilha de rede. Este sinalizador só é suportado no Windows; este sinalizador é ignorado noutras plataformas.
no-sandbox Desativa o sandbox para todos os tipos de processo que normalmente são em sandbox. Destina-se a ser utilizado como um sinalizador ao nível do browser apenas para fins de teste.
no-first-run Ignora First-Run tarefas, independentemente de ser realmente a Primeira Execução, e ignora a apresentação da página Novidades. Este sinalizador é substituído por kForceFirstRun (para a Experiência de First-Run (FRE)) e por kForceWhatsNew (para apresentar Novidades). Este sinalizador não larga o sentinel da Primeira Execução e, portanto, não impede que a experiência de First-Run ocorra da próxima vez que o browser Edge WebView for iniciado sem este sinalizador. Este sinalizador não atualiza o último marco Novidades, pelo que não impede que as Novidades sejam apresentadas da próxima vez que o browser Edge WebView for iniciado sem este sinalizador.
PartitionedCookies Permite que os sites optem por ter os cookies particionados pelo site de nível superior com o Partitioned atributo . Os cookies particionados só são enviados quando o browser está no mesmo site de nível superior em que estava quando o cookie foi definido.
proxy-auto-detect Força a deteção automática do proxy.
proxy-bypass-list Uma lista de anfitriões para os quais as definições de proxy são ignoradas; em seguida, os anfitriões especificados utilizam ligações diretas. Este sinalizador é ignorado, a menos que --proxy-server também seja especificado. Vários anfitriões podem ser fornecidos como uma lista separada por vírgulas.
proxy-server Um servidor proxy que substitui as definições do sistema. Este sinalizador só afeta pedidos HTTP e HTTPS.
remote-allow-origins Ativa ligações de socket Web apenas a partir das origens especificadas. O * caráter universal permite qualquer origem.
remote-debugging-port Ativa a depuração remota através de HTTP na porta especificada.
RendererAppContainer Ativa o Compositor AppContainer.
Restart Indica que o processo do browser Microsoft Edge WebView2 foi reiniciado (por exemplo, após uma alteração do sinalizador). Utilize este sinalizador para ignorar a iniciação ao gravar a Launch.Mode2 métrica.
sdsm-state O estado "Modo seguro do Super Duper". Valores válidos: off, , basicbalanced, strict.
SharedArrayBuffer Indica que um SharedArrayBuffer thread está presente.
SpareRendererForSitePerProcess Faz com que o processo do compositor sobressalente do Edge Webview tente ter sempre um processo de composição sobressalente quente em execução para o mais recente pedido BrowserContext. Esta funcionalidade só é consultada no modo site por processo.
ThirdPartyStoragePartitioning Permite a criação de partições de armazenamento de terceiros, como IndexedDB ou CacheStorage, pelo site de nível superior, para reduzir a impressão digital.
unsafely-treat-insecure-origin-as-secure Trata as origens fornecidas (inseguras) como origens seguras. Podem ser especificadas múltiplas origens, como uma lista separada por vírgulas. Para obter a definição de contextos seguros, veja Contextos Seguros, incluindo a secção É origin potencialmente fidedigno?. Exemplo: --unsafely-treat-insecure-origin-as-secure=http://a.test,http://b.test.
use-fake-device-for-media-stream Utiliza um dispositivo falso para multimédia Stream para substituir uma câmara e um microfone reais.
use-fake-ui-for-media-stream Ignora a barra de informações de fluxo de multimédia ao selecionar o dispositivo predefinido para fluxos de multimédia (como o WebRTC). Funciona com --use-fake-device-for-media-stream. Em vez disso, prefere utilizar --auto-accept-camera-and-microphone-capture , o que não interage com a captura de ecrã, como capturar um separador do browser.
use-system-proxy-resolver Utiliza WinHttp para resolve proxies em vez de utilizar a lógica de resolução de proxy normal do WebView2. Este sinalizador só é suportado no Windows.
user-agent Uma cadeia utilizada para substituir o agente de utilizador predefinido por um agente de utilizador personalizado.
user-data-migrated Indica que este processo é o produto de um relançamento após a migração de dados de utilizador.
UseBackgroundNativeThreadPool Faz com que WebView2 ThreadPoolImpl utilize um ThreadGroup em segundo plano apoiado por uma implementação de conjunto de threads nativo.
UseNativeThreadPool Faz com que o WebView2 ThreadPoolImpl utilize um primeiro plano ThreadGroup apoiado por uma implementação de conjunto de threads nativo.
V8Maglev Ativa o compilador Maglev. Isto só define o sinalizador V8 quando é substituído manualmente; caso contrário, adia para qualquer que seja a predefinição V8.

Confira também