Timing-functions NPM

Timing functions

in development

Small functions that can be used to handle timing in async functions in JavaScript.

Note:

Assumes support for at least es2015 (needs Promise and arrow functions). Please transpile and/or add polyfills when appropriate.
The timing will never be precise as it depends on functions like setTimeout that do not provide precise timing.
Keep in mind that these functions are never blocking.

Usage

These functions are meant to be used within async functions (es2017).

They can be used inside the browser (main thread and worker) or NodeJS.

There is no default import, all these helper functions are available as named exports.

Examples

import { sleep } from 'timing-functions';

async function message() {
  console.log("it' gonna be legend...");
  await sleep(200); // Waits for approximately 200ms
  console.log('...wait for it...');
  await sleep(1000); // Waits for approximately 1s
  console.log('...dary!');
}
message();

Types

A TypeScript declaration file is available and published alongside the code.

Bundle formats

The code is bundled and published as CommonJS and ES modules.

API

`sleep`

Waits for approximately the number of ms provided.

Parameters

name	default value	accepted values	information	required
`time`	none	number	time to wait in ms	yes

`frame`

Waits for the next animationFrame.

Parameters

none

`schedule`

Tries to wait for an idle time.

Parameters

name	default value	accepted values	information	required
`maxTimeout`	none	number	maximum time to wait in before continuing	no

`timeout`

Provides a way to timeout a Promise. If the Promise you passed takes longer than the timout to resolve, it will reject.

Parameters

name	default value	accepted values	information	required
`timeout`	none	number	time to wait in ms before timing out	yes
`promise`	none	Promise	`Promise` that will be wrapped	yes
`message`	none	string	message that will be passed when rejecting	no