Class EventHandler<TArgs, T>

Implémentation concrète de AEventHandler.

Gestionnaire d'événements typé inspiré du pattern event de C#. Chaque callback est appelé indépendamment — le résultat de l'un n'influence pas l'appel du suivant.

Pour un comportement circulaire où chaque callback reçoit le résultat du précédent, utiliser CircularEventHandler à la place.

Example

const onClick = new EventHandler<[MouseEvent]>();

onClick.add('logger', (e) => console.log(e.clientX));
onClick.add('tracker', (e) => analytics.track(e));

onClick.invoke(new MouseEvent('click'));

See

EventHandler<TEventArgs> — C#

Type Parameters

TArgs extends any[] = any[]
Tuple représentant les types des arguments transmis aux callbacks lors de l'appel. Par défaut any[].
T extends Func<TArgs> = Func<TArgs>
Type des callbacks attachés à l'événement, doit étendre Func<TArgs>. Par défaut Func<TArgs>.

Hierarchy (View Summary)

AEventHandler<TArgs, T>
- EventHandler
  - EventDelegate

Index

Constructors

constructor

new EventHandler<
TArgs extends any[] = any[],
T extends Func<TArgs> = Func<TArgs>,
>(): EventHandler<TArgs, T>
Type Parameters
- TArgs extends any[] = any[]
  Tuple représentant les types des arguments transmis aux callbacks lors de l'appel. Par défaut any[].
- T extends Func<TArgs> = Func<TArgs>
  Type des callbacks attachés à l'événement, doit étendre Func<TArgs>. Par défaut Func<TArgs>.
Returns EventHandler<TArgs, T>
Overrides AEventHandler.constructor
- Defined in src/lib/classes/EventHandler.ts:43

Accessors

keys

get keys(): string[]
Retourne la liste des clés des callbacks actuellement enregistrés.

Returns string[]
Example
```
const keys = event.keys; // ['handler1', 'handler2']
```
Inherited from AEventHandler.keys
- Defined in src/lib/abstract/AEventHandler.ts:89

onHandlerAdded

get onHandlerAdded(): IEventHandler<
[key: string, callbackAdded: T],
HandlerAddedCallback<TArgs, T>,
>
Événement déclenché chaque fois qu'un handler est ajouté via add ou push.

Initialisé de façon lazy via _p_initOnHandlerAdded lors du premier accès — aucun coût si personne ne s'y abonne.

Returns IEventHandler<[key: string, callbackAdded: T], HandlerAddedCallback<TArgs, T>>
Example
```
event.onHandlerAdded.push((key, cb) => {
  console.log(`Handler "${key}" ajouté`);
});
```
See
HandlerAddedCallback
Inherited from AEventHandler.onHandlerAdded
- Defined in src/lib/abstract/AEventHandler.ts:109

onHandlerCleared

get onHandlerCleared(): IEventHandler<
[callbacksCleared: T[]],
HandlerClearedCallback<TArgs, T>,
>
Événement déclenché une seule fois lorsque tous les handlers sont supprimés via clear.

Initialisé de façon lazy via _p_initOnHandlerCleared lors du premier accès — aucun coût si personne ne s'y abonne.

Returns IEventHandler<[callbacksCleared: T[]], HandlerClearedCallback<TArgs, T>>
Example
```
event.onHandlerCleared.push((callbacks) => {
  console.log(`${callbacks.length} handler(s) supprimé(s)`);
});
```
See
HandlerClearedCallback
Inherited from AEventHandler.onHandlerCleared
- Defined in src/lib/abstract/AEventHandler.ts:154

onHandlerRemoved

get onHandlerRemoved(): IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>
Événement déclenché chaque fois qu'un handler est retiré via remove.

Initialisé de façon lazy via _p_initOnHandlerRemoved lors du premier accès — aucun coût si personne ne s'y abonne.

Returns IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>
Example
```
event.onHandlerRemoved.push((key, cb) => {
  console.log(`Handler "${key}" retiré`);
});
```
See
HandlerRemovedCallback
Inherited from AEventHandler.onHandlerRemoved
- Defined in src/lib/abstract/AEventHandler.ts:131

Methods

`Protected`_p_get

_p_get(key: string): MayBe<IEventData<TArgs, T>>
Protected
Retourne les données associées à la clé donnée, ou null si la clé n'existe pas.

