Restriction de type (narrowing)

Déterminer un type plus précis pour une valeur à partir des vérifications présentes dans votre code.

Sur cette page

Exemple

#
TypeScript
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]))
Résultat
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

#
Syntaxe
if (typeof value === "string") {
  // value: string
}

Bonnes pratiques

#
  • Un return anticipé 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

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.