Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Number.isNaN : test exact de NaN sans coercition

Number.isNaN renvoie true uniquement si l’argument est de type Number et correspond à la valeur spéciale NaN.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.isNaN(number)

Number.isNaN(value) vérifie à la fois le type Number et la valeur NaN. Elle renvoie true pour un NaN issu d’une conversion numérique impossible ou d’une opération arithmétique indéfinie, et false pour tout autre Number, y compris Infinity et -0. L’absence d’argument donne false, car undefined n’est pas un Number.

La méthode n’applique pas ToNumber : "NaN", "oops", undefined, les objets, BigInt et Symbol donnent false sans conversion ni TypeError. Le isNaN global diffère car il convertit d’abord ; isNaN("oops") vaut donc true, mais Number.isNaN("oops") vaut false, et certaines conversions de la forme globale peuvent lever une exception. Number.isNaN est généralement plus sûr pour tester le résultat d’un calcul.

La méthode existe depuis ECMAScript 2015 et n’est pas un constructeur. L’exemple convertit explicitement des mesures avec Number, puis marque seulement un résultat NaN comme invalide. Notez que Number("") vaut 0 : Number.isNaN ne remplace donc pas la vérification que le format autorise un texte vide.

Exemples

function parseReading(text) {
  const value = Number(text);
  return Number.isNaN(value) ? "invalid" : value.toFixed(1);
}

console.log(["18.5", "oops", ""].map(parseReading).join(" | "));
console.log(Number.isNaN(NaN), Number.isNaN("NaN"), Number.isNaN());
console.log(isNaN("oops"), Number.isNaN("oops"));
console.log(Number.isNaN(1n), Number.isNaN(Symbol("x")));

Résultat

18.5 | invalid | 0.0
true false false
true false
false false

Number.isNaN → validation du résultat d’une conversion explicite de mesures

Sources