O que são as sinalizações do Chrome?

Ative outras ferramentas de depuração ou teste recursos novos ou experimentais.

As flags do Chrome são uma maneira de ativar recursos do navegador que não estão disponíveis por padrão.

Por exemplo, o Chrome queria permitir que os usuários testassem recursos de vídeo picture-in-picture antes de lançá-los para todos.

O picture-in-picture do Chrome permite que os usuários continuem assistindo um vídeo em uma guia enquanto trabalham
em outra.

O recurso foi disponibilizado com uma flag, para que qualquer usuário pudesse testá-lo e enviar feedback. O código e o design foram testados e aprimorados com base no feedback, então agora você pode usar o modo picture-in-picture por padrão no Chrome, e ele funciona muito bem.

Entender os riscos

A maioria dos usuários do Chrome nunca vai precisar usar as flags do Chrome.

Se você definir flags do Chrome, tome cuidado. Ao ativar ou desativar recursos, você pode perder dados ou comprometer sua segurança ou privacidade. Além disso, os recursos que você alternar com uma flag podem parar de funcionar ou ser removidos sem aviso.

Se você é um administrador de TI empresarial, não use sinalizações do Chrome na produção. Confira as políticas corporativas.

...e tenha cuidado

Dito isso, se você é um desenvolvedor da Web que precisa testar novas tecnologias ou apenas um geek curioso, conhecer as flags do Chrome pode ser muito útil.

Há um grande número de flags para muitos tipos diferentes de recursos. Algumas flags afetam a aparência ou o funcionamento do Chrome, e outras ativam recursos, como novas APIs JavaScript. A disponibilidade das sinalizações depende da versão do Chrome que você usa.

Há duas maneiras de definir flags do Chrome:

  • Na página chrome://flags.
  • Abrindo o Chrome na linha de comando em um terminal.

chrome://flags

Para definir uma sinalização na página chrome://flags no Chrome, você precisa encontrar a sinalização, alternar a configuração dela e reiniciar o navegador. Por exemplo, para ativar a visualização de resumo do Chrome para métricas de desempenho:

  1. Pesquise o recurso. Página chrome://flags
com a flag HUD definida como padrão.

  2. Defina o valor como Ativado. Página chrome://flags
com a flag HUD ativada.

  3. Reinicie o Chrome. Depois de atualizar uma
flag, o Chrome vai solicitar que você reinicie o navegador.

Agora você pode usar a tela de avisos que mostra informações técnicas sobre o desempenho da página da Web.

Página do Chrome com
a tela Heads-up ativada.

Flags de linha de comando

Se você for um desenvolvedor da Web, poderá definir flags abrindo o Chrome na linha de comando em um terminal. Você executa o comando para abrir o Chrome e adiciona as flags que quer definir. Há muitas configurações do Chrome que podem ser definidas na linha de comando, em vez de na página chrome://flags.

Por exemplo, para executar o Chrome Canary em um terminal em um Mac, com a API Topics ativada e o comprimento da época definido como 15 segundos, use o seguinte comando:

/Applications/Google\ Chrome\ Canary.app/Contents/MacOS/Google\ Chrome\ Canary
--enable-features=BrowsingTopics:time_period_per_epoch/15s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting  

Esse é apenas um exemplo. Há centenas de outras sinalizações para ativar, desativar e configurar recursos menos conhecidos.

Se você usa canais diferentes do Chrome com flags de linha de comando regularmente, crie uma função para cada canal e adicione ao arquivo RC do shell. Por exemplo, no macOS:

  1. Abra um terminal.
  2. Crie uma função: cf(){ open -a 'Google Chrome Canary' --args $*; }
  3. Use a função: cf --enable-features=TrackingProtection3pcd

Definir o diretório de dados do usuário do Chrome

Na linguagem de engenharia do Chrome, usuário se refere a um "usuário humano individual do Chrome".

Um cliente do Chrome se refere a uma instalação individual do Chrome em um dispositivo.

Mais precisamente, um cliente do Chrome corresponde a um diretório de dados do usuário individual. Cada perfil do Chrome é armazenado em um subdiretório no diretório de dados do usuário.

Se você executar o Chrome na linha de comando, poderá definir o diretório de dados do usuário com --user-data-dir flag.

Isso significa que você pode ter um diretório de dados do usuário separado para desenvolvimento, com os próprios subdiretórios de perfil. A criação de um novo diretório de dados do usuário faz com que o Chrome se comporte como se tivesse sido instalado recentemente, o que pode ser útil para depurar problemas relacionados ao perfil.

Para executar o Chrome na linha de comando com um novo diretório de usuário temporário, use a seguinte flag:

--user-data-dir=$(mktemp -d)

Você também pode adicionar as flags a seguir para evitar a verificação do navegador e a IU da primeira execução:

--no-default-browser-check --no-first-run

Cuidado com os conflitos de sinalização

É possível que as flags definidas entrem em conflito. As configurações chrome://flags substituem as configurações de linha de comando para a mesma flag, e os padrões de uma configuração chrome://flags podem, em alguns casos, substituir as configurações da linha de comando. Se as flags definidas para executar o Chrome na linha de comando não funcionarem como esperado, verifique a página chrome://flags.

As configurações mostradas na página chrome://flags não refletem as flags definidas na linha de comando. Em vez disso, confira a página chrome://version. A seção Linha de comando mostra as configurações da sinalização.

Página "chrome://version"
no Chrome Canary, seção "Linha de comando" destacada.

Duas outras maneiras de testar recursos experimentais

É possível ativar uma variedade de recursos experimentais que não têm sinalização própria alternando a flag chrome://flags#enable-experimental-web-platform-features. A documentação dos novos recursos vai explicar quando essa é uma opção.

No Chrome Beta, você pode testar os experimentos em destaque e enviar feedback alternando as configurações de Experiment e reiniciando o navegador. Testar recursos experimentais no Chrome oferece mais detalhes.

Captura de tela da interface de experimentos no Chrome Beta mostrando as opções de rolagem da guia.

Quais recursos recebem uma flag?

Nem todos os recursos experimentais têm uma flag do Chrome:

  • Alguns recursos só ficam disponíveis quando são enviados no Chrome Canary e não podem ser ativados por uma flag antes disso. Isso é bastante raro.
  • Para recursos "menores" que exigem de 1 a 2 trimestres de trabalho, a disponibilidade experimental é fornecida ativando a seguinte flag:
    chrome://flags#enable-experimental-web-platform-features
    Isso ativa vários recursos menores.
  • Os principais recursos são disponibilizados para testes com flags específicas, usando chrome://flags ou chaves de linha de comando.

E as configurações do Chrome?

As configurações e as sinalizações do Chrome têm finalidades diferentes.

As sinalizações do Chrome permitem que o usuário ative ou desative recursos experimentais, enquanto os controles disponíveis na página chrome://settings permitem que o usuário personalize a experiência para recursos disponíveis por padrão.

E os testes de origem?

Os testes de origem são uma maneira de os desenvolvedores testarem um recurso novo ou experimental da plataforma da Web em grande escala e fornecer feedback à comunidade de padrões da Web antes que o recurso seja disponibilizado para todos os usuários.

Os recursos em testes de origem são ativados em todas as páginas que fornecem um token válido para o teste. Isso permite que os proprietários de sites ativem um recurso experimental para todos os usuários, sem exigir que eles mudem as configurações do navegador ou definam flags. Em comparação, as flags do Chrome permitem que usuários individuais ativem ou desativem um recurso experimental em todos os sites que visitam. Começar a usar os testes de origem do Chrome oferece mais detalhes.

Saiba mais