minemit v1.0.12

minemit

A minimal event emitter

Installation and basic usage

Install via npm

$ npm i minemit

Either import minemit completely or just the desired method

import minemit, { add, emit } from "minemit";

Once imported, there is no need to create any instances. Minemit allows you to register multiple listeners for a given event and emit it.

function myCallback(params) {
    // code...
}

add("myEvent", myCallback);

// ...

emit("myEvent");

You can also pass down arguments to the event you are emitting. Those will be accessible to all registered listeners.

function myCallback({ prop }) {
    console.log(prop); // foo

    // code...
}

add("myEvent", myCallback);
emit("myEvent", { prop: "foo" });

Minemit also allows you to emit an event asynchronously with the emitAsync method. Basically all the listeners registered to that event will be treated as promises, giving you the possibility to wait for the whole listeners stack to complete. Here is an example.

function myCallback() {
    // code...
}

async function myAsyncFunction() {
    // code...
}

add("myEvent", myCallback);
add("myEvent", myAsyncFunction);

await emitAsync("myEvent");

// code will be executed after the listeners stack has finished...

Functions

add ⇒ function

Adds a listener to a given event.

Returns: function - Returns the newly added listener

addOnce ⇒ void

Adds a listener that gets fired once to a given event.

prepend ⇒ function

Adds a listener to a given event. The listener is added to the first position of the stack.

Returns: function - Returns the newly added listener

prependOnce ⇒ void

Adds a listener to a given event. The listener is added to the first position of the stack and that gets fired once.

remove ⇒ void

Removes a listener from a given event.

clear ⇒ void

Clears the listeners stack of the given event.

emit ⇒ void

Fires all the listeners of the given event.

emitAsync ⇒ Promise

Fires all the listeners of the given event. The listeners get all treated as promises in order to get fired asyncronously.

Returns: Promise - The listeners stack

list ⇒ Array

Returns the listeners stack of the given event.

Returns: Array - The listeners stack