La méthodetoString() des valeursBigInt retourne une chaîne de caractères représentant la valeurBigInt définie. Le « n » final ne fait pas partie de la chaîne de caractères.

Exemple interactif

console.log(1024n.toString());// Sortie attendue : "1024"console.log(1024n.toString(2));// Sortie attendue : "10000000000"console.log(1024n.toString(16));// Sortie attendue : "400"

Syntaxe

toString()toString(radix)

Paramètres

radixFacultatif

Un entier compris entre 2 et 36 spécifiant la base à utiliser pour représenter la valeurBigInt. La valeur par défaut est 10.

Valeur de retour

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

Exceptions

RangeError

Levée siradix est inférieur à 2 ou supérieur à 36.

Description

L'objetBigInt surcharge la méthodetoString deObject ; il n'hérite pas deObject.prototype.toString(). Pour les valeursBigInt, la méthodetoString() retourne une représentation textuelle de la valeur dans la base indiquée.

Pour les bases supérieures à 10, les lettres de l'alphabet indiquent les chiffres supérieurs à 9. Par exemple, pour les nombres hexadécimaux (base 16), les lettres dea àf sont utilisées.

Si la valeurBigInt spécifiée est négative, le signe est conservé. C'est le cas même si la base est 2 ; la chaîne de caractères retournée est la représentation binaire positive de la valeurBigInt précédée d'un signe-,et non le complément à deux de la valeurBigInt.

La méthodetoString() exige que sa valeurthis soit un primitif ou un objet enveloppeBigInt. Elle lève une exceptionTypeError pour d'autres valeurs dethis sans tenter de les convertir en valeursBigInt.

Parce queBigInt ne possède pas de méthode[Symbol.toPrimitive](), JavaScript appelle automatiquement la méthodetoString() lorsqu'unobjetBigInt est utilisé dans un contexte où une chaîne de caractères est attendue, comme dans unlittéral de gabarit. Cependant, les valeursprimitivesBigInt ne consultent pas la méthodetoString() pour êtreconverties en chaînes de caractères — elles sont directement converties en utilisant le même algorithme que l'implémentation initiale detoString().

BigInt.prototype.toString = () => "Surchargé";console.log(`${1n}`); // "1"console.log(`${Object(1n)}`); // "Surchargé"

Exemples

UtilisertoString()

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 enBigInt

Il n'existe pas de zéro négatif pourBigInt 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 typeNumber.

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

Spécifications

Compatibilité des navigateurs

Voir aussi

• La méthodeBigInt.prototype.toLocaleString()
• La méthodeBigInt.prototype.valueOf()
• La méthodeNumber.prototype.toString()