Skip to content
Modernizr is a JavaScript library that detects HTML5 and CSS3 features in the user’s browser.
JavaScript Other
Branch: master
Clone or download

Latest commit

MarkelFe Solve some documentation issues (#2568)
* Solve #2418

* Solves #2085 + update spec link
Latest commit 771354e Jun 1, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add new CodeOfConduct (#2427) Oct 23, 2019
bin Fix command line fails for nested properties (#2480) Dec 6, 2019
feature-detects Solve some documentation issues (#2568) Jun 1, 2020
legacy Issue 2343: Fix github.io page (#2443) Jun 24, 2019
lib Decrapt datalist.js (#2569) May 29, 2020
media fix crlf (windows) end of lines forcing to lf (unix) Oct 19, 2015
scripts Issue 2343: Fix github.io page (#2443) Jun 24, 2019
src Update computedStyle usage (#2528) Apr 26, 2020
test Decrapt datalist.js (#2569) May 29, 2020
.babelrc Use gulp for the dev pipeline (#2429) May 15, 2019
.editorconfig Removing stray + Aug 2, 2014
.eslintrc Update computedStyle usage (#2528) Apr 26, 2020
.gitattributes fix crlf (windows) end of lines forcing to lf (unix) Oct 19, 2015
.gitignore Add codecov support (#2554) May 3, 2020
.travis.yml Avoid testing in only docs files (#2560) May 19, 2020
CHANGELOG.md v3.11.0 Apr 27, 2020
HOW_TO_WRITE_FEATURE_DETECTS.md Add metadata documentation (#2547) May 28, 2020
LICENSE v3.11.0 Apr 27, 2020
README.md Decrapt datalist.js (#2569) May 29, 2020
appveyor.yml Avoid testing in only docs files (#2560) May 19, 2020
gulpfile.babel.js Use eslint:recommended, cleanup warnings (#2527) Apr 3, 2020
inch.json Update jsdoc (#2346) Jul 28, 2018
package-lock.json Update badges (#2555) May 4, 2020
package.json Update badges (#2555) May 4, 2020

README.md

Modernizr

npm version Build Status Build Status codecov Inline docs

Modernizr is a JavaScript library that detects HTML5 and CSS3 features in the user’s browser.

Modernizr tests which native CSS3 and HTML5 features are available in the current UA and makes the results available to you in two ways: as properties on a global Modernizr object, and as classes on the <html> element. This information allows you to progressively enhance your pages with a granular level of control over the experience.

Breaking changes with v4

  • Dropped Node 8 Support, please upgrade to Node v10

  • These tests got removed:

    • touchevents: discussion
    • unicode: discussion
    • templatestrings: duplicate of the es6 detect stringtemplate
    • datalistelem: A dupe of Modernizr.input.list

New Asynchronous Event Listeners

Often times people want to know when an asynchronous test is done so they can allow their application to react to it. In the past, you've had to rely on watching properties or <html> classes. Only events on asynchronous tests are supported. Synchronous tests should be handled synchronously to improve speed and to maintain consistency.

The new API looks like this:

// Listen to a test, give it a callback
Modernizr.on('testname', function( result ) {
  if (result) {
    console.log('The test passed!');
  }
  else {
    console.log('The test failed!');
  }
});

We guarantee that we'll only invoke your function once (per time that you call on). We are currently not exposing a method for exposing the trigger functionality. Instead, if you'd like to have control over async tests, use the src/addTest feature, and any test that you set will automatically expose and trigger the on functionality.

Getting Started

  • Clone or download the repository
  • Install project dependencies with npm install

Building Modernizr

From javascript

Modernizr can be used programmatically via npm:

var modernizr = require("modernizr");

A build method is exposed for generating custom Modernizr builds. Example:

var modernizr = require("modernizr");

modernizr.build({}, function (result) {
  console.log(result); // the build
});

The first parameter takes a JSON object of options and feature-detects to include. See lib/config-all.json for all available options.

The second parameter is a function invoked on task completion.

From the command-line

We also provide a command line interface for building modernizr. To see all available options run:

./bin/modernizr

Or to generate everything in 'config-all.json' run this with npm:

npm start
//outputs to ./dist/modernizr-build.js

Testing Modernizr

To execute the tests using mocha-headless-chrome on the console run:

npm test

You can also run tests in the browser of your choice with this command:

npm run serve-gh-pages

and navigating to these two URLs:

http://localhost:8080/test/unit.html
http://localhost:8080/test/integration.html

Code of Conduct

This project adheres to the Open Code of Conduct. By participating, you are expected to honor this code.

License

MIT License

You can’t perform that action at this time.