Number

valeur

La valeur numérique pour l'objet qu'on souhaite créer.

L'objet Number est principalement utilisé dans les cas de figure suivants :

• Si l'argument ne peut pas être converti en un nombre, il renverra NaN.
• Dans un contexte de fonction simple (quand il n'est pas utilisé comme un constructeur avec l'opérateur new), Number peut être utilisé afin d'effectuer des conversions.

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 (2^53 - 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 (-(2^53 - 1)).

Number.MIN_VALUE

La plus petite valeur qu'on peut représenter en JavaScript, c'est-à-dire le plus petit nombre positif (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.

Number.POSITIVE_INFINITY

Une valeur spéciale pour représenter l'infini (positif).

Number.prototype (en-US)

Cet objet permet d'ajouter des propriétés aux instances de Number.

Number.isNaN()

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

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.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 -(2^53 - 1) et 2^53 - 1).

Number.toInteger() Obsolète

Cette méthode est utilisée afin d'évaluer et de convertir la valeur passée en argument en entier (ou en l'infini). Cette méthode a été supprimée.

Number.parseFloat(string)

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

Number.parseInt(string, [radix])

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

Toutes les instances de Number héritent de Number.prototype (en-US). Il est possible de modifier le prototype du constructeur Number pour affecter toutes les instances de Number.

Number.prototype.toExponential(fractionDigits)

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

Number.prototype.toFixed(digits)

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

Number.prototype.toLocaleString([locales [, options]])

Retourne une chaîne avec une représentation sensible à la langue de ce nombre. Surcharge la méthode Object.prototype.toLocaleString().

Number.prototype.toPrecision(precision)

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

Number.prototype.toString([radix])

Retourne une chaîne représentant le nombre dans une base numérique (radix) 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().

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

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

Dans l'exemple suivant, on illustre les valeurs numériques maximales et minimales (exclues) qu'on peut représenter avec un nombre en JavaScript (pour plus de détails, voir le chapitre 6.1.6 du standard ECMAScript) :

var biggestInt = 9007199254740992; //Number.MAX_SAFE_INTEGER+1 (2^53-1)
var smallestInt = -9007199254740992; //Number.MIN_SAFE_INTEGER-1 -(2^53-1)

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.

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

var d = new Date('December 17, 1995 03:24:00');
console.log(Number(d));

Ceci affichera "819167040000".

• NaN
• L'objet global Math
• Les types de données en JavaScript
• Un billet sur le type Number (en anglais)
• Représenter de grands entiers avec une précision arbitraire : BigInt