events-system
TypeScript icon, indicating that this package has built-in type declarations

0.0.9 • Public • Published

Event System

Event System used for handling events between components

npm GitHub

Event System is a package used for handling different events between parts of code written in Typescript.

EventsSystem

new EventSystem(options: EventsSystemOptions)

Initializes the Event System class.

Parameters:

  • options
    • bufferDirection {"FIFO" | "LIFO"} - The direction of the events buffer. Defaults to "FIFO".
    • bufferSize {number} - The size of the buffer.

Example:

// Initialization without options
const eventSystem = new EventSystem(); // OK ✅

// Initialization with options
const eventSystem = new EventSystem({
  bufferDirection: "LIFO",
  bufferSize: 10
}); // OK ✅

subscribe(event, handler)

Subscribes handler to be called when the event is triggered.

Parameters:

  • event {keyof E} The event name.
  • handler {Function} The handler function.

Example:

type MyEvents = {
  "event": () => void;
}

const eventSystem = new EventSystem<MyEvents>();

// Subscribe to event
eventSystem.subscribe("event", () => {
  // Do something
});

unsubscribe(event, handler)

Unsubscribes the handler from the event.

Parameters:

  • event {keyof E} The event name.
  • handler {Function} The handler function.

Example:

type MyEvents = {
  "event": () => void;
}

const eventSystem = new EventSystem<MyEvents>();

// Subscribe to event
eventSystem.subscribe("event", () => {
  // Do something
});

// Unsubscribe from event
eventSystem.unsubscribe("event", () => {
  // Do something
});

notify(event, ...args)

Triggers the event with the given arguments.

Parameters:

  • event {keyof E} The event name.
  • args {Parameters<E[keyof E]>} The arguments to pass to the handler.

Example:

type MyEvents = {
  "event": (a: number, b: string) => void;
}

const eventSystem = new EventSystem<MyEvents>();

// Subscribe to event
eventSystem.subscribe("event", (a, b) => {
  // Do something
});

// Trigger event
eventSystem.notify("event", 1, "Hello");

Package Sidebar

Install

npm i events-system

Weekly Downloads

5

Version

0.0.9

License

Apache-2.0

Unpacked Size

27.8 kB

Total Files

10

Last publish

Collaborators

  • nicksettler