Point d'accès protégé au dictionnaire interne — permet aux classes concrètes d'accéder aux données d'un callback sans exposer #_callbacks directement.
Parameters
- key: string
  La clé du callback à récupérer.
Returns MayBe<IEventData<TArgs, T>>
Les données du callback, ou null si la clé est absente.
Inherited from AEventHandler._p_get
- Defined in src/lib/abstract/AEventHandler.ts:314

`Protected`_p_initOnHandlerAdded

_p_initOnHandlerAdded(): IEventHandler<
[key: string, callbackAdded: T],
HandlerAddedCallback<TArgs, T>,
>
Protected
Initialise l'instance de onHandlerAdded.

Returns IEventHandler<[key: string, callbackAdded: T], HandlerAddedCallback<TArgs, T>>
Une nouvelle instance de EventHandler.
Overrides AEventHandler._p_initOnHandlerAdded
- Defined in src/lib/classes/EventHandler.ts:143

`Protected`_p_initOnHandlerCleared

_p_initOnHandlerCleared(): IEventHandler<
[callbacksCleared: T[]],
HandlerClearedCallback<TArgs, T>,
>
Protected
Initialise l'instance de onHandlerCleared.

Returns IEventHandler<[callbacksCleared: T[]], HandlerClearedCallback<TArgs, T>>
Une nouvelle instance de EventHandler.
Overrides AEventHandler._p_initOnHandlerCleared
- Defined in src/lib/classes/EventHandler.ts:167

`Protected`_p_initOnHandlerRemoved

_p_initOnHandlerRemoved(): IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>
Protected
Initialise l'instance de onHandlerRemoved.

Returns IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>
Une nouvelle instance de EventHandler.
Overrides AEventHandler._p_initOnHandlerRemoved
- Defined in src/lib/classes/EventHandler.ts:155

add

add(key: string, event: T, ...args: Partial<TArgs>): this
Ajoute un callback avec une clé spécifique.
Parameters
- key: string
  Clé identifiant le callback.
- event: T
  Le callback à ajouter.
- ...args: Partial<TArgs>
  Arguments par défaut transmis au callback à chaque appel.
Returns this
L'instance courante pour permettre le chaînage.
Inherited from AEventHandler.add
- Defined in src/lib/abstract/AEventHandler.ts:184

call

call(...args: TArgs): Nullable<ReturnType<T> | ReturnType<T>[]>
Déclenche tous les callbacks enregistrés et retourne leur résultat sous une forme simplifiée.
Parameters
- ...args: TArgs
  Arguments transmis à chaque callback lors de l'appel.
Returns Nullable<ReturnType<T> | ReturnType<T>[]>
null si aucun callback, la valeur directe si un seul, un tableau de valeurs si plusieurs.

Deprecated
Utilisez invoke à la place. invoke retourne un EventCallResult discriminé qui permet de distinguer sans ambiguïté les trois cas, même si ReturnType<T> est lui-même un objet ou un tableau.
- Defined in src/lib/classes/EventHandler.ts:118

clear

clear(): this
Supprime tous les callbacks enregistrés en une seule opération O(1).

Capture la liste des callbacks avant l'effacement, puis déclenche onHandlerCleared après — garantissant que la Map est vide avant la notification, sans risque de double déclenchement si un observateur appelle add dans son callback.

Returns this
L'instance courante pour permettre le chaînage.
Inherited from AEventHandler.clear
- Defined in src/lib/abstract/AEventHandler.ts:330

count

count(): uint
Retourne le nombre de callbacks actuellement enregistrés.

Returns uint
Le nombre de callbacks sous forme de uint.
Inherited from AEventHandler.count
- Defined in src/lib/abstract/AEventHandler.ts:245

getInvocationList

getInvocationList(): T[]
Retourne la liste des callbacks actuellement enregistrés, dans leur ordre d'enregistrement.

Équivalent de Delegate.GetInvocationList() en C#.

Returns T[]
Un tableau contenant tous les callbacks enregistrés.

See
Delegate.GetInvocationList() — C#
Inherited from AEventHandler.getInvocationList
- Defined in src/lib/abstract/AEventHandler.ts:355

has

has(key: string): boolean
Vérifie si un callback est enregistré sous la clé donnée.
Parameters
- key: string
  La clé à vérifier.
