Number.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode toString() renvoie une chaîne de caractère représentant l'objet Number.

Exemple interactif

function hexColour(c) {
  if (c < 256) {
    return Math.abs(c).toString(16);
  }
  return 0;
}

console.log(hexColour(233));
// Expected output: "e9"

console.log(hexColour("11"));
// Expected output: "b"

Syntaxe

js
numObj.toString([base]);

Paramètre

base

Paramètre optionnel. Un entier compris entre 2 et 36 qui indique la base du système numérique à utiliser pour représenter la valeur.

Valeur de retour

Une chaîne de caractères représentant l'objet Number.

Exception

RangeError

Si toString() reçoit une base qui n'est pas comprise entre 2 et 36, une exception RangeError est levée.

Description

L'objet Number surcharge la méthode toString() de Object et n'hérite donc pas de Object.prototype.toString(). Pour les objets Number, la méthode toString() renvoie une représentation du nombre, dans une base donnée, en une chaîne de caractères.

La méthode toString() analyse son premier argument et tente de renvoyer une chaîne de caractères représentant le nombre en une base donnée. Pour les bases supérieures à 10, les lettres de l'alphabet sont utilisées pour représenter les numéraux supérieurs à 9. Par exemple, pour les nombres hexadécimaux (en base 16), les lettres a à f sont utilisées.

Si la base n'est pas spécifiée, on utilisera la base 10 par défaut.

Si l'objet Number est négatif, le signe sera conservé. Ceci, même si la base utilisée est la base 2 : la chaîne de caractères rendue sera la représentation binaire du nombre positif précédée par un signe -. La représentation n'est pas le complément à deux du nombre.

Si l'objet Number n'est pas un nombre entier, le point (.) sera utilisé pour séparer la partie entière et décimale.

Exemples

Utiliser toString

js
var compte = 10;

console.log(compte.toString()); // affiche "10"
console.log((17).toString()); // affiche "17"
console.log((17.2).toString()); // affiche "17.2"

var x = 6;

console.log(x.toString(2)); // affiche "110"
console.log((254).toString(16)); // affiche "fe"

console.log((-10).toString(2)); // affiche "-1010"
console.log((-0xff).toString(2)); // affiche "-11111111"

Spécifications

Specification
ECMAScript® 2025 Language Specification
# sec-number.prototype.tostring

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi