CKTIS / JavaScript
Number — convertir des valeurs en nombres
Number(value) convertit une valeur en nombre primitif. Découvrez la différence entre cette conversion et l’objet enveloppe new Number(value), ainsi que la façon dont Number.prototype.toString convertit un nombre en texte.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Number(value)
Number()
new Number(value)
number.toString(radix)Number(value) renvoie une valeur primitive de type number ; Number() renvoie 0. En revanche, new Number(value) crée un objet enveloppe : son typeof est "object", et non "number". Pour les calculs et conversions ordinaires, utilisez l’appel sans new.
La conversion d’une chaîne prend en compte toute sa représentation après suppression des espaces au début et à la fin : Number("255px") produit NaN, tandis que Number("") produit 0. Number(null) produit 0, Number(undefined) produit NaN, et les booléens deviennent 1 ou 0. La conversion d’un Symbol déclenche une TypeError. Number peut convertir explicitement un BigInt, mais le résultat peut perdre en précision.
Le type number utilise le format binaire IEEE 754 à double précision : de nombreuses fractions décimales sont approximatives. L’intervalle des entiers sûrs va de -(2 ** 53 - 1) à 2 ** 53 - 1 ; au-delà, tous les entiers ne sont pas représentés exactement.
Number.prototype.toString fonctionne dans le sens inverse : value.toString(radix) renvoie du texte. La base par défaut est 10 ; utilisez une base entière de 2 à 36, par exemple 16 pour l’hexadécimal. Une base hors limites après conversion déclenche une RangeError. La méthode exige qu’un nombre ou un objet Number soit son this ; tout autre récepteur provoque une TypeError.
Exemples
const value = Number(" 255 ");
console.log(typeof value);
console.log(value);
console.log(value.toString(16));
console.log(Number(""));
console.log(Number.isNaN(Number("255px")));Résultat
number 255 ff 0 true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — The Number Constructor
- ECMAScript® Language Specification — Number.prototype.toString
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- Official reference — developer.mozilla.org: Number / toString