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

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.

Sources