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 Clientest 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 Tau lieu deboolean. Elle dit au compilateur que la valeurtrueprouve que le paramètre est unT.- 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
thenversTet, si la valeur était une union, leelsevers 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.
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.