Accueil › TypeScript › Surcharges, et quand s'en passer
Surcharges, et quand s'en passer
Typer les fonctionsdebutant
Une fonction surchargée déclare plusieurs signatures, puis une seule implémentation.
function creerDate(timestamp: number): Date;
function creerDate(annee: number, mois: number, jour: number): Date;
function creerDate(a: number, b?: number, c?: number): Date {
return b === undefined ? new Date(a) : new Date(a, b, c ?? 1);
}
creerDate(0);
creerDate(2024, 0, 15);
creerDate(2024, 0);
// TS2769: No overload matches this call.
Deux signatures sont appelables, et une seule porte le corps. Les trois arguments ne forment pas un intervalle : on a le droit d'en passer un, ou trois, pas deux. Aucune liste de paramètres optionnels ne décrit cela.
La signature d'implémentation n'est pas appelable
function cle(x: string): string;
function cle(x: number): string;
function cle(x: string | number): string {
return String(x);
}
cle("a"); // d'accord
cle(1); // d'accord
cle(true); // TS2769 — pourtant la ligne 3 semble permissive
C'est la question d'entretien classique sur le sujet. La signature d'implémentation doit être assez large pour couvrir toutes les surcharges en même temps ; si elle était appelable, elle autoriserait des combinaisons qu'aucune surcharge ne prévoit. Elle décrit le corps, pas le contrat.
Les termes à connaître
- Surcharge
Plusieurs signatures déclarées pour une seule fonction. Elles décrivent les appels autorisés et, surtout, le retour associé à chacun.
- Signature d'implémentation
La dernière signature, celle qui porte le corps. Elle n'est pas appelable de l'extérieur : seules les surcharges déclarées le sont.
- Sélection de surcharge
TypeScript essaie les signatures dans l'ordre de déclaration et retient la première compatible. Les suivantes ne sont pas examinées.
- TS2769
« No overload matches this call. » Le message qui signale qu'aucune signature n'accepte l'appel — y compris quand un argument est une union qu'aucune signature ne couvre à elle seule.
- Union de paramètre
Une seule signature acceptant
string | number. Elle remplace deux surcharges quand le retour ne dépend pas du type reçu.- Paramètre génériqué
<T>(xs: T[]) => T | undefined. Elle remplace une famille de surcharges quand le retour dépend de l'entrée de façon uniforme.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.