/useragent-generator

Easily generate correct user-agent strings for popular browsers

Primary LanguageJavaScript

User Agent Generator

Travis npm

Easily generate accurate user-agent strings for popular browsers.

Installing

npm install useragent-generator

Usage

const ua = require('useragent-generator')
// ...

Table of Contents

Chrome

Chromium

Firefox

Safari

Internet Explorer

Microsoft Edge

Search Engines

Chrome

ua.chrome(options)

Examples
ua.chrome(60)
ua.chrome('61.0.0')
ua.chrome({ version: '61.0.0', os: 'Windows NT 6.3' })
Param Type Default Value
options.version string —
options.os string Windows NT 6.4 (Windows 10)

ua.chrome.androidPhone(options) / ua.chrome.androidTablet(options)

Examples
ua.chrome.androidPhone(60)
ua.chrome.androidPhone('61.0.0')
ua.chrome.androidPhone({ version: '61.0.0', androidVersion: '6.2.1', device: 'Nexus 6' })

ua.chrome.androidTablet(60)
ua.chrome.androidTablet('61.0.0')
ua.chrome.androidTablet({ version: '61.0.0', androidVersion: '6.2.1', device: 'SM-T210' })
Param Type Default Value
options.version string —
options.androidVersion string 7.0.0 (Nougat)
options.device string Pixel (Phone) / Pixel C (Tablet)

ua.chrome.iOS(options)

Examples
ua.chrome.iOS(10) // iOS version
ua.chrome.iOS('10.0.1') // iOS version
ua.chrome.iOS({ iOSVersion: '10.0.1', iOSVersion: '62.1.0', device: 'iPad' })
Param Type Default Value
options.iOSVersion string —
options.chromeVersion string 60.0.0.0
options.device string iPhone

ua.chrome.androidWebview(options)

Examples
ua.chrome.androidWebview(4) // Android OS version
ua.chrome.androidWebview('4.4') // Android OS version
ua.chrome.androidWebview({ androidVersion: '5.0.0', chromeVersion: '60.1.0', device: 'Nexus 6' })
Param Type Default Value
options.androidVersion string —
options.chromeVersion string 60.0.0.0 (applicable only for Android 4.4 (Kitkat) and above)
options.device string Pixel

ua.chrome.chromecast(options)

Example
ua.chrome.chromecast(62) 
ua.chrome.chromecast('62.1.0') // Android OS version
ua.chrome.chromecast({ version: '62.1.0' })
Param Type Default Value
options.version string —

Chromium

ua.chromium(options)

Same as ua.chrome

Firefox

ua.firefox(options)

Examples
ua.firefox(52) 
ua.firefox('52.4') 
ua.firefox({ version: '53.4.1', os: 'Windows NT 6.3' })
Param Type Default Value
options.version string —
options.os string Windows NT 6.4 (Windows 10)

ua.firefox.androidPhone(options) / ua.firefox.androidTablet(options)

Examples
ua.firefox.androidPhone(52)
ua.firefox.androidPhone('52.4')
ua.firefox.androidPhone({ version: '52.4.1', androidVersion: '6.2.1', device: 'Nexus 6' })

ua.chrome.androidTablet(60)
ua.chrome.androidTablet('61.0.0')
ua.chrome.androidTablet({ version: '52.4.1', androidVersion: '6.2.1', device: 'SM-T210' })
Param Type Default Value
options.version string —
options.androidVersion string 7.0.0 (Nougat)
options.device string Pixel (Phone) / Pixel C (Tablet)

ua.firefox.iOS(options)

Examples
ua.firefox.iOS(10) // iOS version
ua.firefox.iOS('10.0.1') // iOS version
ua.firefox.iOS({ iOSVersion: '10.0.1', device: 'iPad' })
Param Type Default Value
options.iOSVersion string —
options.device string iPhone

Safari

ua.safari(options)

Examples
ua.safari(10) 
ua.safari('10.1.0') 
ua.safari({ version: '10.3.1', os: 'Macintosh; Intel Mac OS X 10_11' })
Param Type Default Value
options.version string —
options.os string Macintosh; Intel Mac OS X 10_11 (Mac OS X El Capitan)

ua.safari.iOS(options)

Examples
ua.safari.iOS(10) // iOS version
ua.safari.iOS('10.0.1') // iOS version
ua.safari.iOS({ iOSVersion: '10.0.1', safariVersion: '10.3.0', device: 'iPad' })
Param Type Default Value
options.iOSVersion string —
options.safariVersion string (equal to iOSversion)
options.device string iPhone

ua.safari.iOSWebview(options)

Examples
ua.safari.iOSWebview(10) // iOS version
ua.safari.iOSWebview('10.0.1') // iOS version
ua.safari.iOSWebview({ iOSVersion: '10.0.1', safariVersion: '10.3.0', device: 'iPad' })
Param Type Default Value
options.iOSVersion string —
options.safariVersion string (equal to iOSversion)
options.device string iPhone

Internet Explorer

ua.ie(options)

Examples
ua.ie(9) 
ua.ie('9.0.1') 
ua.ie({ version: '9.0.1', os: 'Windows NT 6.3' })
Param Type Default Value
options.version string —
options.os string Windows NT 6.4 (Windows 10)

ua.ie.windowsPhone(options)

Examples
ua.ie(9) 
ua.ie('9.0.1') 
ua.ie({ version: '9.0.1', os: 'Lumia 625' })
Param Type Default Value
options.version string —
options.device string Lumia 630

Microsoft Edge

ua.edge(options)

Examples
ua.edge(12) 
ua.edge('12.0.1') 
ua.edge({ version: '12.0.1', chromeVersion: '62.0.1', os: 'Windows NT 6.3' })
Param Type Default Value
options.version string —
options.chromeVersion string 52.0.0.0
options.os string Windows NT 6.4 (Windows 10)

Search Engines

Examples
ua.googleBot()
ua.bingBot()
ua.yahooBot()

ua.googleBot('2.0')
ua.bingBot('2.1')

ua.googleBot(options) — GoogleBot

Param Type Default Value
options.version string (optional) '2.1'

ua.bingBot(options) — BingBot

Param Type Default Value
options.version string (optional) '2.0'

ua.yahooBot() — YahooBot