Assertion non nulle (!)

Un point d’exclamation après une expression retire null et undefined du type sans vérification.

Sur cette page

Exemple

#
TypeScript
const lessons = new Map<string, number>([['html', 11], ['css', 9]])

const htmlModules = lessons.get('html')!
console.log(htmlModules + 1)

const pythonModules = lessons.get('python') ?? 0
console.log(pythonModules)
Résultat
12
0

Définition et utilisation

#

L’opérateur ! placé après une expression dit au compilateur : « cette valeur n’est certainement pas null ni undefined ». Le type HTMLElement | null devient HTMLElement.

Comme l’assertion as, il ne vérifie rien à l’exécution. Si la valeur se révèle null malgré tout, vous obtenez une erreur à l’exécution, exactement celle dont strictNullChecks vous protège.

Ne l’utilisez que si vous êtes sûr grâce à une autre source, par exemple l’élément existe dans le modèle de la page. Dans les autres cas, il vaut mieux gérer l’absence de valeur avec une condition ou avec les opérateurs ?. et ??.

Syntaxe

#
Syntaxe
expression!

Plus d’exemples

#
Un point d’exclamation là où il n’y a pas de valeur
TypeScript
const missing = lessons.get('rust')!
try {
  console.log(missing.toFixed(0))
} catch (error) {
  console.log('Erreur à l’exécution : la valeur était undefined')
}
Résultat
Erreur à l’exécution : la valeur était undefined

Bonnes pratiques

#
  • Chaque ! dans votre code est un endroit où vous désactivez la protection du compilateur. Demandez-vous s’il ne vaut pas mieux gérer l’absence de valeur.
  • Dans les tests et les scripts rapides, ! est parfois acceptable. Dans le code de production, préférez des vérifications explicites.

Entrées associées

#

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