BigInt()-Konstruktor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Die BigInt()-Funktion liefert primitive Werte vom Typ BigInt zurück.
Syntax
Parameter
value-
Der Wert, der in einen BigInt-Wert umgewandelt werden soll. Es kann sich um einen String, eine ganze Zahl, einen booleschen Wert oder einen anderen
BigInthandeln.
Rückgabewert
Ein BigInt-Wert. Numerische Werte müssen Ganzzahlen sein und werden in BigInts umgewandelt. Der boolesche Wert true wird zu 1n, und false wird zu 0n. Zeichenfolgen werden geparst, als ob sie Quelltext für ganzzahlige Literale sind, was bedeutet, dass sie führende und nachfolgende Leerzeichen haben können und mit 0b, 0o oder 0x versehen sein können.
Ausnahmen
RangeError-
Wird ausgelöst, wenn der Parameter eine nicht-ganzzahlige Zahl ist.
TypeError-
Wird in einem der folgenden Fälle ausgelöst:
SyntaxError-
Wird ausgelöst, wenn der Parameter ein String ist, der nicht als
BigIntgeparst werden kann.
Beispiele
Verwendung von BigInt() zur Umwandlung einer Zahl in einen BigInt
BigInt() ist der einzige Fall, in dem eine Zahl in einen BigInt umgewandelt werden kann, ohne einen Fehler auszulösen, da es sehr explizit ist. Es sind jedoch nur ganze Zahlen erlaubt.
BigInt(123); // 123n
BigInt(123.3); // RangeError: The number 123.3 cannot be converted to a BigInt because it is not an integer
Verwendung von String-Werten
BigInt("123"); // 123n
BigInt("0b10101"); // 21n, which is 10101 in binary
BigInt("0o123"); // 83n, which is 123 in octal
BigInt("0x123"); // 291n, which is 123 in hexadecimal
BigInt(" 123 "); // 123n, leading and trailing whitespaces are allowed
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-bigint-constructor |