JavaScriptNombres et Math

Number.isNaN()

Vérifie si une valeur est exactement NaN.

Renvoie
true ou false.
Sur cette page

Exemple

#
JavaScript
const age = Number('vingt')

console.log(age)
console.log(Number.isNaN(age))
console.log(age === NaN)
console.log(Number.isNaN('abc'))
console.log(isNaN('abc'))
Console
NaN
true
false
false
true

Définition et utilisation

#

La fonction Number.isNaN() renvoie true seulement si la valeur donnée est le nombre NaN (Not a Number, « pas un nombre »). NaN apparaît par exemple après une conversion ratée d’un texte en nombre, ou après une division 0 / 0.

Impossible de le vérifier par une comparaison, car NaN est la seule valeur en JavaScript qui n’est pas égale à elle-même : NaN === NaN renvoie false.

L’ancienne fonction globale isNaN() convertit d’abord l’argument en nombre, donc elle renvoie aussi true pour de simples chaînes comme "abc". Number.isNaN() ne fait pas cela et est plus prévisible.

Syntaxe

#
Syntaxe
Number.isNaN(value)

Paramètres

#
  • value

    valeur quelconque

    La valeur à vérifier.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Après chaque conversion d’un texte en nombre, vérifiez le résultat avec Number.isNaN().
  • Évitez la fonction globale isNaN(), car elle convertit les types en silence.

Entrées associées

#

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