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
- ECMAScript 2024 — NaN
- ECMAScript 2024 — The Number Type
- ECMAScript 2024 — Number.NaN
- ECMAScript 2024 — Number.isNaN ( number )
- ECMAScript 2024 — isNaN ( number )
- ECMAScript 2024 — ToNumber ( argument )
- ECMAScript 2024 — Object.is ( value1, value2 )
- ECMAScript 2024 — Number.isFinite ( number )
- NaN - JavaScript | MDN