Teste de descontinuação da Redução de user agent

O teste de descontinuação da redução de user agent permitiu que os sites continuassem recebendo a string completa do user agent após a redução da string do UA. O teste terminou em 23 de setembro de 2023.

A partir do Chrome 101, as informações disponíveis na string do user agent (UA) serão reduzidas usando uma abordagem em fases. Os sites que não tiveram tempo para deixar de usar a string do user agent reduzida e migrar para as dicas do cliente do user agent podem participar de um teste de descontinuação para continuar recebendo a string completa do user agent.

O registro para o teste de descontinuação começará com o Chrome 100 Beta. Isso permitirá que os sites recebam a string de user agent completa antes do lançamento do Chrome 101, em que a string da versão secundária será reduzida. Se você quiser testar o teste de origem no Chrome 100 Beta antes do lançamento no Canal Stable, faça o registro e teste antes da data de lançamento do Chrome 100 (programado para 31 de março de 2022).

Confira abaixo uma visão geral do teste de descontinuação e o que esperar. Se você tiver algum feedback para compartilhar ou encontrar algum problema durante o teste, acesse o repositório do GitHub de redução de UA (em inglês).

O que isso significa para os desenvolvedores da Web?

Ao se inscrever no teste de descontinuação, os sites vão continuar recebendo a string completa do UA em navigator.userAgent e valores não reduzidos nos getters JavaScript navigator.platform e navigator.appVersion relacionados:

  • O cabeçalho da solicitação HTTP User-Agent
  • O getter do JavaScript navigator.userAgent
  • O getter do JavaScript navigator.platform
  • O getter do JavaScript navigator.appVersion

Os sites ainda precisam auditar o uso do cabeçalho do user agent e das APIs relacionadas e, se necessário, preparar a migração para as dicas do cliente do user agent antes do fim do período de teste de descontinuação. A intenção é expirar esse teste de descontinuação assim que o lançamento da redução do user agent for concluído.

Como faço para participar do teste de descontinuação da redução do user agent?

Inscreva-se para o teste

Para se registrar no teste de origem e receber um token para seus domínios, acesse a página do teste de descontinuação do teste de redução do user agent. Se você for um terceiro registrado, marque "Correspondência de terceiros".

Instalação

Depois de se registrar para o teste, atualize seus cabeçalhos de resposta HTTP com o seguinte:

  1. Adicione Origin-Trial: <ORIGIN TRIAL TOKEN> ao cabeçalho de resposta HTTP. <ORIGIN TRIAL TOKEN> contém o token que você recebeu ao se registrar no teste de origem.
  2. Adicione Accept-CH: Sec-CH-UA-Full ao cabeçalho de resposta HTTP. Definir Accept-CH só fará com que a string completa do user agent seja enviada em solicitações subsequentes para a origem.
  3. Se a string completa do user agent for essencial na primeira solicitação, adicione Critical-CH: Sec-CH-UA-Full ao cabeçalho de resposta HTTP, além dos cabeçalhos Accept-CH e Origin-Trial.

  4. Para os participantes que estiverem participando do teste de descontinuação da redução, sugerimos permitir o acesso de todos os domínios de terceiros à string do user agent completa. Se o acesso dos domínios de terceiros não for estendido à string completa do user agent, o acesso total à string será bloqueado, independentemente do registro do teste de descontinuação de redução próprio. É possível permitir o acesso total da string de user agent a domínios de terceiros seguindo uma destas duas opções:

    • Adicione um cabeçalho Permissions-Policy com os domínios de terceiros que precisam receber a string completa do user agent.
      • Para permitir todos os domínios de terceiros, adicione Permissions-Policy: ch-ua-full=*.
      • Para permitir uma lista nomeada de domínios de terceiros, adicione Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
    • Adicione uma metatag Accept-CH com os domínios de terceiros que devem receber a string do user agent completa (somente no Chrome 100 e versões mais recentes).
      • Para permitir uma lista nomeada de domínios de terceiros, adicione <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
      • Não é possível delegar a todos os domínios de terceiros usando * na metatag.

  5. Carregue seu site no Chrome 100 (ou posterior) e continue recebendo a string do user agent completa.

Demonstração

Acesse https://uard-ot-demo.glitch.me para conferir uma demonstração do teste (junto com o código-fonte).

Como confirmo se o teste está funcionando?

Para confirmar que o teste de origem está funcionando, examine os cabeçalhos da solicitação e verifique o seguinte:

  1. O cabeçalho do user agent contém a versão completa. Ele não conterá nenhum dos valores reduzidos (encontrados na lista de amostras de strings user agent reduzidas). Uma maneira fácil de saber é que a string da versão secundária do Chrome não pode ser 0.0.0.
  2. O cabeçalho Sec-CH-UA-Full está definido como ?1.

Os cabeçalhos da resposta inicial contendo o token do teste de origem devem ter esta aparência:

Os cabeçalhos de solicitação subsequentes contendo a string completa do user agent devem ter a seguinte aparência:

Como faço para parar de participar do teste de descontinuação da Redução de user agent?

Você pode parar de participar do teste a qualquer momento e receber a string do user agent reduzida. Para deixar de participar:

  1. Envie um cabeçalho Accept-CH na resposta HTTP que não inclua Sec-CH-UA-Full. Observe que Accept-CH com um valor vazio é uma maneira válida de fazer isso se seu site não solicitar outras dicas de cliente.
  2. Remova o cabeçalho Origin-Trial do teste de descontinuação de redução do user agent da sua resposta HTTP.
  3. Se definido, remova Sec-CH-UA-Full do cabeçalho Critical-CH na sua resposta HTTP.

Qual é a diferença entre esse teste e outros testes de origem do user agent?

O Chrome está executando dois testes de origem relacionados à redução do user agent. O primeiro foi o teste de origem de redução do user agent, que permitia que os sites recebessem a string do user agent reduzida para testar os casos de uso e enviar feedback antes que isso se tornasse o comportamento padrão no Chrome.

O segundo é um teste de descontinuação destinado a sites que precisam de um pouco mais de tempo para migrar para a API User-Agent Client Hints. Isso permite que os sites continuem recebendo a string do user agent completa.

Qual é a duração do teste de descontinuação?

O teste de descontinuação da redução do user agent vai ser executado do Chrome 100 ao Chrome 115. O Chrome 116 será a primeira versão em que apenas a string user agent completamente reduzida será enviada.

Como posso compartilhar feedback sobre o teste de descontinuação da redução do user agent?

Envie qualquer problema ou feedback para o repositório de redução de user agent do GitHub (em inglês).