Restriction de type (narrowing)
Déterminer un type plus précis pour une valeur à partir des vérifications présentes dans votre code.
Exemple
#function total(input: number | number[] | null): number {
if (input === null) return 0
if (Array.isArray(input)) return input.reduce((sum, n) => sum + n, 0)
return input
}
console.log(total(null))
console.log(total(7))
console.log(total([3, 4, 5]))0 7 12
Définition et utilisation
#Le narrowing est le mécanisme qui permet à TypeScript d’en savoir plus sur une valeur, dans un bloc de code donné, que ce que dit sa seule déclaration. Après une vérification comme if (typeof value === "string"), la variable a le type string à l’intérieur de ce bloc, même si c’était une union auparavant.
Le compilateur comprend de nombreux types de vérifications : typeof, instanceof, l’opérateur in, les comparaisons avec des littéraux, les tests contre null et undefined, Array.isArray() et vos propres fonctions de type guard.
Cela fonctionne aussi dans l’autre sens : après un return dans une branche, TypeScript sait que ce cas ne s’applique plus dans le reste de la fonction.
Syntaxe
#if (typeof value === "string") {
// value: string
}Bonnes pratiques
#- Un
returnanticipé pour les cas limites (null, tableau vide) simplifie le reste de la fonction, car le type est déjà restreint. - Lorsqu’une vérification devient complexe, extrayez-la dans une fonction type guard de type
value is T.
Entrées associées
#- Type guards (value is T)Des fonctions de vérification personnalisées qui restreignent le type à l’endroit de l’appel.
- typeof (dans les types)Récupère le type d’une variable ou d’une valeur pour l’utiliser ailleurs.
- instanceofRestreint le type à une classe en vérifiant si l’objet a été créé par celle-ci.
- L’opérateur inRestreint une union d’objets en vérifiant si un objet possède une propriété donnée.
- Union (A | B)Un type qui peut être l’un de plusieurs types.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.