CKTIS / JavaScript
BigInt — exakte Ganzzahlen
BigInt(value) erstellt einen bigint-Primitive-Wert für exakte Ganzzahlberechnungen außerhalb des sicheren Number-Bereichs. Erfahre, wie die Konvertierung funktioniert, welche Einschränkungen für Rechenoperationen gelten und wie du mit toString(radix) Text erzeugst.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
BigInt(value)
123n
value.toString(radix)BigInt(value) gibt einen primitiven Wert vom Typ bigint zurück, der eine Ganzzahl beliebiger Präzision innerhalb der Ressourcenlimits der Implementierung darstellt. Eine Alternative ist ein Literal mit dem Suffix n, zum Beispiel 123n. Die Funktion und die Literale gehören zu ECMAScript 2020, nicht zu Web APIs. new BigInt(1) löst einen TypeError aus. Die Sprachspezifikation ist keine Browser-Kompatibilitätstabelle; Node 24 in einem Repository belegt keine Browserunterstützung.
Verwende für große Werte Text, zum Beispiel BigInt("9007199254740993"): Eine vorherige Rundung eines Number-Werts lässt sich durch die Konvertierung nicht rückgängig machen. BigInt(1.5) löst einen RangeError aus, ungültiger Ganzzahltext einen SyntaxError. Die Konvertierung von true ergibt 1n, die von false ergibt 0n.
Für Rechenoperationen müssen die Typen übereinstimmen: 1n + 1 löst einen TypeError aus, während 1n + 1n den Wert 2n ergibt. Bei der Ganzzahldivision wird der Nachkommateil in Richtung null abgeschnitten: 7n / 2n ergibt 3n. Eine Konvertierung mit Number(value) kann Präzision verlieren.
Unterscheide die Bezeichnung BigInt.toString von der Methode für Werte: Die tatsächliche API ist BigInt.prototype.toString, aufgerufen als value.toString(radix). BigInt.toString() beschreibt die Funktion selbst, statt eine Ganzzahl zu formatieren. Die Wertmethode gibt Text ohne das Suffix n zurück; die Standardbasis ist 10. Vor der Bereichsprüfung wandelt die Methode radix in eine Ganzzahl um und schneidet dabei einen etwaigen Nachkommateil in Richtung null ab. Liegt der umgewandelte Wert nicht im Bereich von 2 bis einschließlich 36, löst die Methode einen RangeError aus. Zum Beispiel verwendet (255n).toString(36.9) die Basis 36 und gibt "73" zurück.
Beispiele
const value = BigInt("9007199254740993");
const next = value + 2n;
console.log(typeof value);
console.log(next.toString());
console.log((255n).toString(16));
console.log((7n / 2n).toString());Ergebnis
bigint 9007199254740995 ff 3
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® 2020 Language Specification
- Official reference — developer.mozilla.org: BigInt / toString