system-requirements
v1.0.0
Published
Boxed software has 'em, now the web does too.
Downloads
3
Readme
system-requirements.js
"system requirements" is printed on the side of nearly every piece of packaged software on the planet.
But on the web we still build like it's 1999.
I thoroughly believe that in a lot of cases you get what you tolerate and we've been putting up with backward compatibility for ages and thus, crippling the awesomeness that is the web.
Let's build for the future of the web, not its past.
This makes it easy
- Optionally start with a string of minimium browser versions.
- seperate browsers with 'or'
- versions will be parsed as floats
- you can add a "+" to the version number to indicate that anything above that is fine
- if you don't specify a "+" it will look for the exact version number
- acceptable browser names:
opera
,ie
ormsie
,firefox
orfx
,safari
,chrome
- examples of valid browser strings:
chrome 20+ or firefox 20+ or safari 5+
(only)safari 5
(will only pass for safari 5)ie 8+ or chrome 5+ or fx 4+ or safari 5+
- Pass in any number of tests, these could be Modernizr tests or anything. If it returns
true
(or anything truthy) the test is considered passed. - The
systemRequirments
function simply returns a boolean,true
if requirements are metfalse
if they're not.
sample uses:
// a string of acceptable browsers, redirect if not passing
if (!systemRequirements('chrome 25+ or firefox 20+ or safari 3+')) {
// redirect to helpful page, etc.
window.location = '/system-requirements';
}
// could also be a string of browsers + arbitrary tests
var someFunction = function () {return true;}
systemRequirements('chrome 25+ or firefox 20+ or safari 3+', someFunction, someFunction);
// or just tests and a fail url
systemRequirements(function () {return true;});
// you could have as many tests as you want, doesn't matter.
var someTest = function () {return true;};
systemRequirements(someTest, someTest, someTest, someTest, someTest, someTest);
That's it, that's all there is to it.
Changelog
- 1.0.0 - change 'ff' to 'fx' as per #2 filed. Publishing 1.0.0 to adhere to semver.
If you dig it...
follow @HenrikJoreteg on twitter <3
License
MIT