isNaN()

Exemple interactif

function milliseconds(x) {
  if (isNaN(x)) {
    return "N'est pas un nombre !";
  }
  return x * 1000;
}

console.log(milliseconds("100F"));
// Rsultat attendu : "N'est pas un nombre !"

console.log(milliseconds("0.0314E+2"));
// Rsultat attendu : 3140

Syntaxe

isNaN(value)

Paramtres

value

La valeur tester.

Valeur de retour

true si la valeur donne est NaN aprs avoir t convertie en nombre ; sinon, false.

Description

isNaN() est une proprit fonction de l'objet global.

Pour les valeurs numriques, isNaN() teste si le nombre vaut NaN. Lorsque l'argument pass la fonction isNaN() n'est pas de type nombre, la valeur est d'abord contrainte un nombre, puis la valeur rsultante est compare NaN.

Ce comportement de isNaN() pour les arguments non numriques peut prter confusion ! Par exemple, une chane vide est convertie en 0, tandis qu'une valeur boolenne est convertie en 0 ou 1 ; ces deux valeurs ne sont intuitivement  pas des nombres , mais elles ne valent pas NaN, donc isNaN() retourne false. Ainsi, isNaN() ne rpond ni la question  l'entre est-elle la valeur flottante NaN  ni la question  l'entre n'est-elle pas un nombre .

Number.isNaN() est une faon plus fiable de tester si une valeur est la valeur numrique NaN ou non. Alternativement, l'expression x !== x peut tre utilise, et aucune de ces solutions n'est sujette aux faux positifs qui rendent le isNaN() global peu fiable. Pour tester si une valeur est un nombre, utilisez typeof x === "number".

La fonction isNaN() rpond la question  l'entre est-elle fonctionnellement quivalente NaN lorsqu'elle est utilise dans un contexte numrique . Si isNaN(x) retourne false, vous pouvez utiliser x dans une expression arithmtique comme s'il s'agissait d'un nombre valide qui n'est pas NaN. Si isNaN(x) retourne true, x sera contraint NaN et la plupart des expressions arithmtiques retourneront NaN (car NaN se propage). Vous pouvez utiliser cela, par exemple, pour tester si un argument d'une fonction est traitable arithmtiquement (utilisable  comme  un nombre), et grer les valeurs qui ne sont pas assimilables un nombre en lanant une erreur, en fournissant une valeur par dfaut, etc. De cette faon, vous pouvez avoir une fonction qui exploite toute la polyvalence offerte par JavaScript en convertissant implicitement les valeurs selon le contexte.

Exemples

Notez comment isNaN() retourne true pour des valeurs qui ne sont pas la valeur NaN mais qui ne sont pas des nombres non plus :

isNaN(NaN); // true
isNaN(undefined); // true
isNaN({}); // true

isNaN(true); // false
isNaN(null); // false
isNaN(37); // false

// Chanes de caractres
isNaN("37"); // false : "37" est converti en nombre 37 qui n'est pas NaN
isNaN("37.37"); // false : "37.37" est converti en nombre 37.37 qui n'est pas NaN
isNaN("37,5"); // true
isNaN("123ABC"); // true : Number("123ABC") est NaN
isNaN(""); // false : la chane vide est convertie en 0 qui n'est pas NaN
isNaN(" "); // false : une chane avec des espaces est convertie en 0 qui n'est pas NaN

// Dates
isNaN(new Date()); // false ; Les objets Date peuvent tre convertis en nombre (timestamp)
isNaN(new Date().toString()); // true ; la reprsentation sous forme de chane d'un objet Date ne peut pas tre analyse comme un nombre

// Tableaux
isNaN([]); // false ; la reprsentation primitive est "", qui se convertit en nombre 0
isNaN([1]); // false ; la reprsentation primitive est "1"
isNaN([1, 2]); // true ; la reprsentation primitive est "1,2", qui ne peut pas tre analyse comme un nombre

Spcifications

Compatibilit des navigateurs

Voir aussi

• La proprit globale NaN
• La mthode Number.isNaN()