Number

Les valeurs Number représentent les nombres décimaux comme 37 ou -9.25.

Le constructeur Number() contient des constantes et des méthodes pour manipuler les nombres. Les valeurs des autres types peuvent être converties en nombre à l'aide de la fonction Number().

Description

Les nombres sont généralement exprimés sous leur forme littérale comme 255 ou 3.14159. La grammaire lexicale contient une référence plus détaillée à ce sujet.

js
255; // deux cent vingt-cinq
255.0; // le même nombre
255 === 255.0; // true
255 === 0xff; // true (notation hexadécimale)
255 === 0b11111111; // true (notation binaire)
255 === 0.255e3; // true (notation scientifique)

En JavaScript, un littéral numérique comme 37 est bien une valeur décimale et pas particulièrement entière. Il n'existe pas de type entier distinct pour un usage courant (le type BigInt existe mais sert à représenter les très grandes valeurs entières et pas les nombres courants comme 37).

Quand on utilise Number(valeur) comme fonction, elle permet de convertir une chaîne de caractères ou une valeur d'un autre type en valeur de type Number. Si la valeur ne peut pas être convertie, elle renvoie NaN

js
Number("123"); // renvoie le nombre 123
Number("123") === 123; // true

Number("licorne"); // NaN
Number(undefined); // NaN

Encodage des valeurs numériques

Le type JavaScript Number utilise une représentation binaire à précision double sur 64 bits telle que décrite par le standard IEEE 754. Cela signifie que les valeurs décimales peuvent être représentées, avec certaines limites sur l'amplitude et la précision. En résumé, un nombre à précision double IEEE 754 utilise 64 bits pour représenter trois fragments :

  • 1 bit pour le signe (indiquant si le nombre est positif ou négatif)
  • 11 bits pour l'exposant (pouvant aller de -1022 à 1023)
  • 52 bits pour la mantisse (représentant un nombre entre 0 et 1)

La mantisse est la partie qui représente la valeur effective (les chiffres significatifs). L'exposant indique la puissance de deux par laquelle la mantisse devrait être multipliée. On peut écrire la formule suivante (proche de la notation scientifique) :

Nombre = ( 1 ) signe ( 1 + mantisse ) 2 exposant \text{Number} = ({-1})^{\text{signe}} \cdot (1 + \text{mantisse}) \cdot 2^{\text{exposant}}

La mantisse est stockée sur 52 bits, interprétés comme les chiffres de la partie fractionnaire de 1.… en binaire. La précision de la mantisse est donc 2-52 (valeur qu'on peut obtenir via Number.EPSILON), soit entre 15 et 17 chiffres en écriture décimale. Les valeurs arithmétiques au-delà de cette précision seront arrondies.

La valeur la plus grande qui puisse être représentée par un nombre en JavaScript est 21024 - 1 (ici l'exposant vaut 1023 et la mantisse vaut 0.1111… en base 2), valeur qu'on peut obtenir avec Number.MAX_VALUE. Les valeurs supérieures à celle-ci sont remplacées par la constante spéciale Infinity.

Les entiers peuvent uniquement être représentés sans perte de précision dans l'intervalle -253 + 1 à 253 - 1 inclus (valeurs qu'on peut obtenir avec Number.MIN_SAFE_INTEGER et Number.MAX_SAFE_INTEGER), car la mantisse ne peut contenir que 53 bits (en comptant le 1).

De plus amples précisions sont disponibles dans le standard ECMAScript.

Conversion numérique

De nombreuses opérations natives qui s'attendent à manipuler des nombres appliquent d'abord une conversion à leurs arguments pour les transformer en nombre (ce qui explique pourquoi les objets Number se comportent généralement comme des valeurs numériques primitives). Cette opération de conversion peut être résumée ainsi :

  • Les nombres sont renvoyés tels quels.
  • undefined est transformé en NaN.
  • null est transformé en 0.
  • true est transformé en 1, et false est transformé en 0.
  • Les chaînes de caractères sont converties en les analysant comme si elles contenaient un littéral numérique. Toute erreur d'analyse produira NaN. Il y a quelques différences mineures par rapport à littéral numérique :
    • Les blancs et fins de lignes au début ou à la fin sont ignorés.
    • Un chiffre 0 en début de chaîne n'indique pas un littéral en base octale (et n'est pas rejeté en mode strict).
    • + et - sont autorisés au début de la chaîne pour indiquer le signe. Dans du code littéral, ils semblent faire partie du littéral, mais sont en réalité des opérateurs unaires distincts. Toutefois, le signe ne peut apparaître qu'une seule fois et ne pas être suivi par des blancs.
    • Infinity et -Infinity sont reconnus comme des valeurs littérales. Dans du code réel, il s'agit de variables globales.
    • Les chaînes de caractères vides ou qui ne contiennent que des blancs sont converties en 0.
    • Les séparateurs numériques (le tiret bas dans 1_050.95) ne sont pas autorisés.
  • Les grands entiers (BigInts) déclenchent une exception TypeError pour empêcher une perte de précision involontaire lors de la conversion implicite.
  • Les symboles déclenchent une exception TypeError
  • Les objets sont d'abord convertis en une valeur primitive à l'aide de leurs méthodes [@@toPrimitive]() (où "number" est fourni comme indication), valueOf(), et toString(), selon cet ordre. La valeur primitive obtenue est alors convertie en nombre.

