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

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

Sam Dutton

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 os recursos de vídeo picture-in-picture antes de lançar 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 flags depende da versão do Chrome que você está usando.

Há duas maneiras de configurar as sinalizações do Chrome:

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

chrome://flags

Para definir uma flag na página chrome://flags no Chrome, você precisa encontrar a flag, ativar 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 sinalização, o Chrome 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 avisos ativados.

Flags de linha de comando

Se você é um desenvolvedor Web, convém definir sinalizações abrindo o Chrome pela 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 flags para ativar, desativar e configurar recursos menos conhecidos.

Se você usa regularmente diferentes canais do Chrome com sinalizações de linha de comando, convém criar uma função para cada canal e adicioná-las 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 pela linha de comando, poderá definir o diretório de dados do usuário com o --user-data-dir flag.

Isso significa que você pode ter um diretório de dados do usuário separado para desenvolvimento, com seus 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 sinalização:

--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, com a seção "Command Line" destacada.

Duas outras maneiras de testar os 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 de novos recursos explicará quando essa opção estiver disponível.

No Chrome Beta, você pode testar experimentos em destaque e enviar feedback. Basta ativar as configurações do Experimento e reiniciar o navegador. A seção Testar recursos experimentais no Chrome tem mais detalhes.

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

Quais recursos recebem uma sinalização?

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 sinalização antes disso. Isso é muito 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 enviar feedback à comunidade de padrões da Web antes que o recurso seja disponibilizado para todos os usuários.

Os recursos que estão passando por um teste de origem são ativados em todas as páginas que fornecem um token válido para esse 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