Voltar ao blog

O que são User-Agent e Client Hints: informações, privacidade e compatibilidade

Sites podem obter dados por User-Agent, JavaScript e Client Hints. Entenda diferenças, dados padrão e solicitados, por que alterar UA não altera todo o ambiente e como investigar seu site.

User-Agent descreve o navegador para um site, mas não é uma identidade do dispositivo. Sites modernos também podem ler interfaces JavaScript, Client Hints e condições de execução. Mudar a string UA não altera sistema, capacidades ou todos os sinais visíveis.

Desenvolvedores devem oferecer funções segundo capacidades reais. Usuários e equipes precisam entender quais informações são expostas e o que elas permitem ou não concluir.

Por que UA é fácil de interpretar errado

O cabeçalho User-Agent costuma incluir marcas de navegador e plataforma; scripts leem navigator.userAgent. Por compatibilidade histórica pode conter vários produtos, que não são navegadores atuais independentes.

UA pode ser reduzido, modificado ou reescrito por intermediários. Procurar uma palavra para decidir funções pode bloquear um navegador capaz.

Se uma página precisa enviar arquivos, teste interfaces e comportamento em vez de confiar no nome. UA é uma pista limitada, não substitui detecção de recursos.

O que muda com Client Hints

A explicação do Chrome sobre User-Agent Client Hints apresenta solicitações estruturadas. Em vez de interpretar uma string longa, o site pede campos necessários; o navegador decide o que fornecer segundo suas políticas.

É preciso separar interface e transporte.

OrigemOnde apareceO que verificar
User-AgentCabeçalho HTTPValor realmente enviado naquela requisição
navigator.userAgentJavaScript da páginaString lida pelo script atual
Indicações como Sec-CH-UARequisições de navegadores compatíveisEnvio, significado e condições de solicitação
navigator.userAgentDataAmbientes de script compatíveisExistência e campos disponíveis

Cabeçalhos e scripts observam pontos diferentes. CDN, proxy, cache e logs podem representar camadas distintas. Defina a origem antes de comparar.

Baixa e alta entropia não significam confiável e não confiável

Entropia representa a quantidade de informação diferenciadora. Não garante exatidão nem indica risco de conta.

A documentação NavigatorUAData da MDN separa propriedades básicas de dados adicionais solicitados assincronamente e lembra a compatibilidade. Mais campos não significam inventário completo, preciso e imutável recebido por padrão.

No seu site, pergunte por que cada campo é necessário. Prefira layout responsivo e detecção de capacidades. Não colete tudo apenas porque há uma interface.

Veja informações básicas no navegador

O exemplo lê somente dados locais e não envia nada a servidor externo. Execute em página própria de teste ou nas ferramentas de desenvolvimento.

const browserInfo = {
  userAgent: navigator.userAgent,
  hints: navigator.userAgentData?.toJSON() ?? null,
};

console.log(browserInfo);

Se hints for null, examine suporte e contexto antes de concluir defeito. Navegadores, versões e contextos variam; a página precisa de alternativa razoável.

No painel Rede, selecione uma requisição específica. Não misture saída do script com outra requisição, aba ou registro antigo do cache.

Verifique a cadeia ao pedir mais indicações

O servidor pode solicitar dados com Accept-CH. É necessário verificar em tráfego real se chegam, em qual requisição e se o navegador permite. HTTPS, suporte e políticas afetam disponibilidade.

Confira a solicitação na resposta e depois os campos nas requisições seguintes. Com CDN ou cache, verifique a separação de variantes para não entregar a um navegador uma resposta preparada para outra condição.

Campo ausente na primeira requisição não prova “disfarce falho”. Pode ser resultado normal do suporte ou da negociação.

Por que mudar UA não muda todo o ambiente

UA é só um sinal. Idioma, fuso, janela, gráficos, fontes, extensões e dados do site afetam a página por outros meios. Um ajuste não altera todas as camadas automaticamente.

Escrever o nome de um celular não dá ao computador seu toque, layout ou hardware. Exibir controles móveis só pela string pode gerar problemas de compatibilidade.

Priorize configuração estável e registros rastreáveis em vez de alterações aleatórias frequentes. Regras, segurança de login e operações autorizadas continuam exigindo gestão separada.

Investigue em equipe “mesma conta, página diferente”

Anote ambiente, versão, URL, horário e função afetada; colete apenas o mínimo pertinente. Mude uma condição por vez ao comparar o normal e o problemático.

No PurpleMark, confira sistema, motor, User-Agent, idioma e fuso, e abra o teste no ambiente correspondente. Agrupar por cliente ou uso facilita relacionar a revisão ao trabalho.

Uma pontuação de site de detecção não garante segurança nem restrição. A página observa somente os sinais testados, não o comportamento completo do destino ou decisões internas da plataforma.

Checklist para desenvolvedores

  • Detecte capacidades das funções críticas; limite UA à compatibilidade necessária e delimitada.
  • Ofereça alternativas funcionais sem Client Hints, não páginas vazias inutilizáveis.
  • Diferencie cabeçalhos, scripts e logs processados por intermediários.
  • Peça só dados relevantes e trate-os conforme o aviso de privacidade real.
  • Após atualizar, repita páginas e entradas, sem atribuir toda diferença à impressão digital.

Entender UA e Client Hints reduz conclusões equivocadas. São sinais condicionais com limites de compatibilidade; interpretá-los em tarefas reais melhora compatibilidade e privacidade.