Formations — 1 037 leçons en français

Accueil › TypeScript › L'inférence, et quand annoter

L'inférence, et quand annoter

Les types de basedebutant

TypeScript déduit la plupart des types sans qu'on les écrive. Une annotation correcte mais redondante n'apporte rien et finit par mentir.

const nom = "Marie";              // "Marie"
let compteur = 0;                 // number
const roles = ["admin", "lecteur"];   // string[]

const majuscules = roles.map((r) => r.toUpperCase());   // string[]

Le paramètre r n'est pas annoté : il reçoit son type du tableau. C'est l'annotation contextuelle, et elle couvre la quasi-totalité des fonctions anonymes qu'on écrit.

La règle

L'inférence suffit presque toujours pour une variable locale. Elle ne suffit presque jamais pour une frontière publique.

// ❌ bruit : l'annotation répète la valeur
const total: number = lignes.length;

// ✅ contrat : les appelants dépendent de cette signature
export function formaterPrix(centimes: number, devise: "EUR" | "USD"): string {
  return (centimes / 100).toFixed(2) + (devise === "EUR" ? " €" : " $");
}

Sans le : string, une refonte qui ferait renvoyer undefined dans un cas compilerait, et l'erreur remonterait chez les appelants. Avec lui, elle est signalée dans la fonction fautive.

Les paramètres s'annotent toujours

Un paramètre de fonction nommée n'a aucun contexte d'où déduire son type :

function remise(prix, taux) { return prix * (1 - taux); }
// TS7006: Parameter 'prix' implicitly has an 'any' type.

Les termes à connaître

Inférence

La déduction automatique du type d'une expression à partir de sa valeur. Elle est exacte, suit le code quand il change, et n'a aucun coût de maintenance.

Élargissement (widening)

L'inférence remplace un type littéral par son primitif quand la valeur peut changer : let n = 1 donne number, const n = 1 donne 1.

Type de retour inféré

Le type qu'une fonction renvoie, déduit de ses return. Pratique en interne, risqué sur une frontière publique : il change silencieusement avec le corps.

Frontière publique

Tout ce que du code extérieur consomme : paramètres d'une fonction exportée, type de retour d'un module, forme d'une donnée persistée. C'est là qu'on annote.

`satisfies`

Un opérateur qui vérifie qu'une valeur respecte un type sans élargir son type inféré. On garde la vérification de l'annotation et la précision de l'inférence.

Annotation contextuelle

Le type qu'une fonction anonyme reçoit de son contexte d'appel : dans clients.map(c => …), le type de c est déduit du tableau, pas annoté.

`noImplicitAny`

Signale les paramètres pour lesquels aucun contexte ne permet d'inférer : TS7006, « Parameter 'x' implicitly has an 'any' type ». Ce sont précisément ceux à annoter.

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.