@twilio/replay-event-emitter

EventReplayEmitter

An extension to Node's EventEmitter that supports event replay. In other words, if a listener is added using either addListenerWithReplay or onWithReplay, then it will instantly trigger the listener with previous event data (if no data was previously emitted, then the listener will not get triggered on registration).

Usage Examples

In order to get event replay on listener registration, simply utilize the addListenerWithReplay method like so:

import { ReplayEventListener } from "replay-event-listener";

// Instantiate the event listener
const eventListener = new ReplayEventListener();

// Emit an event before adding a listener
eventListener.emit("exampleEvent", "someData");

// Subscribe using addListenerWithReplay
eventListener.addListenerWithReplay("exampleEvent", (data) => {
  // This handler will get triggered despite the data emission happening BEFORE
  // the event registration.
  console.log(data);
});

You could also use the shorthand method onWithRepeat, like so:

eventListener.onWithReplay("exampleEvent", (data) => {
  console.log(data);
});

All the original functionality of the EventListener is still intact:

import { ReplayEventListener } from "replay-event-listener";

const eventListener = new ReplayEventListener();

eventListener.emit("exampleEvent", "someData");

eventListener.addListener("exampleEvent", (data) => {
  // This handler will NOT get triggered, as this is not a replay method and the
  // data emission happened BEFORE the event registration.
  console.log(data);
});