La méthode toString()
renvoie une chaîne de caractère représentant l'objet Number.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Syntaxe
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 exceptionRangeError
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
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
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée par JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) La définition de 'Number.prototype.tostring' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Number.prototype.tostring' dans cette spécification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) La définition de 'Number.prototype.tostring' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.
Ordinateur | Mobile | Serveur | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toString | Chrome Support complet 1 | Edge Support complet 12 | Firefox Support complet 1 | IE Support complet 3 | Opera Support complet Oui | Safari Support complet Oui | WebView Android Support complet 1 | Chrome Android Support complet 18 | Firefox Android Support complet 4 | Opera Android Support complet Oui | Safari iOS Support complet Oui | Samsung Internet Android Support complet 1.0 | nodejs Support complet Oui |
Légende
- Support complet
- Support complet