CKTIS / JavaScript
isNaN() — vérifier NaN après conversion
La fonction globale isNaN(value) convertit d’abord son argument en Number, puis vérifie si le résultat est NaN. Contrairement à Number.isNaN(), elle peut renvoyer true pour des chaînes ou undefined : ce n’est donc pas un test général de validité d’un nombre.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
isNaN(value)isNaN(value) est une fonction globale d’ECMAScript, et non une API de navigateur. Elle applique l’opération ToNumber à son argument et renvoie true si le résultat est NaN ; sinon, elle renvoie false. NaN est une valeur spéciale du type Number qui représente un résultat qui n’est pas un nombre valide, comme le résultat de 0 / 0.
La conversion compte : isNaN("hello") et isNaN(undefined) renvoient true, tandis que isNaN("42"), isNaN("") et isNaN(null) renvoient false. La chaîne vide et null sont convertis en 0. Appeler isNaN() sans argument revient à lui passer undefined et renvoie true.
Number.isNaN(value) n’effectue aucune conversion : elle ne renvoie true que pour la valeur Number NaN. Utilisez-la si vous voulez vérifier la valeur elle-même plutôt que le résultat de sa conversion. Ne comparez pas avec NaN à l’aide de ===, car même NaN === NaN donne false. Un résultat false de isNaN ne prouve ni que l’argument est un nombre ni qu’il est fini : isNaN(Infinity) donne également false.
La conversion peut lever une exception au lieu de renvoyer un booléen. Un argument de type Symbol ou BigInt, comme isNaN(1n), provoque un TypeError. La conversion d’un objet peut exécuter son code de conversion et propager une exception levée. Ne considérez donc pas isNaN comme un validateur sûr pour des données arbitraires.
Exemples
const values = [NaN, "hello", "42", "", null, undefined, Infinity];
for (const value of values) {
console.log(`${String(value)}: ${isNaN(value)} / ${Number.isNaN(value)}`);
}Résultat
NaN: true / true hello: true / false 42: false / false : false / false null: false / false undefined: true / false Infinity: false / false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.