Assertion de type (as)
Indiquer au compilateur le type d’une valeur lorsque vous en savez plus que lui.
Exemple
#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)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
#const value = expression as TypePlus d’exemples
#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')
}Erreur à l’exécution, alors que le compilateur ne s’est pas plaint
Bonnes pratiques
#- Considérez
ascomme 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 Tsignifie presque toujours que quelque chose cloche dans les types.
Entrées associées
#- as vs satisfiesas dit au compilateur de faire confiance à votre type sans rien vérifier, tandis que satisfies vérifie la conformité au type et garde le type exact déduit de la valeur.
- satisfiesVérifie qu’une valeur correspond à un type sans modifier le type déduit.
- Type guards (value is T)Des fonctions de vérification personnalisées qui restreignent le type à l’endroit de l’appel.
- Assertion non nulle (!)Un point d’exclamation après une expression retire null et undefined du type sans vérification.
- unknownL’équivalent sûr de any : une valeur de type inconnu qu’il faut d’abord vérifier.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.