Analise uma string User-Agent: navegador, SO e dispositivo

Este analisador transforma essa linha em um resultado previsível com nome e versão do navegador, sistema operacional e versão, além de uma categoria prática de dispositivo. Ele aplica regras transparentes e determinísticas; assim, a mesma entrada sempre gera a mesma saída, sem consulta de rede, aleatoriedade, impressão digital ou enriquecimento oculto.

Forneça o cabeçalho completo sempre que possível

Cole o valor do cabeçalho HTTP User-Agent no campo user_agent, incluindo todos os tokens de produto e a seção de plataforma entre parênteses. Strings completas oferecem evidências suficientes para diferenciar navegadores que compartilham uma linhagem de renderização. Por exemplo, strings atuais do Edge, Opera, Samsung Internet e Chrome podem conter o token Chrome; por isso, o analisador verifica primeiro os identificadores mais específicos e só então aceita a correspondência genérica do Chrome. A ordem também importa para Firefox e Chrome no iOS, cujas strings diferem das versões para desktop devido às exigências da plataforma Apple. Espaços no início e no fim são ignorados, mas um valor vazio ou composto apenas por espaços é rejeitado como entrada inválida, pois não há nada significativo para classificar. O analisador não entra em contato com o dispositivo, não consulta o endereço IP, não examina Client Hints e não combina a string com outros identificadores. Caso você precise das versões, envie o cabeçalho original em vez de um rótulo abreviado. Uma string reduzida ou desconhecida ainda pode ser aceita, mas campos sem evidência reconhecível retornam Desconhecido e versão nula, sem adivinhação.

Entenda as regras de navegador e sistema operacional

A detecção segue uma tabela fixa de precedência baseada em tokens comuns de User-Agent. Tokens específicos como Edg, OPR, SamsungBrowser, CriOS e FxiOS são avaliados antes dos padrões amplos de Chrome, Firefox e Safari. Isso evita que um navegador baseado em Chromium seja rotulado incorretamente apenas porque inclui Chrome por compatibilidade. No Safari, usa-se o token Version, pois o token Safari separado descreve a família do produto, e não a versão pública do navegador. A análise do sistema operacional também verifica Windows Phone antes do Windows para desktop, Android antes do Linux genérico e iOS antes de fragmentos de compatibilidade do macOS. Sublinhados nas versões Apple são normalizados como pontos. Valores Windows NT são associados a versões familiares quando existe uma correspondência convencional confiável; Windows NT 10.0 é informado como “10 ou 11”, pois o cabeçalho legado sozinho não separa essas versões com segurança. Essas são regras de padrões conhecidos, não conclusões probabilísticas. Produtos novos, strings reduzidas por privacidade, web views incorporadas e variantes de fabricantes podem resultar em Desconhecido ou em uma família ampla até haver um sinal identificável. Esse comportamento conservador é mais seguro do que inventar precisão.

Use o tipo de dispositivo como categoria prática, não como identidade

O resultado device_type é uma categoria operacional abrangente: desktop, celular, tablet, bot ou desconhecido. Indicadores de tablet são avaliados antes dos indicadores gerais de celular porque muitos tablets Android incluem Android, mas omitem Mobile de propósito. Telefones reconhecidos, iPhone, iPod, Windows Phone e outros tokens móveis retornam celular. Termos conhecidos de rastreadores retornam bot, o que ajuda em resumos de logs, mas não substitui controles de abuso em camadas nem a autenticação de rastreadores verificados. Um navegador ou sistema operacional de desktop reconhecível assume desktop; uma string sem evidência conhecida de navegador ou sistema retorna desconhecido. Essas categorias representam o que o remetente decidiu declarar, e não um dispositivo físico verificado. Valores User-Agent podem ser modificados, clientes automatizados podem imitar navegadores e recursos modernos de privacidade reduzem detalhes intencionalmente. Use o resultado em relatórios, enriquecimento de logs, dicas de compatibilidade ou para escolher uma experiência inicial sensata. Não o utilize como barreira de segurança, impressão digital exclusiva ou prova de propriedade. Quando decisões afetarem acesso, pagamentos ou fraude, combine autorização no servidor e sinais de risco específicos.