Enqueue micro-tasks and macro-tasks in browser and Node.js. Only 0.3Kb in weight and 60 lines of code in length.
In Node.js and browsers macro-tasks are functions scheduled to be executed in
future event loop cycles, for example setTimeout(fn, 0)
will schedule fn
to
be executed in one of the future event loop cycles.
On the other hand, all callbacks in micro-task queue will execute before the
current event loop cycle finishes, for example in Node.js callbacks scheduled using
process.nextTick(fn)
will all execute in the current event loop cycle.
npm install entask
import {microtask, macrotask, asap} from 'entask';
macrotask(() => console.log('world!'));
microtask(() => console.log('Hello'));
// ๐ Hello world!
or
macrotask(() => console.log('C'));
microtask(() => console.log('B'));
console.log('A');
// ๐ A
// ๐ B
// ๐ C
Will schedule a micro-task, it will try to use the following methods in this order:
process.nextTick
Promise
MutationObserver
WebkitMutationObserver
If none of the methods are available, microtask
itself will equal to null
.
Will schedue a macro-task, it will try to use the following methods in this order:
setImmediate
MessageChannel
window.postMessage
setTimeout
If you are running in Node.js or browser environemnt, then macrotask
will at least
default to setTimeout
. If you are running in an evironment that does not even
have setTimeout
method, macrotask
may equal to null
.
It is defined as
const asap = microtask || macrotask;
i.e. asap
will try to schedule a micro-task but fall back to scheduling a
macro-task.
You can also use light version.
import {microtask, macrotask, asap} from 'entask/lite';
It has the same API but does not include MutationObserver
, because almost all
modern browsers will have Promise
implementation. It also does not include
window.postMessage
, because almost all modern browsers have MessageChannel
implementation available.
You can shim process.nextTick
in your browser.
require('entask/shim/nexttick').install();
process.nextTick(() => { /* ... */ });
You can also shim setImmediate
.
require('entask/shim/setimmediate').install();
setImmediate(() => { /* ... */ });
Unlicense โ public domain.