Analice una cadena User-Agent: navegador, SO y dispositivo

Este analizador la convierte en un resultado predecible con el nombre y la versión del navegador, el sistema operativo y su versión, y una categoría práctica de dispositivo. Emplea reglas transparentes y deterministas, por lo que una misma entrada siempre genera la misma salida, sin consultas de red, aleatoriedad, toma de huellas ni enriquecimiento oculto.

Proporcione la cabecera completa siempre que sea posible

Pegue el valor de la cabecera HTTP User-Agent en el campo user_agent e incluya todos los identificadores de producto y la sección de plataforma entre paréntesis. Las cadenas completas aportan pruebas suficientes para distinguir navegadores que comparten tecnología de renderizado. Por ejemplo, las cadenas actuales de Edge, Opera, Samsung Internet y Chrome pueden contener el identificador Chrome; por eso, el analizador busca primero los identificadores más específicos y solo después acepta la coincidencia genérica de Chrome. El orden también importa para Firefox y Chrome en iOS, cuyas cadenas difieren de las versiones de escritorio debido a los requisitos de la plataforma de Apple. Se ignoran los espacios al principio y al final, pero una cadena vacía o formada solo por espacios se rechaza como entrada no válida, porque no existe nada que clasificar. El analizador no contacta con el dispositivo, no consulta la dirección IP, no inspecciona Client Hints ni combina la cadena con otros identificadores. Si necesita versiones, proporcione la cabecera original en lugar de una etiqueta abreviada. Una cadena recortada o desconocida puede aceptarse, pero los campos sin pruebas reconocibles se devuelven como Desconocido y con versión nula, sin inventar datos.

Comprenda las reglas del navegador y del sistema operativo

La detección sigue una tabla de prioridad fija basada en identificadores habituales de User-Agent. Los identificadores específicos Edg, OPR, SamsungBrowser, CriOS y FxiOS se evalúan antes que los patrones generales de Chrome, Firefox y Safari. Así se evita clasificar erróneamente un navegador basado en Chromium solo porque su cabecera incluye Chrome por compatibilidad. Para Safari se utiliza Version, ya que el identificador Safari independiente describe la familia del producto y no la versión pública del navegador. El sistema operativo se analiza de forma similar: Windows Phone se comprueba antes que Windows de escritorio, Android antes que Linux genérico e iOS antes que los fragmentos de compatibilidad de macOS. Los guiones bajos de las versiones de Apple se convierten en puntos. Los valores Windows NT se asocian a versiones conocidas cuando existe una equivalencia convencional fiable; Windows NT 10.0 se muestra deliberadamente como «10 o 11», porque la cabecera tradicional no permite diferenciarlos con fiabilidad. Son reglas conocidas, no afirmaciones probabilísticas. Los productos nuevos, cadenas reducidas por privacidad, vistas web integradas y variantes de fabricantes pueden producir Desconocido o una familia general hasta que exista una señal identificable. Esta prudencia resulta más segura que inventar precisión.

Use el tipo de dispositivo como categoría práctica, no como identidad

El resultado device_type es una categoría operativa amplia: escritorio, móvil, tableta, bot o desconocido. Los indicadores de tableta se evalúan antes que los indicadores móviles generales porque muchas tabletas Android incluyen Android, pero omiten deliberadamente Mobile. Los teléfonos reconocidos, iPhone, iPod, Windows Phone y otros identificadores móviles se clasifican como móvil. Los términos habituales de rastreadores producen bot, algo útil para resumir registros, aunque no sustituye controles de abuso por capas ni la autenticación de rastreadores verificados. Un sistema operativo o navegador de escritorio reconocible se clasifica de forma predeterminada como escritorio; una cadena sin pruebas conocidas del navegador ni del sistema devuelve desconocido. Estas categorías describen lo que el emisor declara, no un dispositivo físico verificado. Las cadenas User-Agent pueden modificarse, los clientes automatizados pueden imitar navegadores y las funciones modernas de privacidad reducen los detalles deliberadamente. Use el resultado para informes, enriquecimiento de registros, pistas de compatibilidad o una experiencia inicial razonable. No lo use como límite de seguridad, huella única ni prueba de propiedad. Cuando una decisión afecte al acceso, los pagos o el fraude, aplique autorización en el servidor y señales de riesgo específicas.