A blazing-fast, lightweight event emitter for efficient and scalable communication.
What if you could emit events with just a few simple commands and have them handled with maximum efficiency?
@glandjs/emitter is an ultra-fast, protocol-agnostic event emitter that serves as the backbone of communication within the Gland architecture. With just three simple methods: on, off, and emit, it powers an event-driven system that is lightweight, scalable, and highly performant.
This package is designed to be minimal yet extremely fast and low-overhead. It is engineered to handle high-frequency event dispatches, optimize memory usage, and provide type-safe APIs with zero dependencies.
If Gland’s core architecture is like a language, then @glandjs/emitter is its most basic, high-performance tool for communication.
At its core, @glandjs/emitter is all about flexibility, simplicity, and speed. It does not concern itself with how events are transmitted (whether over HTTP, WebSocket, or any other transport) or the specifics of any event type. It’s transport-agnostic and designed to facilitate communication within the system — between decoupled components — without imposing unnecessary constraints.
Its purpose is to provide a lightweight and minimalistic solution for handling events, enabling seamless interaction between the system components, all while ensuring maximum performance.
The design of @glandjs/emitter focuses on simplicity and performance. It’s not a complex event system that introduces unnecessary abstractions or layers; instead, it’s designed to handle high-volume events in a system with minimal memory footprint and maximum throughput.
- Minimalism: We only expose three methods:
on,off, andemit. These three methods cover the entire event handling process. Nothing more is needed. - Event Hierarchy: Event names use a
:separator, allowing for a namespaced structure (e.g.,user:login,system:error). The emitter efficiently resolves events with hierarchies or wildcards, without sacrificing performance. - Decoupling: Components using this emitter are completely decoupled. There is no direct dependency between listeners and emitters. A listener only cares about the event name, not who emits it or how it gets there.
- Performance First: Designed to be memory efficient and fast. The emitter avoids memory-heavy operations like closures or deep object copying.
For full documentation on how to use @glandjs/emitter, check out the following resources:
MIT © Mahdi — See LICENSE