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

O teste de descontinuação da redução do 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) vão ser reduzidas usando uma abordagem por fases. Os sites que não tiveram tempo de migrar da string user agent reduzida para as dicas de cliente do user agent podem participar de um teste de descontinuação para continuar recebendo a string completa.

O registro para o teste de descontinuação vai começar com o Chrome 100 Beta. Isso permitirá que os sites recebam a string completa do user agent 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 do canal estável, faça o registro e o teste antes da data de lançamento do Chrome 100 (atualmente agendada 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 feedback ou encontrar algum problema durante o teste, informe no repositório do GitHub da redução de UA.

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:

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

Os sites ainda precisam auditar o uso do cabeçalho User-Agent e das APIs relacionadas e, se necessário, se preparar para migrar para as dicas do cliente User-Agent antes que o teste de descontinuação expire. A intenção é encerrar esse teste de descontinuação quando o lançamento da redução do user agent for concluído.

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

Fazer inscrição no teste

Para se inscrever no teste de origem e receber um token para seus domínios, acesse a página de teste de descontinuação da redução do user agent. Se você é um terceiro que está fazendo o registro, marque "Correspondência de terceiros".

Configuração

Depois de se registrar no teste, atualize os 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 para o teste de origem.
  2. Adicione Accept-CH: Sec-CH-UA-Full ao cabeçalho de resposta HTTP. A configuração 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 participarem do teste de redução da descontinuação, sugerimos permitir que todos os domínios de terceiros acessem a string completa do user agent. Se o acesso à string completa do user agent não for estendido aos domínios de terceiros, o acesso completo à string do user agent será bloqueado, independentemente do registro de teste de descontinuação de redução. É possível permitir o acesso completo da string do user agent a domínios de terceiros usando uma das seguintes 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 precisam receber a string completa do User-Agent (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 mais recente) e continue recebendo a string completa do user agent.

Demonstração

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

Como posso validar se o teste está funcionando?

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

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

Os cabeçalhos da resposta inicial que contêm o token de teste de origem devem ser semelhantes a este:

Os cabeçalhos da resposta inicial que contêm o token de teste de origem.

Os cabeçalhos de solicitação subsequentes que contêm a string completa User-Agent devem ter a seguinte aparência:

Os cabeçalhos de solicitação subsequentes que contêm a string completa do User-Agent.

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

A qualquer momento durante o teste, você pode parar de participar e receber a string User-Agent reduzida. Para parar de participar:

  1. Envie um cabeçalho Accept-CH na resposta HTTP que não inclua Sec-CH-UA-Full. Accept-CH com um valor vazio é uma maneira válida de fazer isso se o site não solicitar outras dicas de cliente.
  2. Remova o cabeçalho Origin-Trial do teste de descontinuação da redução do user agent da sua resposta HTTP.
  3. Se definido, remova Sec-CH-UA-Full do cabeçalho Critical-CH na 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 da redução do user agent, que permitiu que os sites recebessem a string do user agent reduzida para testar os casos de uso e enviar feedback antes que ela se torne o comportamento padrão no Chrome.

O segundo, mencionado aqui, é 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 completa do User-Agent.

Por quanto tempo o teste de descontinuação vai durar?

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 do user agent totalmente reduzida será enviada.

Como faço para compartilhar feedback sobre o teste de redução do user agent?

Envie problemas ou feedback ao repositório do GitHub sobre redução de User-Agent.