1
0
mirror of https://github.com/lancedikson/bowser synced 2024-09-28 06:10:45 +00:00
lancedikson_bowser/README.md

1.8 KiB

Bowser

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

So... it works like this:

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

Detected Browsers

  • android
  • blackberry
  • chrome[webkit]
  • firefox[gecko]
  • ipad
  • iphone
  • ipod
  • msie
  • opera
  • phantomjs
  • safari[webkit]
  • seamonkey
  • touchpad
  • webos
  • windows phone

Notes

Safari, Chrome, and Firefox will report that they have webkit|gecko engines

if (bowser.webkit) {
  // do stuff with safari & chrome
}

Ender installation

If you don't already have Ender (an npm package) install it now (and don't look back)

$ npm install ender

then add bowser to your module collection

$ ender add bowser

use it like this:

if ($.browser.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)
}

Building

Simply $ npm install and $ make inside the bowser folder.

Testing

We started a list 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.

To run the test call $ make test and hope for green light ;)