Il existe deux méthodes qui permettent de déclencher cette conversion (ou presque) en JavaScript :

Number.parseFloat() et Number.parseInt() sont semblables à Number() mais servent uniquement à convertir des chaînes de caractères, en suivant des règles légèrement différentes. Par exemple, parseInt() ne reconnaît pas le point décimal et parseFloat() ne reconnaît pas le préfixe 0x.

Conversion entière

Certaines opérations s'attendent à manipuler des entiers, notamment celles qui fonctionnent avec des indices de tableaux ou de chaînes de caractères, des composantes temporelles et des bases numériques. Après la conversion numérique décrite ci-avant, le résultat est tronqué en un nombre entier (la partie fractionnaire est ignorée). Si le nombre est ±Infinity, il est renvoyé tel quel. Si le nombre est NaN ou -0, c'est 0 qui est renvoyé. Le résultat est donc toujours un entier (qui n'est pas -0) ou ±Infinity.

On notera que, pour la conversion entière, undefined et null deviennent 0, car undefined est d'abord converti en NaN lors de la conversion numérique, puis en 0 lors de la conversion entière qui suit.

Conversion en nombre à longueur fixe

Certaines fonctions JavaScript « bas-niveau » permettent de manipuler l'encodage binaire des nombres entiers, notamment les opérateurs binaires et les objets TypedArray. Les opérateurs binaires convertissent toujours leurs opérandes en entiers sur 32 bits. Dans ces cas, après la conversion numérique décrite avant, le nombre est normalisé à la largeur souhaitée en tronquant la partie fractionnaire, puis en considérant les bits les plus faibles de la représentation de l'entier en complément à deux.

js
new Int32Array([1.1, 1.9, -1.1, -1.9]); // Int32Array(4) [ 1, 1, -1, -1 ]

new Int8Array([257, -257]); // Int8Array(2) [ 1, -1 ]
// 257 = 0001 0000 0001
//     =      0000 0001 (mod 2^8)
//     = 1
// -257 = 1110 1111 1111
//      =      1111 1111 (mod 2^8)
//      = -1 (comme entier signé)

new Uint8Array([257, -257]); // Uint8Array(2) [ 1, 255 ]
// -257 = 1110 1111 1111
//      =      1111 1111 (mod 2^8)
//      = 255 (comme entier non-signé)

Constructeur

Number()

Crée une nouvelle valeur Number.

Lorsque Number est appelé comme constructeur (avec le mot-clé new), il crée un objet Number qui n'est pas une valeur primitive. Par exemple, on aura typeof new Number(42) === "object", et new Number(42) !== 42 (même si new Number(42) == 42).

Attention : Il est plutôt rare de devoir utiliser Number comme constructeur.

Propriétés statiques

Number.EPSILON

Le plus petit intervalle entre deux valeurs qu'il est possible de représenter en JavaScript.

Number.MAX_SAFE_INTEGER

La valeur entière maximale qu'on peut représenter en JavaScript (253 - 1).

Number.MAX_VALUE

La valeur numérique maximale qu'on peut représenter en JavaScript.

Number.MIN_SAFE_INTEGER

La valeur entière minimale qu'on peut représenter en JavaScript (-(253 - 1)).

Number.MIN_VALUE

La plus petite valeur positive qu'on peut représenter en JavaScript, c'est-à-dire le nombre le plus près de zéro qui n'est pas égal à zéro et qu'on peut représenter en JavaScript.

Number.NaN

Une valeur spéciale pour représenter les valeurs non-numériques (NaN correspond à « Not a Number » en anglais, qui signifie « n'est pas un nombre »).

Number.NEGATIVE_INFINITY

Une valeur spéciale pour représenter l'infini négatif. Cette valeur est renvoyée quand on dépasse les valeurs représentables.

Number.POSITIVE_INFINITY

Une valeur spéciale pour représenter l'infini (positif). Cette valeur est renvoyée quand on dépasse les valeurs représentables.

Méthodes statiques

Number.isFinite()

Cette méthode permet de déterminer si la valeur numérique passée en argument est un nombre fini.

Number.isInteger()

Cette méthode permet de déterminer si la valeur passée en argument est un entier.

Number.isNaN()

Cette méthode permet de déterminer si la valeur passée en argument vaut NaN.

Number.isSafeInteger()

Cette méthode permet de déterminer si la valeur passée en argument peut correctement être représentée comme un entier en JavaScript (savoir si elle est comprise entre -(253 - 1) et 253 - 1).

Number.parseFloat()

Cette méthode correspond à la méthode parseFloat() de l'objet global.

Number.parseInt()

Cette méthode correspond à la méthode parseInt() de l'objet global.

Propriétés des instances

Ces propriétés sont définies sur Number.prototype et partagées par l'ensemble des instances de Number.

Number.prototype.constructor

La fonction utilisée comme constructeur pour créer l'instance objet. Pour les instances Number, la valeur initiale est le constructeur Number().

Méthodes des instances

Number.prototype.toExponential()

Retourne une chaîne représentant le nombre en notation exponentielle.

Number.prototype.toFixed()

Retourne une chaîne représentant le nombre avec la notation en virgule fixe.

Number.prototype.toLocaleString()

Retourne une chaîne avec une représentation du nombre tenant compte de la locale. Surcharge la méthode Object.prototype.toLocaleString().

Number.prototype.toPrecision()

Retourne une chaîne représentant le nombre avec une précision donnée en notation en virgule fixe ou exponentielle.

Number.prototype.toString()

Retourne une chaîne représentant le nombre dans une base numérique donnée. Surcharge la méthode Object.prototype.toString().

Number.prototype.valueOf()

Retourne la valeur primitive de l'objet spécifié. Surcharge la méthode Object.prototype.valueOf().

Exemples

Utiliser l'objet Number pour affecter des valeurs numériques à des variables

Dans l'exemple suivant, on utilise les propriétés de l'objet Number pour affecter des valeurs à des variables numériques :

js
const plusGrandNombre = Number.MAX_VALUE;
const plusPetitNombre = Number.MIN_VALUE;
const infini = Number.POSITIVE_INFINITY;
const infiniNégatif = Number.NEGATIVE_INFINITY;
const nonNumérique = Number.NaN;

Intervalle entier pour Number

Dans l'exemple suivant, on illustre les valeurs numériques entières maximales et minimales qu'on peut représenter avec une valeur Number :

js
const biggestInt = Number.MAX_SAFE_INTEGER; // (2**53 - 1) => 9007199254740991
const smallestInt = Number.MIN_SAFE_INTEGER; // -(2**53 - 1) => -9007199254740991

Lorsqu'on analyse et convertit des données JSON, les valeurs en dehors de cet intervalle peuvent entraîner des erreurs ou des corruptions de valeurs lors de leurs conversions.

Selon les objets qu'on souhaite représenter, on peut utiliser String dans certains cas pour représenter certaines valeurs.

Pour les plus grands nombres, on pourra utiliser le type BigInt.

Utiliser Number() pour convertir un objet Date

Dans l'exemple suivant, on convertit un objet Date en une valeur numérique grâce à la fonction Number() :

js
const d = new Date("1995-12-17T03:24:00");
console.log(Number(d));

Ceci affichera 819199440000.

Convertir une chaîne de caractères représentant une valeur numérique, ou null en un nombre

js
Number("123"); // 123
Number("123") === 123; // true
Number("12.3"); // 12.3
Number("12.00"); // 12
Number("123e-1"); // 12.3
Number(""); // 0
Number(null); // 0
Number("0x11"); // 17
Number("0b11"); // 3
Number("0o11"); // 9
Number("toto"); // NaN
Number("100a"); // NaN
Number("-Infinity"); // -Infinity

Spécifications

Specification
ECMAScript Language Specification
# sec-number-objects

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi