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:
- 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. - Adicione
Accept-CH: Sec-CH-UA-Full
ao cabeçalho de resposta HTTP. DefinirAccept-CH
só fará com que a string completa do user agent seja enviada em solicitações subsequentes para a origem. - 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çalhosAccept-CH
eOrigin-Trial
. 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")
.
- Para permitir todos os domínios de terceiros, adicione
- 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.
- Para permitir uma lista nomeada de domínios de terceiros, adicione
- Adicione um cabeçalho
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:
- 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
. - 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:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/blog/AIlPxFBDvO7jQrXuKfWU.png?authuser=8&hl=pt-br)
Os cabeçalhos de solicitação subsequentes contendo a string completa do user agent devem ter a seguinte aparência:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/blog/Hzi5O1mZQyZEKeokCQSe.png?authuser=8&hl=pt-br)
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:
- Envie um cabeçalho
Accept-CH
na resposta HTTP que não incluaSec-CH-UA-Full
. Observe queAccept-CH
com um valor vazio é uma maneira válida de fazer isso se seu site não solicitar outras dicas de cliente. - Remova o cabeçalho
Origin-Trial
do teste de descontinuação de redução do user agent da sua resposta HTTP. - Se definido, remova
Sec-CH-UA-Full
do cabeçalhoCritical-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).