Copyright 2014 Nic Jansma
Licensed under the MIT license
IntroductionUserTiming.js is a polyfill that adds UserTiming support to browsers that do not natively support it.
UserTiming is accessed via the PerformanceTimeline, and requires `
window.performance.now()` support, so UserTiming.js adds a limited version of these interfaces if the browser does not support them (which is likely the case if the browser does not natively support UserTiming).
As of 2013-04-15, UserTiming is natively supported by the following browsers:
- IE 10+
- Chrome 25+ (prefixed)
UserTiming.js has been verified to add UserTiming support to the following browsers:
- IE 6-9
- Firefox 3.6+ (previous versions not tested)
- Safari 4.0.5+ (previous versions not tested)
- Opera 10.50+ (previous versions not tested)
UserTiming.js will detect native implementations of UserTiming, `
window.performance.now()` and the PerformanceTimeline and will not make any changes if those interfaces already exist. When a prefixed version is found, it is copied over to the unprefixed name.
DownloadReleases are available for download from GitHub.
usertiming.js is also available as the npm usertiming module. You can install using Node Package Manager (npm):
- 1,187b (minified / gzipped)
usertiming.js is also available via bower. You can install using:
npm install usertiming
bower install usertiming
CDNusertiming.js is available from the following CDNs:
UsagePlease see the W3C UserTiming API Reference for details on how to use the UserTiming API.
To include the UserTiming.js polyfill, simply include it via a script tag:
- If the browser does not natively support
[DOMHighResolutionTimestamps / ``window.performance.now()``](http://www.w3.org/TR/hr-time/), UserTiming.js adds a small shim (via the `Date` object) to mock this interface. However, DOMHighResolutionTimestamp provides higher precision (0.1 milliseconds or better) than the native `Date` object can (1.0 millisecond -- or worse in older browsers). So if `window.performance.now()` has to be mocked, it will not be as precise as native implementations.
- UserTiming marks and measures are queried via the PerformanceTimeline,
for example by using `getEntries()`, `getEntriesByType()` or `getEntriesByName()`. UserTiming.js adds these interfaces so you can query for marks and measures, but they obviously will not support any other PerformanceEntrys such as [ResourceTiming](http://www.w3.org/TR/resource-timing/).
UserTiming.js testsUserTiming.js tests are provided in the `
directory, and can be run via
Or via `
The tests can also be run in a web browser:
W3C testsThe latest W3C UserTiming tests (as of 2013-04-15) were copied into the `
test-w3c/` directory and can be run in any browser to validate UserTiming.js. In browsers that natively support UserTiming, UserTiming.js does not change anything so the tests will be running against the native browser interface.
The following changes were made to the W3C test suite to work with UserTiming.js:
- The relative test harness JS/CSS urls were changed to point to the local `
(such as ``testharness.js``, ``webperftestharness.js``, etc)
- All tests were updated to add a reference to `
../src/usertiming.js` so usertiming.js is actually used
test_user_timing_mark.htm`: The threshold was increased from 20ms to 50ms
(due to inefficiencies in the test suite)
does **not pass** the IDL tests (
idlharness.html`), nor will it ever.
- The W3C test harness itself does not appear to work in several older browsers (IE <= 8, Firefox 3.6, etc). The
UserTiming.js [test cases](#Tests) should cover most of what the W3C tests are doing, and the nodeunit test harness works in these older browsers.
- v0.1.0 - 2013-04-15: Initial version
- v0.1.1 - 2014-02-19: Updated dependencies, grunt lint task, bower package name
- v0.1.2 - 2014-02-19: Small bower.json fix
- v0.1.3 - 2014-08-07: Include dist/ dir in bower and npm packages
- v0.1.4 - 2014-10-28: Fix for Safari iOS 8
- v0.1.5 - 2015-01-12: Fix for FF 35
- v0.1.6 - 2015-02-01: Better FF 35 support (or any browser that has RT but not UT)
- v0.1.7 - 2015-09-14: Dev-only changes: Lint, switched from NodeUnit to Mocha
- v0.1.8 - 2016-05-15: Fall back to process.hrtime() if available