45 lines
2.6 KiB
TypeScript
45 lines
2.6 KiB
TypeScript
type EventListener<Events, EventType extends keyof Events> = Events[EventType];
|
|
export type EventParameters<Events, EventType extends keyof Events> = {
|
|
[Event in EventType]: EventListener<Events, EventType> extends (...args: infer P) => any ? P : never;
|
|
}[EventType];
|
|
export declare class EventEmitter<EventTypes extends Record<string, (...args: any) => any>> {
|
|
#private;
|
|
/**
|
|
* Adds the listener function to the end of the listeners array for the event.
|
|
* No checks are made to see if the listener has already been added. Multiple calls passing
|
|
* the same combination of event and listener will result in the listener being added, and
|
|
* called, multiple times.
|
|
* @returns this, so that calls can be chained
|
|
*/
|
|
on<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this;
|
|
/**
|
|
* Removes the specified listener from the listener array for the event.
|
|
* off() will remove, at most, one instance of a listener from the listener array. If any single
|
|
* listener has been added multiple times to the listener array for the specified event, then
|
|
* off() must be called multiple times to remove each instance.
|
|
* @returns this, so that calls can be chained
|
|
*/
|
|
off<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this;
|
|
/**
|
|
* Adds a one-time listener function for the event. The next time the event is triggered,
|
|
* this listener is removed and then invoked.
|
|
* @returns this, so that calls can be chained
|
|
*/
|
|
once<Event extends keyof EventTypes>(event: Event, listener: EventListener<EventTypes, Event>): this;
|
|
/**
|
|
* This is similar to `.once()`, but returns a Promise that resolves the next time
|
|
* the event is triggered, instead of calling a listener callback.
|
|
* @returns a Promise that resolves the next time given event is triggered,
|
|
* or rejects if an error is emitted. (If you request the 'error' event,
|
|
* returns a promise that resolves with the error).
|
|
*
|
|
* Example:
|
|
*
|
|
* const message = await stream.emitted('message') // rejects if the stream errors
|
|
*/
|
|
emitted<Event extends keyof EventTypes>(event: Event): Promise<EventParameters<EventTypes, Event> extends [infer Param] ? Param : EventParameters<EventTypes, Event> extends [] ? void : EventParameters<EventTypes, Event>>;
|
|
protected _emit<Event extends keyof EventTypes>(this: EventEmitter<EventTypes>, event: Event, ...args: EventParameters<EventTypes, Event>): void;
|
|
protected _hasListener(event: keyof EventTypes): boolean;
|
|
}
|
|
export {};
|
|
//# sourceMappingURL=EventEmitter.d.mts.map
|