Number

L'objet Number est une enveloppe objet (wrapper) autour du type primitif numérique. Autrement dit, il est utilisé pour manipuler les nombres comme des objets. Pour créer un objet Number, on utilise le constructeur Number().

Le type JavaScript Number utilise une représentation binaire à précision double sur 64 bits telle que décrite par le standard IEEE 754. Les implémentations plus récentes offrent un nouveau type : BigInt qui permet de représenter des entiers avec une précision arbitraire.

Syntaxe

new Number(valeur);
var a = new Number('123'); // a === 123 donnera false
var b = Number('123'); // b === 123 donnera true
a instanceof Number; // donnera true
b instanceof Number; // donnera false

Paramètres

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

Description

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.

Propriétés

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 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
Cet objet permet d'ajouter des propriétés aux instances de Number.

Méthodes

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 -(253 - 1) et 253 - 1).
Number.toInteger()
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()
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.

Les instances de Number

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

Méthodes

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 :

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;

Intervalle entier pour Number

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 (253-1)
var smallestInt = -9007199254740992; //Number.MIN_SAFE_INTEGER-1 -(253-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.

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 :

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

Ceci affichera "819167040000".

Convertir une chaîne représentant une valeur numérique en un nombre

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

Note  : On pourra également convertir null en 0 grâce à Number : Number(null) donnera 0.

Spécifications

Spécification État Commentaires
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée avec JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
La définition de 'Number' dans cette spécification.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Number' dans cette spécification.
Standard Ajout des méthodes et propriétés suivantes : (EPSILON, isFinite, isInteger, isNaN, parseFloat, parseInt)
ECMAScript Latest Draft (ECMA-262)
La définition de 'Number' dans cette spécification.
Projet

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
NumberChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 3Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
EPSILONChrome Support complet 34Edge Support complet 12Firefox Support complet 25IE Aucun support NonOpera Support complet 21Safari Support complet 9WebView Android Support complet ≤37Chrome Android Support complet 34Firefox Android Support complet 25Opera Android Support complet 21Safari iOS Support complet 9Samsung Internet Android Support complet 2.0nodejs Support complet 0.12
MAX_SAFE_INTEGERChrome Support complet 34Edge Support complet 12Firefox Support complet 31IE Aucun support NonOpera Support complet OuiSafari Support complet 9WebView Android Support complet OuiChrome Android Support complet 34Firefox Android Support complet 31Opera Android Support complet OuiSafari iOS Support complet 9Samsung Internet Android Support complet Ouinodejs Support complet 0.12
MAX_VALUEChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
MIN_SAFE_INTEGERChrome Support complet 34Edge Support complet 12Firefox Support complet 31IE Aucun support NonOpera Support complet OuiSafari Support complet 9WebView Android Support complet OuiChrome Android Support complet 34Firefox Android Support complet 31Opera Android Support complet OuiSafari iOS Support complet 9Samsung Internet Android Support complet Ouinodejs Support complet 0.12
MIN_VALUEChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
NaNChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
NEGATIVE_INFINITYChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
POSITIVE_INFINITYChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
isFiniteChrome Support complet 19Edge Support complet 12Firefox Support complet 16IE Aucun support NonOpera Support complet 15Safari Support complet 9WebView Android Support complet OuiChrome Android Support complet 25Firefox Android Support complet 16Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Ouinodejs Support complet 0.10
isIntegerChrome Support complet 34Edge Support complet 12Firefox Support complet 16IE Aucun support NonOpera Support complet 21Safari Support complet OuiWebView Android Support complet ≤37Chrome Android Support complet 34Firefox Android Support complet 16Opera Android Support complet 21Safari iOS Support complet OuiSamsung Internet Android Support complet 2.0nodejs Support complet 0.12
isNaNChrome Support complet 25Edge Support complet 12Firefox Support complet 15IE Aucun support NonOpera Support complet OuiSafari Support complet 9WebView Android Support complet OuiChrome Android Support complet 25Firefox Android Support complet 15Opera Android Support complet OuiSafari iOS Support complet 9Samsung Internet Android Support complet Ouinodejs Support complet 0.10
isSafeIntegerChrome Support complet 34Edge Support complet 12Firefox Support complet 32IE Aucun support NonOpera Support complet 21Safari Support complet 10WebView Android Support complet ≤37Chrome Android Support complet 34Firefox Android Support complet 32Opera Android Support complet 21Safari iOS Support complet OuiSamsung Internet Android Support complet 2.0nodejs Support complet 0.12
parseFloatChrome Support complet 34Edge Support complet 12Firefox Support complet 25IE Aucun support NonOpera Support complet 21Safari Support complet 9WebView Android Support complet ≤37Chrome Android Support complet 34Firefox Android Support complet 25Opera Android Support complet 21Safari iOS Support complet 9Samsung Internet Android Support complet 2.0nodejs Support complet 0.12
parseIntChrome Support complet 34Edge Support complet 12Firefox Support complet 25IE Aucun support NonOpera Support complet 21Safari Support complet 9WebView Android Support complet ≤37Chrome Android Support complet 34Firefox Android Support complet 25Opera Android Support complet 21Safari iOS Support complet 9Samsung Internet Android Support complet 2.0nodejs Support complet 0.12
prototypeChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 3Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
toExponentialChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
toFixedChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
toInteger
ObsolèteNon-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support 16 — 32IE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support 16 — 32Opera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Nonnodejs Aucun support Non
toLocaleStringChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
toPrecisionChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 5.5Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
toSource
Non-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Support complet 1IE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Support complet 4Opera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Nonnodejs Aucun support Non
toStringChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 3Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui
valueOfChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 4Opera Support complet OuiSafari Support complet OuiWebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet 1.0nodejs Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.

Voir aussi