typed-emitter

What is typed-emitter?

The 'typed-emitter' npm package provides a strongly-typed event emitter for TypeScript. It allows developers to define and use event emitters with type safety, ensuring that the events and their associated data are correctly typed.

What are typed-emitter's main functionalities?

Basic Event Emission

This feature allows you to define and emit basic events with type safety. The event 'event1' is defined to accept a string message, and the emitter ensures that only strings are passed when emitting this event.

const { TypedEmitter } = require('typed-emitter');

interface MyEvents {
  event1: (message: string) => void;
}

const emitter = new TypedEmitter<MyEvents>();
emitter.on('event1', (message) => {
  console.log(message);
});
emitter.emit('event1', 'Hello, World!');

Multiple Event Listeners

This feature demonstrates how you can attach multiple listeners to a single event. Both listeners will be called when 'event1' is emitted, and they will receive the same message.

const { TypedEmitter } = require('typed-emitter');

interface MyEvents {
  event1: (message: string) => void;
  event2: (count: number) => void;
}

const emitter = new TypedEmitter<MyEvents>();
emitter.on('event1', (message) => {
  console.log('Listener 1:', message);
});
emitter.on('event1', (message) => {
  console.log('Listener 2:', message);
});
emitter.emit('event1', 'Hello, World!');

Removing Event Listeners

This feature shows how to remove an event listener. The listener is first added to 'event1', then removed using the 'off' method. The second emission of 'event1' does not trigger the listener.

const { TypedEmitter } = require('typed-emitter');

interface MyEvents {
  event1: (message: string) => void;
}

const emitter = new TypedEmitter<MyEvents>();
const listener = (message: string) => {
  console.log(message);
};
emitter.on('event1', listener);
emitter.emit('event1', 'Hello, World!');
emitter.off('event1', listener);
emitter.emit('event1', 'This will not be logged');

Other packages similar to typed-emitter

eventemitter3

EventEmitter3 is a high-performance event emitter for Node.js and the browser. It provides a similar API to Node.js's built-in EventEmitter but with better performance and additional features. Unlike 'typed-emitter', it does not provide built-in TypeScript support, so type safety must be manually managed.

mitt

Mitt is a tiny (~200 bytes) functional event emitter. It is designed to be extremely lightweight and simple to use. While it is not as feature-rich as 'typed-emitter' and does not provide built-in TypeScript support, it is a good choice for projects where size and simplicity are critical.

nanoevents

Nanoevents is a tiny (around 200 bytes) event emitter library for JavaScript. It is similar to 'mitt' in its focus on minimalism and simplicity. Like 'mitt', it does not provide built-in TypeScript support, so type safety must be manually managed.

README

The README file is missing