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