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

CKTIS / JavaScript

Number.NaN : valeur Number « pas un nombre »

Number.NaN est la valeur spéciale de Number pour un résultat numérique invalide ou indéterminé, identique au NaN global.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

Number.NaN

Number.NaN est la valeur NaN de type Number, identique au NaN global. Elle peut provenir d’une conversion numérique impossible ou d’une opération comme 0 / 0. Ce n’est pas une exception et la lecture de la propriété ne lève rien ; beaucoup d’opérations numériques ultérieures avec NaN produisent aussi NaN.

NaN est la seule valeur JavaScript différente d’elle-même avec == comme avec === ; value === Number.NaN est donc toujours faux. Utilisez Number.isNaN(value), sans coercition, ou Object.is(value, Number.NaN). typeof Number.NaN vaut "number" ; les comparaisons d’ordre avec NaN sont fausses et JSON.stringify écrit NaN dans les tableaux et propriétés d’objet sous forme de null.

La propriété existe depuis ECMAScript 1 et n’est ni modifiable, ni énumérable, ni configurable. L’exemple renvoie Number.NaN comme résultat explicite d’une analyse de mesure échouée et oppose les bons et mauvais tests. Un résultat d’erreur distinct est souvent plus clair dans une API publique, car NaN peut se propager silencieusement ou changer de sens à la sérialisation.

Le NaN global est une propriété de l’objet global ayant la même valeur Number que Number.NaN ; leur comparaison d’identité avec === reste pourtant false, car toute valeur NaN est différente d’elle-même. La propriété globale n’est ni modifiable, ni énumérable, ni configurable, mais l’identifiant NaN peut être masqué par une liaison locale ; Number.NaN peut donc être moins ambigu. Dans la leçon source, un âge vide est explicitement converti en NaN global puis refusé par Number.isInteger().

Exemples

function parseMeasurement(text) {
  const value = Number(text);
  return Number.isNaN(value) ? Number.NaN : value;
}

const failed = parseMeasurement("bad");
console.log(Number.isNaN(failed), failed === Number.NaN, Object.is(failed, Number.NaN));
console.log(typeof Number.NaN, Number.NaN === NaN);
console.log(JSON.stringify({ value: Number.NaN }));
const descriptor = Object.getOwnPropertyDescriptor(Number, "NaN");
console.log(descriptor.writable, descriptor.enumerable, descriptor.configurable);

Résultat

true false true
number false
{"value":null}
false false false

Number.NaN → résultat d’échec explicite et test correct de NaN

Sources