Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including marky with all npm packages installed. Try it out:

var marky = require("marky")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

marky v1.2.1

Performance timer based on performance.mark() and measure()

marky Build Status

JavaScript timer based on performance.mark() and performance.measure(), providing high-resolution timings as well as nice Dev Tools visualizations.

For browsers that don't support performance.mark(), it falls back to or In Node, it uses process.hrtime().

Quick start

Install via npm:

npm install marky

Or as a script tag:

<script src=""></script>

Then take some measurements:

var marky = require('marky');

marky.mark('expensive operation');
marky.stop('expensive operation');


The User Timing API is more performant than console.time() and console.timeEnd(), and more accurate than Also, you get nice visualizations in Chrome Dev Tools:

Chrome Dev Tools screenshot

As well as Edge F12 Tools:

Edge F12 screenshot

This is because marky adds standard PerformanceEntries to the Performance Timeline. Tools like WebPageTest and Windows Performance Analyzer also surface them, and you can even send them to your analytics provider.


marky.mark() begins recording, and marky.stop() finishes recording:


You can also do more complex scenarios:

function setSail() {

marky.stop() also returns a PerformanceEntry:

var entry = marky.stop('manTheTorpedos');

The entry will look something like:

  "entryType": "measure",
  "startTime": 1974112,
  "duration": 350,
  "name": "manTheTorpedos"

You can get all entries using:

var entries = marky.getEntries();

This provides a list of all measures ordered by startTime, e.g.:

    "entryType": "measure",
    "startTime": 1974112,
    "duration": 350,
    "name": "numberOne"
    "entryType": "measure",
    "startTime": 1975108,
    "duration": 300,
    "name": "numberTwo"
    "entryType": "measure",
    "startTime": 1976127,
    "duration": 250,
    "name": "numberThree"

You can also clear the entries using marky.clear():


After this, marky.getEntries() will return an empty list. (If the User Timing API is supported, this will delete all the mark and measure entries from the timeline.)

Browser support

marky is tested in the following browsers/environments:

  • IE 9+
  • Safari 8+
  • iOS 8+
  • Android 4.4+
  • Chrome
  • Firefox
  • Edge
  • Node 4+

Per the spec, browsers only need to hold a minimum of 150 entries in their Performance Timeline buffer. Notably Firefox throttles their buffer to 150, which for marky means you can get a maximum of 50 entries from marky.getEntries() (because marky creates two marks and a measure).

If you need to get more than 50 entries from marky.getEntries(), you can do:

if (typeof performance !== 'undefined' && performance.setResourceTimingBufferSize) {
  performance.setResourceTimingBufferSize(10000); // or however many you need

In Node and browsers that don't support the User Timing API, marky follows the behavior of Edge and Chrome, and does not limit the number of entries. marky.stop() and marky.getEntries() will return pseudo-PerformanceEntry objects.

See also

  • appmetrics.js – a library on top of mark()/measure() which reports to Google Analytics.


Thanks to @toddreifsteck for feedback on this project and clarifications on the User Timing API.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free