Skip to main content

Listenable Interface

An object which allows the registration of listeners so that subscribers can be notified when an event happens.

Sealed

This type is "sealed," meaning that code outside of the library defining it should not implement or extend it. Future versions of this type may add members or make typing of readonly members more specific.

Signature

/** @sealed */
export interface Listenable<TListeners extends object>

Type Parameters

ParameterConstraintDescription
TListenersobject

Methods

MethodReturn TypeDescription
off(eventName, listener)voidDeregister an event listener.
on(eventName, listener)Off

Method Details

off

Deregister an event listener.

Signature

off<K extends keyof Listeners<TListeners>>(eventName: K, listener: TListeners[K]): void;
Type Parameters
ParameterConstraintDescription
Kkeyof Listeners<TListeners>

Remarks

If listener is not currently registered, this method will have no effect.

Listeners may also be deregistered by calling the deregistration function returned when they are registered.

Parameters

ParameterTypeDescription
eventNameKThe name of the event.
listenerTListeners[K]The listener function to remove from the current set of event listeners.

on

Signature

on<K extends keyof Listeners<TListeners>>(eventName: K, listener: TListeners[K]): Off;
Type Parameters
ParameterConstraintDescription
Kkeyof Listeners<TListeners>

Parameters

ParameterTypeDescription
eventNameK
listenerTListeners[K]

Returns

Return type: Off