1
0
mirror of https://github.com/lancedikson/bowser synced 2024-10-27 20:34:22 +00:00
Go to file
Blake 27cab64589 Update ReadMe with installation instructions
Added bower installation instructions. I wanted to install this way when I came across the repo, but wasn't sure if it existed, so had to google around for a bit to find out. Seems like it should just be stated up front. Great library! Thanks!
2014-04-10 17:24:17 -07:00
make rebuild and new relase for IE, Opera, & Phantom 2013-08-16 12:58:39 -07:00
src updates tests to reflect new browser groups 2014-04-07 16:59:27 -07:00
test Merge branch 'origin/stable' into make-testable-and-add-tests 2014-02-20 09:34:55 +01:00
.gitignore boosh 2011-04-27 15:14:35 -07:00
.travis.yml new travis integration 2014-02-22 13:30:03 -08:00
bowser.js updates tests to reflect new browser groups 2014-04-07 16:59:27 -07:00
bowser.min.js updates tests to reflect new browser groups 2014-04-07 16:59:27 -07:00
component.json adding component.json for component.js support 2014-03-31 17:42:59 -05:00
Makefile Make testable and add tests. 2013-12-16 06:42:26 +01:00
package.json 0.7.1 2014-04-07 16:59:39 -07:00
README.md Update ReadMe with installation instructions 2014-04-10 17:24:17 -07:00

Bowser

A Browser detector. Because sometimes, there is no other way, and not even good modern browsers always provide good feature detection mechanisms.

Install with bower install bowser

bowser ci

So... it works like this:

if (bowser.msie && bowser.version <= 6) {
  alert('Hello China');
}

Flags set for detected Browsers[Engines]

  • chrome[webkit]
  • firefox[gecko]
  • msie
  • Android native browser as android[webkit]
  • iOS native browser as ios[webkit]
  • opera[webkit if >12]
  • phantomjs[webkit]
  • safari[webkit]
  • seamonkey[gecko]
  • BlackBerry native browser as blackberry[webkit]
  • WebOS native browser as webos[webkit]
  • Amazon Kindle browser as silk[webkit]
  • Bada browser as bada[webkit]
  • Tizen browser as tizen[webkit]
  • Sailfish browser as sailfish[gecko]

For all detected browsers the browser version is set in the version field.

Flags set for detected mobile Operating Systems

  • android
  • Windows Phone as windowsphone
  • ios (iphone/ipad/ipod)
  • blackberry
  • firefoxos
  • webos (touchpad)
  • bada
  • tizen
  • sailfish

Android, iOS, Windows Phone, WebOS, Bada, and Tizen will all report the OS version number if it is contained in the UA string in the osversion field. iOS is always reported as ios and additionally as iphone/ipad/ipod, whichever one matches best. If WebOS device is an HP TouchPad the flag touchpad is additionally set.

All detected mobile OSes are additionally flagged mobile, if they are not powering a tablet device. If a tablet device is detected, the flag tablet is set instead.

Notes

Safari, Chrome and some other minor browsers will report that they have webkit engines, Firefox and Seamonkey will report that they have gecko engines.

if (bowser.webkit) {
  // do stuff with safari & chrome & opera & android & blackberry & webos & silk
}

Ender Support

package.json

"dependencies": {
  "bowser": "x.x.x"
}
if (require('bowser').chrome) {
  alert('Hello Silicon Valley')
}

Graded Browser Support

One useful feature of Bowser is that aside from checking one browser from another -- it will keep up to date with Yahoo's Graded Browser Support chart, giving you access to each grade on the bowser object

if (bowser.a) {
  // support full feature set
}
else if (bowser.c) {
  // serve degraded version
}
else {
  // unsupported (bowser.x)
}

Contributing

If you'd like to contribute a change to bowser, modify the files in src/, then run the following (you'll need node + npm installed):

$ npm install
$ make test

Please do not check-in the built files bowser.js and bowser.min.js in pull requests.

Adding tests

See the list in src/useragents.js with example user agents and their expected bowser object.

Whenever you add support for new browsers or notice a bug / mismatch, please update the list and check if all tests are still passing.