Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.