BigInt.prototype.toString()

baseFacultatif

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

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

RangeError

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

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).

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'

• BigInt.prototype.toLocaleString()
• BigInt.prototype.valueOf()
• Number.prototype.toString()