BigInt.prototype.toString()

radix Optional

Ein Ganzzahlwert im Bereich von 2 bis 36, der die Basis angibt, die zur Darstellung des BigInt-Wertes verwendet werden soll. Standard ist 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 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 geben die Buchstaben des Alphabets Ziffern größer als 9 an. Zum Beispiel werden für hexadezimale Zahlen (Basis 16) die Buchstaben a bis f verwendet.

Ist der angegebene BigInt-Wert negativ, bleibt das Vorzeichen erhalten. Dies ist sogar dann der Fall, wenn die Basis 2 ist; der zurückgegebene String ist die positive Binärdarstellung des BigInt-Wertes, dem ein - Zeichen vorangestellt ist, nicht der Zweierkomplement des BigInt-Wertes.

Die toString() Methode erfordert, dass ihr this Wert ein BigInt-Prinzipal oder Wrapper-Objekt ist. Sie löst einen TypeError für andere this Werte aus, 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 zum Beispiel in einem Template Literal. BigInt primitive Werte konsultieren die toString() Methode jedoch nicht, um in Strings umgewandelt zu werden — stattdessen werden sie direkt mit dem gleichen Algorithmus wie die ursprüngliche toString() Implementierung umgewandelt.

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

Es gibt kein Negative-Zero BigInt, da es bei ganzen Zahlen kein negatives Null gibt. -0.0 ist ein IEEE-Gleitpunktkonzept, das nur im JavaScript Number Typ vorkommt.

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

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