BigInt.prototype.toString()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2020 browserübergreifend verfügbar.

Die toString()-Methode von BigInt-Werten gibt eine Zeichenkette zurück, die den angegebenen BigInt-Wert repräsentiert. Das abschließende "n" ist nicht Teil der Zeichenkette.

In diesem Artikel

Probieren Sie es aus

console.log(1024n.toString());
// Expected output: "1024"

console.log(1024n.toString(2));
// Expected output: "10000000000"

console.log(1024n.toString(16));
// Expected output: "400"

Syntax

js
toString()
toString(radix)

Parameter

radix Optional

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

Rückgabewert

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

Ausnahmen

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 Zeichenkettendarstellung des Wertes in der angegebenen Basis zurück.

Für Basen über 10 zeigen die Buchstaben des Alphabets Ziffern größer als 9 an. 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 gilt auch, wenn die Basis 2 ist; die zurückgegebene Zeichenkette ist die positive binäre Darstellung des BigInt-Wertes, der von einem --Zeichen vorangestellt ist, nicht das Zweierkomplement des BigInt-Wertes.

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

Da BigInt keine [Symbol.toPrimitive]()-Methode besitzt, ruft JavaScript die toString()-Methode automatisch auf, wenn ein BigInt-Objekt in einem Kontext verwendet wird, der eine Zeichenkette erwartet, wie zum Beispiel in einem Template Literal. BigInt primitive Werte konsultieren jedoch die toString()-Methode nicht, um zu Zeichenketten konvertiert zu werden — sie werden vielmehr direkt unter Verwendung desselben Algorithmus wie die anfängliche toString()-Implementierung konvertiert.

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

Beispiele

Verwendung von toString()

js
17n.toString(); // "17"
66n.toString(2); // "1000010"
254n.toString(16); // "fe"
(-10n).toString(2); // "-1010"
(-0xffn).toString(2); // "-11111111"

Negative-Null-BigInt

Es gibt keine negative Null BigInt, da es in ganzen Zahlen keine negativen Nullen gibt. -0.0 ist ein IEEE-Gleitkomma-Konzept, das nur im JavaScript-Number-Typ auftritt.

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
BigInt
Konstruktor
1. BigInt()
Statische Methoden
1. asIntN()
2. asUintN()
Instanzmethoden
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor