BigInt.prototype.toString()

radix Optional

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

Eine Zeichenkette, die den angegebenen BigInt-Wert repräsentiert.

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 Object.prototype.toString(). Für BigInt-Werte gibt die toString()-Methode eine Zeichenkettenrepräsentation des Wertes in der angegebenen Basis zurück.

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

Wenn der angegebene BigInt-Wert negativ ist, bleibt das Vorzeichen erhalten. Dies ist auch dann der Fall, wenn die Basis 2 ist; die zurückgegebene Zeichenkette ist die positive binäre Darstellung des BigInt-Wertes, vorangestellt von einem --Zeichen, nicht das Zweierkomplement des BigInt-Wertes.

Die toString()-Methode erfordert, dass ihr this-Wert ein BigInt-Primitive oder Wrapper-Objekt ist. Sie löst einen TypeError aus für andere this-Werte, ohne zu versuchen, diese in BigInt-Werte umzuwandeln.

Da BigInt keine [Symbol.toPrimitive]()-Methode hat, ruft JavaScript die toString()-Methode automatisch auf, wenn ein BigInt-Objekt in einem Kontext verwendet wird, der eine Zeichenkette erwartet, wie in einem Template-Literal. BigInt-Primitive-Werte hingegen konsultieren nicht die toString()-Methode, um in Zeichenketten umgewandelt zu werden — sie werden direkt mit demselben Algorithmus wie die ursprüngliche toString()-Implementierung konvertiert.

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

Es gibt kein negativ-null BigInt, da es keine negativen Nullen in Ganzzahlen gibt. -0.0 ist ein IEEE-Gleitkomma-Konzept, das nur im JavaScript Number-Typ vorkommt.

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

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