ua-device-detector

#ua-device-detector

##




$3

\$ bower i ua-device-detector -S

$3

``javascript
var uaDeviceDetector=require('ua-device-detector');
.
.
.
var deviceInfo=uaDeviceDetector.parseUserAgent(options);
`

$3

Add script load to HTML:

`html


`

Then use in your javascript:

`javascript
var deviceInfo = window.uaDeviceDetector.parseUserAgent(options);
`

To use from angular:

Don't - Instead use ng-device-detector :)

Usage with Webpack:

An issue with webpack might cause an error like this:

`diff
- Critical dependency: require function is used in a way in which dependencies cannot be statically extracted
`

To solve add this to your webpack.config.js:

`js
module.exports = {
module: {
unknownContextCritical: false
}
};
`

More details here

$3

parseUserAgent options specification:

- userAgent: (string, required) user agent string to parse
- customDetectors: ([object], optional) array of custom detectors:
- name: (string, required) name of detector as it will appear in deviceInfo
- re: (string|regex|reTree expression, required) the expression to use for detecting
- platform: (string, optional) platform name as returned by navigator.platform
- maxTouchPoints: (string, optional) maxTouchPoints as returned by navigator.maxTouchPoints`

parseUserAgent returns a deviceInfo object:

- raw
- userAgent (string) - raw user agent
- os (object) - true/false detections per os
- browser (object) - true/false detections per browser
- device (object) - true/false detections per device
- os (string) - detected os
- browser (string) - detected browser
- device (string) - detected device
- os_version (string) - detected os version
- browser_version (string) - detected browser version
- isMobile() - returns true if device is mobile. false otherwise
- isTablet() - returns true if device is tablet. false otherwise
- isDesktop() - returns true if device is desktop. false otherwise
- custom (object) - true/false result of detection per custom detector

$3

Pull-requests with new stuff will be highly appreciated :)

Please remember to add tests when making changes.

$3

MIT License