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.

Rckgabewert

Ein BigInt-Wert. Zahlenwerte mssen ganze Zahlen sein und werden in BigInts umgewandelt. Der Boolean-Wert true wird zu 1n, und false wird zu 0n. Strings werden geparst, als wren sie Quelltext fr Ganzzahlliterale, was bedeutet, dass sie fhrende und nachfolgende Leerzeichen aufweisen knnen und mit 0b, 0o oder 0x vorangestellt sein knnen.

Ausnahmen

RangeError

Ausgelst, wenn der Parameter eine nicht-ganzzahlige Zahl ist.

TypeError

Ausgelst in einem der folgenden Flle:

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

SyntaxError

Ausgelst, 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-Kompatibilitt

Siehe auch

• BigInt