BigInt.prototype.toString()

radix Optional

Eine Ganzzahl im Bereich von 2 bis 36, die die Basis für die Darstellung des BigInt-Wertes angibt. Standardmäßig wird Basis 10 verwendet.

Eine Zeichenkette, die 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 Methode toString() eine Zeichenkettenrepräsentation des Wertes in der angegebenen Basis zurück.

Für Basen (radix) größer als 10 zeigen die Buchstaben des Alphabets Ziffern größer als 9 an. Beispielsweise werden für hexadezimale Zahlen (Basis 16) die Buchstaben 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 (binär) ist; die zurückgegebene Zeichenkette ist die positive binäre Darstellung des BigInt-Wertes, vorangestellt von einem --Zeichen, nicht die Zweierkomplement-Darstellung des BigInt-Wertes.

Die toString()-Methode erfordert, dass ihr this-Wert ein BigInt-Primitive oder Wrapper-Objekt ist. Sie löst einen TypeError aus, wenn andere this-Werte verwendet werden, ohne zu versuchen, sie 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 etwa in einem Template-Literal. BigInt-Primitive-Werte konsultieren jedoch nicht die toString()-Methode, um in Zeichenketten umgewandelt zu werden — stattdessen werden sie direkt mithilfe des gleichen Algorithmus wie bei der anfänglichen toString()-Implementierung konvertiert.

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

Es gibt keine negative Null bei BigInt, da es keine negativen Nullen in Ganzzahlen gibt. -0.0 ist ein Konzept des IEEE-Gleitkommaformats, das nur im JavaScript-Number-Typ vorkommt.

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

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