BigInt() Konstruktor

Syntax

BigInt(value)

Parameter

value

Der Wert, der in einen BigInt-Wert umgewandelt werden soll. Es kann ein String, eine ganze Zahl, ein Boolean oder ein anderes BigInt sein.

Rückgabewert

Ein BigInt-Wert. Zahlenwerte müssen ganze Zahlen sein und werden in BigInts umgewandelt. Der Boolean-Wert true wird zu 1n, und false wird zu 0n. Strings werden geparst, als wären sie Quelltext für Ganzzahlliterale, was bedeutet, dass sie führende und nachfolgende Leerzeichen aufweisen können und mit 0b, 0o oder 0x vorangestellt sein können.

Ausnahmen

RangeError

Ausgelöst, wenn der Parameter eine nicht-ganzzahlige Zahl ist.

TypeError

Ausgelöst in einem der folgenden Fälle:

• Der Parameter kann nicht in einen primitiven Wert umgewandelt werden.
• Nach der Umwandlung in einen primitiven Wert ist das Ergebnis undefined, null, symbol.

SyntaxError

Ausgelöst, wenn der Parameter ein String ist, der nicht als BigInt geparst werden kann.

Beispiele

Verwendung von BigInt(), um eine Zahl in ein BigInt umzuwandeln

BigInt() ist der einzige Fall, bei dem eine Zahl ohne Fehler in ein BigInt umgewandelt werden kann, 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

Browser-Kompatibilität

Siehe auch

• BigInt