Returns boolean
true si un callback existe pour cette clé, false sinon.
Inherited from AEventHandler.has
- Defined in src/lib/abstract/AEventHandler.ts:202

haveEvents

haveEvents(): boolean
Indique si au moins un callback est enregistré.

Returns boolean
true si l'événement a au moins un callback, false sinon.
Inherited from AEventHandler.haveEvents
- Defined in src/lib/abstract/AEventHandler.ts:236

invoke

invoke(...params: TArgs): EventCallResult<T>
Déclenche tous les callbacks enregistrés avec les arguments fournis.

Chaque callback est appelé avec ses arguments par défaut suivis des arguments passés à invoke. Les callbacks sont appelés dans leur ordre d'enregistrement, indépendamment les uns des autres.

Le résultat dépend du nombre de callbacks enregistrés :
- { type: 'empty' } si aucun callback n'est enregistré.
- { type: 'single', value } si un seul callback est enregistré.
- { type: 'multiple', values } si plusieurs callbacks sont enregistrés.
Parameters
- ...params: TArgs
  Arguments transmis à chaque callback lors de l'appel.
Returns EventCallResult<T>
Un EventCallResult décrivant le résultat de l'appel.
Example
```
const result = event.invoke('bonjour');

switch (result.type) {
  case 'empty':    break;
  case 'single':   console.log(result.value); break;
  case 'multiple': console.log(result.values); break;
}
```
See
Delegate.Invoke — C#
Overrides AEventHandler.invoke
- Defined in src/lib/classes/EventHandler.ts:75

push

push(event: T, ...args: Partial<TArgs>): string
Ajoute un callback en générant automatiquement une clé unique.
Parameters
- event: T
  Le callback à ajouter.
- ...args: Partial<TArgs>
  Arguments par défaut transmis au callback à chaque appel.
Returns string
La clé générée.
Inherited from AEventHandler.push
- Defined in src/lib/abstract/AEventHandler.ts:170

remove

remove(key: string): MayBe<T>
Supprime le callback associé à la clé donnée et le retourne.

Déclenche onHandlerRemoved si des observateurs sont abonnés.
Parameters
- key: string
  La clé du callback à supprimer.
Returns MayBe<T>
Le callback supprimé, ou null si la clé n'existe pas.
Inherited from AEventHandler.remove
- Defined in src/lib/abstract/AEventHandler.ts:214

Class EventHandler<TArgs, T>

Example

See

Type Parameters

Hierarchy (View Summary)

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

Returns EventHandler<TArgs, T>

Accessors

keys

Returns string[]

Example

onHandlerAdded

Returns IEventHandler<[key: string, callbackAdded: T], HandlerAddedCallback<TArgs, T>>

Example

See

onHandlerCleared

Returns IEventHandler<[callbacksCleared: T[]], HandlerClearedCallback<TArgs, T>>

Example

See

onHandlerRemoved

Returns IEventHandler< [key: string, callbackRemoved: MayBe<T>], HandlerRemovedCallback<TArgs, T>,>

Example

See

Methods

Protected_p_get

Parameters

Returns MayBe<IEventData<TArgs, T>>

Protected_p_initOnHandlerAdded

Returns IEventHandler<[key: string, callbackAdded: T], HandlerAddedCallback<TArgs, T>>

Protected_p_initOnHandlerCleared

Returns IEventHandler<[callbacksCleared: T[]], HandlerClearedCallback<TArgs, T>>

Protected_p_initOnHandlerRemoved

Returns IEventHandler< [key: string, callbackRemoved: MayBe<T>], HandlerRemovedCallback<TArgs, T>,>

add

Parameters

Returns this

call

Parameters

Returns Nullable<ReturnType<T> | ReturnType<T>[]>

Deprecated

clear

Returns this

count

Returns uint

getInvocationList

Returns T[]

See

has

Parameters

Returns boolean

haveEvents

Returns boolean

invoke

Parameters

Returns EventCallResult<T>

Example

See

push

Parameters

Returns string

remove

Parameters

Returns MayBe<T>

Settings

On This Page

Returns IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>

`Protected`_p_get

`Protected`_p_initOnHandlerAdded

`Protected`_p_initOnHandlerCleared

`Protected`_p_initOnHandlerRemoved

Returns IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<TArgs, T>,
>