BigInt.prototype.toString()

radix Optional

Ein ganzzahliger Wert im Bereich von 2 bis 36, der die Basis angibt, die für die Darstellung des BigInt-Wertes verwendet werden soll. Standardmäßig 10.

Ein String, der den angegebenen BigInt-Wert darstellt.

RangeError

Wird ausgelöst, wenn radix kleiner als 2 oder größer als 36 ist.

Das BigInt-Objekt überschreibt die toString-Methode von Object; es erbt nicht von Object.prototype.toString(). Für BigInt-Werte gibt die toString()-Methode eine String-Darstellung des Wertes in der angegebenen Basis zurück.

Für Basen über 10 verwenden Buchstaben des Alphabets Ziffern, die größer als 9 sind. Zum Beispiel werden für hexadezimale Zahlen (Basis 16) a bis f verwendet.

Wenn der angegebene BigInt-Wert negativ ist, wird das Vorzeichen beibehalten. Dies ist auch der Fall, wenn die Basis 2 ist; der zurückgegebene String ist die positive binäre Darstellung des BigInt-Werts, der durch ein --Zeichen vorangestellt wird, nicht das Zweierkomplement des BigInt-Werts.

Die toString()-Methode erfordert, dass der this-Wert ein BigInt-Primitive oder Wrapper-Objekt ist. Sie löst einen TypeError aus, wenn andere this-Werte vorliegen, ohne zu versuchen, sie in BigInt-Werte zu konvertieren.

Da BigInt keine [Symbol.toPrimitive]()-Methode hat, ruft JavaScript die toString()-Methode automatisch auf, wenn ein BigInt-Objekt in einem Kontext verwendet wird, der einen String erwartet, wie in einem Template-Literal. BigInt-Primitive-Werte greifen jedoch nicht auf die toString()-Methode zurück, um in Strings umgewandelt zu werden — sie werden direkt mit dem gleichen Algorithmus wie die anfängliche toString()-Implementierung konvertiert.

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

Es gibt kein Negative-Null-BigInt, da es keine negativen Nullen bei ganzen Zahlen gibt. -0.0 ist ein IEEE-Gleitkomma-Konzept, das nur im JavaScript-Number-Typ erscheint.

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

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