Formations — 1 037 leçons en français

Accueil › TypeScript › Les prédicats de type

Les prédicats de type

Gardes de type et assertionsavance

Une fonction qui renvoie boolean n'apprend rien au compilateur. Le test réussit, et la valeur reste unknown.

function estChaine(x: unknown): boolean {
  return typeof x === "string";
}

const v: unknown = recupererValeur();
if (estChaine(v)) {
  v.toUpperCase();      // ❌ TS18046 : « v » est de type « unknown »
}

Un prédicat de type change la signature, pas le corps :

function estChaine(x: unknown): x is string {
  return typeof x === "string";
}

if (estChaine(v)) {
  v.toUpperCase();      // ✅ v est string
}

x is string se lit « si cette fonction renvoie true, alors x est une string ». C'est une information que le compilateur ne peut pas déduire d'un appel de fonction : il voit boolean, et un boolean ne désigne personne.

Le compilateur croit la signature, pas le corps

function estClient(x: unknown): x is Client {
  return true;          // ✅ accepté sans un mot
}

Aucune erreur. Le seul contrôle est que Client soit affectable au type du paramètre — autrement TS2677. La justesse du test reste à votre charge.

Un prédicat faux est pire qu'une assertion. x as Client est visible sur le site d'appel et met en garde. estClient(x) ressemble à une vérification, et le code qui l'appelle cesse de se méfier.

Les termes à connaître

Prédicat de type

Une signature de retour de la forme x is T au lieu de boolean. Elle dit au compilateur que la valeur true prouve que le paramètre est un T.

Promesse non vérifiée

Le compilateur croit la signature, pas le corps. Un prédicat qui renvoie true à tort affine quand même le type — et personne ne le signale.

Affinage dans les deux branches

Un prédicat affine le then vers T et, si la valeur était une union, le else vers le reste de l'union.

`TS2677`

« A type predicate's type must be assignable to its parameter's type. » Le seul contrôle que le compilateur fait sur un prédicat : le type annoncé doit être compatible avec le type du paramètre.

Prédicat inféré

Depuis TypeScript 5.5, une fonction courte qui ne fait qu'un test de type voit son prédicat déduit, sans annotation. Les fonctions un peu moins triviales rendent toujours boolean.

`this is T`

Un prédicat portant sur this, écrit comme type de retour d'une méthode. Il affine l'objet lui-même, pas un paramètre.

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.