Assertion de type (as)

Indiquer au compilateur le type d’une valeur lorsque vous en savez plus que lui.

Sur cette page

Exemple

#
TypeScript
type Lesson = { title: string; minutes: number }

const raw = '{"title":"Grid","minutes":16}'
const lesson = JSON.parse(raw) as Lesson

console.log(lesson.title.toUpperCase(), lesson.minutes)
Résultat
GRID 16

Définition et utilisation

#

L’assertion value as Type dit au compilateur : « fais-moi confiance, c’est un Type ». Elle ne modifie pas la valeur et ne vérifie rien à l’exécution. Elle n’affecte que le type à la compilation.

Parmi les cas raisonnables : un élément du DOM dont vous savez qu’il s’agit d’un champ de formulaire (as HTMLInputElement), ou des données déjà validées par une autre couche de l’application.

Une assertion utilisée à l’excès est une porte dérobée silencieuse pour les bugs. Si la valeur a en réalité une autre forme, le programme ne casse qu’à l’exécution. Partout où c’est possible, utilisez le narrowing et les type guards plutôt que as.

Syntaxe

#
Syntaxe
const value = expression as Type

Plus d’exemples

#
Une assertion ne valide pas les données
TypeScript
const broken = JSON.parse('{"name":"Grid"}') as Lesson

try {
  console.log(broken.title.toUpperCase())
} catch (error) {
  console.log('Erreur à l’exécution, alors que le compilateur ne s’est pas plaint')
}
Résultat
Erreur à l’exécution, alors que le compilateur ne s’est pas plaint

Bonnes pratiques

#
  • Considérez as comme un dernier recours. Pour des données venues de l’extérieur, il vaut mieux vérifier leur forme avec un type guard.
  • Une double assertion as unknown as T signifie presque toujours que quelque chose cloche dans les types.

Entrées associées

#

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