Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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