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

CKTIS / JavaScript

NaN : la valeur spéciale de type Number et sa détection

`NaN` est une valeur spéciale du type `Number`. Pour la détecter, utilisez `Number.isNaN()` : contrairement à la fonction globale `isNaN()`, cette méthode ne convertit pas son argument.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

NaN
Number.NaN
Number.isNaN(value)
isNaN(value)

NaN (abréviation de « Not-a-Number ») est une valeur primitive spéciale du type Number. Par exemple, 0 / 0 et Number("oops") produisent cette valeur sans lever d’exception. typeof NaN renvoie "number". La propriété globale NaN et la propriété statique Number.NaN donnent accès à la même valeur, distincte de la chaîne "NaN".

Utilisez Number.isNaN(value) pour tester une valeur. La méthode renvoie true uniquement pour NaN et ne convertit pas son argument. Ni == ni === ne considèrent NaN comme égal à lui-même : NaN === NaN vaut false. En revanche, Object.is(NaN, Number.NaN) renvoie true, car la méthode applique une autre règle de comparaison.

La fonction globale isNaN(value) essaie d’abord de convertir son argument en une valeur de type Number. C’est pourquoi isNaN("oops") renvoie true, alors que isNaN("") renvoie false : la chaîne vide est convertie en 0. Pour les valeurs de type BigInt ou Symbol, cette conversion lève une exception TypeError ; Number.isNaN() renvoie false pour ces valeurs.

Si vous avez besoin d’une valeur finie de type Number, utilisez Number.isFinite(value). Le test !Number.isNaN(value) ne suffit pas : il accepte aussi les valeurs infinies et les valeurs d’autres types.

Exemples

{
  const input = "oops";
  const value = Number(input);
  console.log(value);
  console.log(Number.isNaN(input));
  console.log(isNaN(input));
  console.log(Number.isNaN(value));
  console.log(value === NaN);
  console.log(Object.is(value, Number.NaN));
}

Résultat

NaN
false
true
true
false
true

`input` reste une chaîne ; c’est `Number(input)` qui produit `NaN`. Les deux dernières lignes de la sortie montrent la différence entre `===` et `Object.is()`.

Leçons associées

  • JavaScript · Leçon 12 · Intermédiaire · Version : 3

Sources