User Agent Generator

Easily generate accurate user-agent strings for popular browsers.

Installing

npm install useragent-generator

Usage

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

Table of Contents

Chrome

• ua.chrome(options)
• ua.chrome.androidPhone(options)
• ua.chrome.androidTablet(options)
• ua.chrome.iOS(options)
• ua.chrome.androidWebview(options)
• ua.chrome.chromecast(options)

Chromium

• ua.chromium(options)

Firefox

• ua.firefox(options)
• ua.firefox.androidPhone(options)
• ua.firefox.androidTablet(options)
• ua.firefox.iOS(options)

Safari

• ua.safari(options)
• ua.safari.iOS(options)
• ua.safari.iOSWebview(options)

Internet Explorer

• ua.ie(options)
• ua.ie.windowsPhone(options)

Microsoft Edge

• ua.edge(options)

Search Engines

• ua.googleBot(options)
• ua.bingBot(options)
• ua.yahooBot()

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