Class EventDelegate<T>

Raccourci ergonomique vers EventHandler avec un seul générique.

Permet d'instancier un gestionnaire d'événement en ne spécifiant que le type du callback, sans avoir à décomposer manuellement TArgs :

// Avec EventDelegate — un seul générique
const onClick = new EventDelegate<(e: MouseEvent) => void>();

// Équivalent avec EventHandler — verbeux
const onClick = new EventHandler<[MouseEvent], (e: MouseEvent) => void>();

Example

type OnFrameCreatedCallback = (frame: FrameData) => void;

const onFrameCreated = new EventDelegate<OnFrameCreatedCallback>();
onFrameCreated.add('handler', (frame) => console.log(frame));
onFrameCreated.invoke(frameData);

See

EventHandler pour l'API complète avec contrôle fin des génériques
JsCircularEvent pour la variante circulaire

Type Parameters

T extends Func = Func
Type du callback. Parameters<T> et ReturnType<T> sont automatiquement extraits pour alimenter EventHandler. Par défaut Func.

Hierarchy (View Summary)

EventHandler<Parameters<T>, T>
- EventDelegate

Index

Constructors

constructor

new EventDelegate<T extends Func = Func>(): EventDelegate<T>
Type Parameters
- T extends Func = Func
  Type du callback. Parameters<T> et ReturnType<T> sont automatiquement extraits pour alimenter EventHandler. Par défaut Func.
Returns EventDelegate<T>
Inherited from EventHandler.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 EventHandler.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 EventHandler.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 EventHandler.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 EventHandler.onHandlerRemoved
- Defined in src/lib/abstract/AEventHandler.ts:131

Methods

`Protected`_p_get

_p_get(key: string): MayBe<IEventData<Parameters<T>, 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<Parameters<T>, T>>
Les données du callback, ou null si la clé est absente.
Inherited from EventHandler._p_get
- Defined in src/lib/abstract/AEventHandler.ts:314

`Protected`_p_initOnHandlerAdded

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

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

`Protected`_p_initOnHandlerCleared

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

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

`Protected`_p_initOnHandlerRemoved

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

Returns IEventHandler<
[key: string, callbackRemoved: MayBe<T>],
HandlerRemovedCallback<Parameters<T>, T>,
>
Une nouvelle instance de EventHandler.
Inherited from EventHandler._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 EventHandler.add
- Defined in src/lib/abstract/AEventHandler.ts:184

call

call(...args: Parameters): Nullable<ReturnType<T> | ReturnType<T>[]>
Déclenche tous les callbacks enregistrés et retourne leur résultat sous une forme simplifiée.
Parameters
- ...args: Parameters
  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.
Inherited from EventHandler.call
- 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 EventHandler.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 EventHandler.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 EventHandler.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 EventHandler.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 EventHandler.haveEvents
- Defined in src/lib/abstract/AEventHandler.ts:236

invoke

invoke(...params: Parameters): 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: Parameters
  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#
Inherited from EventHandler.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 EventHandler.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 EventHandler.remove
- Defined in src/lib/abstract/AEventHandler.ts:214

Class EventDelegate<T>

Example

See

Type Parameters

Hierarchy (View Summary)

Index

Constructors

Accessors

Methods

Constructors

constructor

Type Parameters

Returns EventDelegate<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<Parameters<T>, T>>

Protected_p_initOnHandlerAdded

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

Protected_p_initOnHandlerCleared

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

Protected_p_initOnHandlerRemoved

Returns IEventHandler< [key: string, callbackRemoved: MayBe<T>], HandlerRemovedCallback<Parameters<T>, 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

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

`Protected`_p_initOnHandlerCleared

`Protected`_p_initOnHandlerRemoved

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