BigInt.prototype.toString()

The toString() method returns a string representing the specified BigInt object. The trailing "n" is not part of the string.

Syntaxe

bigIntObj.toString([base])

Paramètres

baseFacultatif
Ce paramètre optionnel est compris entre 2 et 36 et indique la base à utiliser pour représenter les valeurs numériques.

Valeur de retour

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

Exceptions

RangeError
Si la base fournie comme argument toString() est inférieure à 2 ou supérieure à 36, cela déclenchera une exception RangeError.

Description

L'objet BigInt surcharge la méthode toString() de Object. Il n'hérite pas ou n'utilise pas Object.prototype.toString(). Pour les objets BigInt, la méthode toString() renvoie une représentation textuelle de l'objet dans la base indiquée.

La méthode toString() analyse le premier argument qui lui est passé et tente de renvoyer une représentation textuelle dans cette base. Pour les bases supérieures à 10, ce seront les lettres de l'alphabet pour indiquer les chiffres supérieurs à 9. Pour les nombres hexadécimaux (base 16), les lettres a à f sont utilisées par exemple.

Si l'argument base n'est pas indiquée, ce sera la base 10 qui sera considérée par défaut.

Si bigIntObj est négatif, le signe est conservé, y compris lorsque la base est 2 (dans ce cas, la chaîne renvoyée sera la représentation binaire précédée par un signe - et non le complément à deux de bigIntObj).

Exemples

Utiliser toString()

17n.toString();      // '17'
66n.toString(2);     // '1000010'
254n.toString(16);   // 'fe'
-10n.toString(2);    // -1010'
-0xffn.toString(2);  // '-11111111'

Gestion du zéro négatif en BigInt

Il n'existe pas de zéro négatif pour BigInt car les entiers ne gèrent pas de concept de zéro négatif. -0.0 est un concept relatif à la représentation flottante IEEE et n'est présent que pour le type Number.

(-0n).toString();      // '0' 
BigInt(-0).toString(); // '0'

Spécifications

Spécification État
Proposition pour BigInt Proposition de niveau 3

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
toStringChrome Support complet 67Edge Aucun support NonFirefox Support complet 68IE Aucun support NonOpera Support complet 54Safari Aucun support NonWebView Android Support complet 67Chrome Android Support complet 67Firefox Android Support complet 68Opera Android Support complet 48Safari iOS Aucun support NonSamsung Internet Android Aucun support Nonnodejs Support complet 10.4.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Voir aussi