DieBigInt()-Funktion liefert primitive Werte vom Typ BigInt zurück.

Syntax

BigInt(value)

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 anderenBigInt handeln.

Rückgabewert

EinBigInt-Wert. Numerische Werte müssen Ganzzahlen sein und werden in BigInts umgewandelt. Der boolesche Werttrue wird zu1n, undfalse wird zu0n. 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 mit0b,0o oder0x 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:

• Der Parameter kann nicht in einen primitiven Wert konvertiert werden.
• Nach der Konvertierung in einen primitiven Wert ist das Ergebnisundefined,null,symbol.

SyntaxError

Wird ausgelöst, wenn der Parameter ein String ist, der nicht alsBigInt geparst 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); // 123nBigInt(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"); // 123nBigInt("0b10101"); // 21n, which is 10101 in binaryBigInt("0o123"); // 83n, which is 123 in octalBigInt("0x123"); // 291n, which is 123 in hexadecimalBigInt("  123  "); // 123n, leading and trailing whitespaces are allowed

Spezifikationen

Browser-Kompatibilität

Siehe auch

• BigInt