Neste artigo
O que é uma string User Agent?
Uma string User Agent é um identificador de texto que os navegadores e clientes HTTP enviam com cada requisição. Ela informa ao servidor qual navegador, sistema operacional e dispositivo está fazendo a requisição. Por exemplo, o Chrome no Windows envia uma string contendo a versão do navegador, o motor de renderização e a versão do sistema operacional.
As strings User Agent seguem um formato vagamente definido que se tornou mais complexo ao longo do tempo. Strings modernas frequentemente contêm tokens de compatibilidade de navegadores antigos, tornando-as difíceis de analisar manualmente. Um parser dedicado extrai dados estruturados desse texto confuso.
Como funciona a análise de User Agent
Um parser de User Agent decompõe a string bruta em componentes estruturados usando correspondência de padrões e bases de dados de assinaturas conhecidas. O resultado é um objeto limpo com detalhes do navegador, sistema operacional, dispositivo e motor.
- Detecção do navegador — identifica o nome e a versão do navegador ao combinar tokens conhecidos como Chrome/, Firefox/ ou Safari/
- Identificação do SO — extrai o sistema operacional e sua versão dos tokens de plataforma como Windows NT 10.0 ou Mac OS X
- Classificação do dispositivo — determina se o cliente é um desktop, móvel, tablet ou bot com base em marcadores específicos do dispositivo
Experimente gratuitamente — sem cadastro
Analisar uma string User Agent →Quando usar a análise de User Agent
Os dados de User Agent ajudam você a entender seu público e adaptar sua aplicação a diferentes ambientes.
- Analytics — rastreie a distribuição de navegadores e sistemas operacionais entre seus usuários para priorizar testes e suporte
- Serviço adaptativo — sirva recursos otimizados (imagens, scripts) com base no tipo de dispositivo detectado ou nas capacidades do navegador
- Detecção de bots — identifique crawlers, scrapers e ferramentas automatizadas por suas assinaturas de User Agent para aplicar limitação de taxa ou servir conteúdo diferente
Perguntas frequentes
As strings User Agent podem ser falsificadas?
Sim. Qualquer cliente HTTP pode enviar qualquer string User Agent. Extensões de navegador e ferramentas de desenvolvedor tornam a falsificação trivial. Por essa razão, os dados de User Agent devem ser usados para analytics e melhoria progressiva, não para decisões de segurança ou controle de acesso.
O que são Client Hints e eles substituem os User Agents?
Client Hints (cabeçalhos Sec-CH-UA) são uma alternativa estruturada mais recente proposta por navegadores baseados em Chromium. Eles fornecem dados do navegador, plataforma e dispositivo em cabeçalhos separados. No entanto, a adoção é incompleta — Firefox e Safari têm suporte limitado — portanto, as strings User Agent permanecem a alternativa universal.
Como detecto dispositivos móveis de forma confiável?
A abordagem mais confiável combina análise de User Agent com detecção de recursos. Analise a string UA em busca de palavras-chave móveis (Mobile, Android, iPhone) e também verifique o tamanho da tela ou suporte de toque via JavaScript. Nenhum método sozinho é 100% preciso, mas juntos cobrem a grande maioria dos casos.