performance-node
v0.2.0
Published
Performance (User Timing API) for Node.js
Downloads
953
Maintainers
Readme
Performance for Node.js
A superset of the User Timing API (window.performance
) for Node.js
Uses process.hrtime
to capture marks + measures to gain deeper visibility into the timings that you define in your application.
0 Dependencies!
Requirements
- Node >=
4.3.2
- NPM >=
2.14.12
Install
With yarn (recommended) in project directory:
yarn add performance-node
With npm in project directory:
npm install performance-node
Then, run your application:
const Perf = require('performance-node');
const timeline = new Perf();
timeline.mark('foo-start');
// delay(10)
timeline.mark('foo-end');
timeline.measure('foo-measure', 'foo-start', 'foo-end');
const myMeasure = timeline.getEntriesByName('foo-measure')[0];
// {name: 'foo-measure', startTime: 1.2, duration: 10.5, entryType: 'measure'}
Methods
const Perf = require('performance-node');
const timeline = new Perf();
// set marks
timeline.mark('foo-start');
timeline.mark('foo-end');
// create a measurement
timeline.measure('foo-measure', 'foo-start', 'foo-end');
// get all timeline entries (marks + measures)
timeline.getEntries();
// get all entries with the same name
timeline.getEntriesByName('foo-start');
// get all entries with the same type
timeline.getEntriesByType('measure');
// clear marks
timeline.clearMarks();
// clear measures
timeline.clearMeasures();
// clear all entries
timeline.clear();
// get a point in time in milliseconds
timeline.now();
Config
offset
(number: optional)
By default, the startTime
of each mark is calculated by subracting the construction time from process.hrtime
. If you would rather the startTime map as closely as possible to process.hrtime
values, set offset: 0
. You can also supply any number as a custom offset.
const Perf = require('performance-node');
const timeline = new Perf({ offset: 0 });
timeline.mark('foo-start');
// delay(10)
timeline.mark('foo-end');
timeline.measure('foo-measure', 'foo-start', 'foo-end');
const myMeasure = timeline.getEntriesByName('foo-measure')[0];
// {name: 'foo-measure', startTime: 227851.91, duration: 10.5, entryType: 'measure'}
timestamp
(bool: optional = false)
Add a timestamp
(unix epoch) value for each mark based on Date.now()
.
const Perf = require('performance-node');
const timeline = new Perf({ timestamp: true });
timeline.mark('foo-start');
const myMeasure = timeline.getEntriesByName('foo-start')[0];
// {name: 'foo-start', startTime: 1.2, duration: 0, entryType: 'mark', timestamp: 1501189303951}
Contributing
- This project uses Prettier. Please execute
npm run eslint -- --fix
to auto-format the code before submitting pull requests.