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.

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.

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.

list ⇒ Array

Returns the listeners stack of the given event.

add ⇒ function

Adds a listener to a given event.

Returns: function - Returns the newly added listener

Param	Type	Description
event	string	The name of the event
listener	function	The listener that you want to add

addOnce ⇒ void

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

Param	Type	Description
event	string	The name of the event
listener	function	The listener that you want to add

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

Param	Type	Description
event	string	The name of the event
listener	function	The listener that you want to add

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.

Param	Type	Description
event	string	The name of the event
listener	function	The listener that you want to add

remove ⇒ void

Removes a listener from a given event.

Param	Type	Description
event	string	The name of the event
listener	function	The listener that you want to add

clear ⇒ void

Clears the listeners stack of the given event.

Param	Type	Description
event	string	The name of the event

emit ⇒ void

Fires all the listeners of the given event.

Param	Type	Description
event	string	The name of the event
params	arguments...	The optional arguments that will be passed to listeners

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

Param	Type	Description
event	string	The name of the event
params	arguments...	The name of the event

list ⇒ Array

Returns the listeners stack of the given event.

Returns: Array - The listeners stack

Param	Type	Description
event	string	The name of the event