Get to know MDN better
Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2020.
La méthode toString() des valeurs BigInt retourne une chaîne de caractères représentant la valeur BigInt définie. Le « n » final ne fait pas partie de la chaîne de caractères.
Un entier compris entre 2 et 36 spécifiant la base à utiliser pour représenter la valeur BigInt. La valeur par défaut est 10.
Une chaîne de caractères représentant l'objet BigInt courant.
Levée si radix est inférieur à 2 ou supérieur à 36.
L'objet BigInt surcharge la méthode toString de Object ; il n'hérite pas de Object.prototype.toString(). Pour les valeurs BigInt, la méthode toString() 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 de a à f sont utilisées.
Si la valeur BigInt 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 valeur BigInt précédée d'un signe -, et non le complément à deux de la valeur BigInt.
La méthode toString() exige que sa valeur this soit un primitif ou un objet enveloppe BigInt. Elle lève une exception TypeError pour d'autres valeurs de this sans tenter de les convertir en valeurs BigInt.
Parce que BigInt ne possède pas de méthode [Symbol.toPrimitive](), JavaScript appelle automatiquement la méthode toString() lorsqu'un objet BigInt est utilisé dans un contexte où une chaîne de caractères est attendue, comme dans un littéral de gabarit. Cependant, les valeurs primitives BigInt ne consultent pas la méthode toString() pour être converties en chaînes de caractères — elles sont directement converties en utilisant le même algorithme que l'implémentation initiale de toString().
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.
| ECMAScript® 2027 Language Specification # sec-bigint.prototype.tostring |
Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.
Cette page a été modifiée le 14 déc. 2025 par les contributeur·ice·s du MDN.
Votre modèle pour un internet meilleur.
Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.