##where.js
A weightless library ( 1 KB gzipped ) for recognising the browser and the OS/platform you are running your JS in.
It currently recognises :
------------- OS -------------
- mac ( retina )
- linux
- win
- android ( retina )
- ios ( retina )
- winPhone7
- winPhone7.5
- winPhone8
- blackBerry
----------- browser -----------
- chrome
- chromium
- firefox
- ie6,7,8,9,10,10touch,11
- safari
- opera
- yandex
##where.setNamespace(object)
Set your namespace where you want where.js
in.
If not, it will stay in window.where
Run the tests in the environment you are. Results are stored within the where.js
object.
So you can call where.os[osName]
or where.browser[browserName]
to get your boolean value.
Example
var where = window.where; // or wherever you set the namespace of 'where'
// run the tests
where.testAll();
// check the browser, OS you want
if(where.os.win){ /* means you are in windows */ }
if(where.browser.chrome){ /* means you have chrome, nice */ }
Add a prefix to the classes you can add to the body.
Add classes in the
for truthy tests. Useful when you want to style with CSS different browsers/OSes. Examplewhere.testAll();
where.setPrefix('myApp');
where.addClassToBody();
so if you are using mac and chrome your
will become<body class="myApp-chrome myApp-mac">
You can also use requirejs to import where/js
// code for a simple gh-pages front for where.js
// we load where.js with require.js
require(["where"], function(whereModule) {
var where = whereModule.where;
// do the tests
where.testAll();
// set a prefix for the classes to be added
where.setPrefix('where');
// add the appropriate classes to the <body>
where.addClassToBody();
// e.g. now we have <body where-chrome where-linux>
/*
where.browser
> Object {chrome: true, chromium: false, opera: false, ie6: false, ie7: false…}
where.os
> Object {win: false, winPhone7: false, winPhone75: false, winPhone8: false, linux: true…}
*/