override

La fonction createOverride() permet d’enregistrer des modifications (valeurs par défaut et/ou méthodes) qui seront appliquées lors de la création d’un objet.

Le pattern typique est :

1. créer l’objet de base
2. appeler overrideHandler.apply(self) juste avant de le retourner
3. depuis un autre module, enregistrer des overrides via setPropertyDefaultValue / setMethod

Cet outil est beaucoup utilisé dans dataParser pour permettre d’ajouter/altérer des capacités sans modifier l’implémentation du parser.

WARNING

Les overrides sont stockés dans un store global (valide dans tout le process) : le dernier override appliqué sur une même propriété/méthode gagne.

Exemple interactif

Syntaxe

interface OverrideHandler<
	GenericInterface extends object
> {
	setMethod<
		GenericProperty extends keyof GenericInterface
	>(
		prop: GenericProperty,
		theFunction: (
			self: GenericInterface,
			...args: any[]
		) => any
	): void;

	setPropertyDefaultValue<
		GenericProperty extends keyof GenericInterface
	>(
		prop: GenericProperty,
		value: any
	): void;

	apply(overrideInterface: GenericInterface): GenericInterface;
}

function createOverride<
	GenericInterface extends object
>(overrideName: string): OverrideHandler<GenericInterface>;

Notes d’usage

• overrideName : choisissez un nom unique (souvent un identifiant namespacé du style @duplojs/utils/...).
• apply(self) : applique les overrides et retourne un nouvel objet self (avec méthodes wrapées pour recevoir le bon self).
• setMethod(...) : la fonction reçoit self en premier paramètre, ce qui permet d’éviter les problèmes de this et de référencer les propriétés overridées.
• setPropertyDefaultValue(...) : définit une valeur appliquée à la création (et peut écraser une valeur existante).

Voir aussi

• builder - Pattern similaire “déclarer puis configurer”
• globalStore - Stockage global par process