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

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

Sam Dutton

As sinalizações 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 o app 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 um sinalizador para que qualquer usuário pudesse testá-lo e enviar feedback. O código e o design foram testados e refinados com base no feedback. Agora, você pode usar o picture-in-picture por padrão no Chrome, e ele funciona muito bem.

Entenda os riscos

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

Se você configurar as sinalizações do Chrome, tenha cuidado. Ao ativar ou desativar recursos, você pode perder dados ou comprometer sua segurança ou privacidade, e os recursos alternados com uma flag podem parar de funcionar ou ser removidos sem aviso prévio.

Os administradores de TI de empresas não devem usar as sinalizações do Chrome na produção. Nesse caso, consulte as políticas empresariais.

...e continue com cautela

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

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

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

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

chrome://flags

Para definir uma sinalização na página chrome://flags do Chrome, encontre a sinalização, alterne a configuração dela e reinicie o navegador. Por exemplo, para ativar os avisos na tela 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 é possível usar a tela de avisos, que mostra informações técnicas sobre o desempenho da página da Web.

Página do Chrome com o alerta ativado.

Sinalizações de linha de comando

Se você é um desenvolvedor da Web, defina flags abrindo o Chrome pela linha de comando de um terminal. Execute o comando para abrir o Chrome e adicione as sinalizações que você quer definir. É possível definir muito mais configurações do Chrome na linha de comando do que as disponíveis na página chrome://flags.

Por exemplo, para executar o Chrome Canary em um terminal em um Mac, com a API Topics ativada e a duração da época definida como 15 segundos, use o comando abaixo:

/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 regularmente diferentes canais do Chrome com sinalizações de linha de comando, convém criar uma função para cada canal e adicioná-los 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, o usuário do Chrome 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 Chrome corresponde a um diretório de dados do usuário individual. Cada perfil do Chrome é armazenado em um subdiretório dentro do 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 subdiretórios de perfil próprios. A criação de um novo diretório de dados do usuário faz o Chrome se comportar 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)

Também é possível adicionar as seguintes sinalizações para evitar a verificação do navegador e a primeira execução da interface:

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

Cuidado com conflitos de sinalização

É possível que as sinalizações definidas entrem em conflito entre si. As configurações do chrome://flags substituem as configurações de linha de comando para a mesma flag. Os padrões de chrome://flags podem, em alguns casos, substituir as configurações da linha de comando. Se as sinalizações definidas para o Chrome pela 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 sinalizações definidas na linha de comando. Em vez disso, dê uma olhada na 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 "Linha de comando" destacada.

Duas outras maneiras de testar recursos experimentais

É possível ativar vários recursos experimentais que não têm uma flag própria alternando a flag chrome://flags#enable-experimental-web-platform-features. A documentação dos novos recursos explicará quando isso for possível.

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

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 própria:

  • 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 é raro.
  • Para recursos "menores" que exigem no máximo um ou dois trimestres de trabalho, a disponibilidade experimental é fornecida ativando a seguinte flag:
    chrome://flags#enable-experimental-web-platform-features
    Isso ativa vários recursos secundários.
  • 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 flags do Chrome permitem que o usuário ative ou desative recursos experimentais, enquanto os controles disponíveis na página chrome://settings permitem personalizar a experiência dos recursos disponíveis por padrão.

E os testes de origem?

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

Os recursos submetidos a um teste de origem são ativados em todas as páginas que fornecem um token válido para esse teste. Com isso, os proprietários de sites podem ativar 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 sinalizações do Chrome permitem que usuários individuais ativem ou desativem um recurso experimental em todos os sites visitados. Confira mais detalhes em Primeiros passos com os testes de origem do Chrome.

Saiba mais