@slimio/micro
TypeScript icon, indicating that this package has built-in type declarations

0.1.0 • Public • Published

Micro

NodeJS C++ NAPI low level binding to get high resolution timestamp.

This API is synchronous.

Getting Started

This package is available in the Node Package Repository and can be easily installed with npm or yarn.

$ npm i @slimio/micro
# or
$ yarn add @slimio/micro

Usage example

const { now, gettimeofday, clock } = require("@slimio/micro");

console.log(now()); // 1538484472718548
console.log(gettimeofday()); // { sec: 1538484493, usec: 222313 }
console.log(clock.now());
console.log(clock.gettime());

API

now(): number

Return the current timestamp as microsecond. You can achieve the same result with gettimeofday():

const tv = micro.gettimeofday();
const now = (tv.sec * 1000000) + tv.usec;
console.log(now); // 1538484472718548

Warning: Micro.now() suffers the effects of drift like Date.now()

gettimeofday(): timeval

UNIX gettimeofday binding (polyfill has been added for Windows too). Return a timeval interface Object.

interface timeval {
    sec: number;
    usec: number;
}

export function gettimeofday(): timeval;

clock.gettime(): timespec;

UNIX clock_gettime binding (polyfill has been added for Windows too). Return a timespec interface Object. This method work like NodeJS process.hrtime.

clock.now(): number;

Return a millisecond no-drift timestamp. You can achieve the same with clock.gettime():

const { sec, usec } = micro.clock.gettime();
console.log(sec * 1e3 + usec / 1e6);

// same as:
console.log(micro.clock.now());

How to build the project

Before building the project, be sure to get the following npm package installed:

Then, just run normal npm install command:

$ npm install

Available commands

All projects commands are described here:

command description
npm run prebuild Generate addon prebuild
npm run doc Generate JSDoc .HTML documentation (in the /docs root directory)
npm run coverage Generate coverage of tests
npm run report Generate .HTML report of tests coverage

the report command have to be triggered after the coverage command.

Readme

Keywords

none

Package Sidebar

Install

npm i @slimio/micro

Weekly Downloads

0

Version

0.1.0

License

MIT

Unpacked Size

246 kB

Total Files

12

Last publish

Collaborators

  • fraxken
  • alexandre.malaj