README

uainfer

This is a simple JavaScript library (MIT License) to infer the user agent from its claimed User-Agent string. The objective of uainfer to provide a human-friendly answer to the inquiry "What browser am I using?".

In the context of a web browser, the most common way to obtain the User-Agent string is from the value of navigator.userAgent. In the context of an HTTP server, it can be retrieved from the User-Agent header field in the HTTP request.

Example usage with Node.js REPL (or ):

> uainfer = require('uainfer');
> ua = uainfer.analyze('Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.2)'
> ua.toString()
'Internet Explorer 7 on Windows XP'

(To use this library in a front-end application, see this JSFiddle demo)

For browsers utilizing Chrome/Blink engine (Samsung Browser, Opera, Vivaldi, etc), the result can contain the corresponding equivalent version of Chrome:

> console.log(ua)
UserAgent {
  browser:
   { name: 'Vivaldi',
     version: 1.96,
     fullVersion: '1.96.1147.52',
     chromeFamily: { version: 65, fullVersion: '65.0.3325.183' } },
  os: { name: 'Windows', version: '10' } }

Non-goals:

Recognize every single web browsers and obscure user agents out there.
Deduce other information such as CPU type, device, form factor, etc.

Design choices:

For a better maintenance, avoid regular expressions.
Always expand its small but fairly extensive test suite.
Keep it tidy and lightweight (4 KB when minified).

This library is created and maintained by @AriyaHidayat.

Usage no npm install needed!

README

uainfer