Baseline Widely available
The BigInt()
function returns primitive values of type BigInt.
Note: BigInt()
can only be called without new
. Attempting to construct it with new
throws a TypeError
.
value
The value to be converted to a BigInt value. It may be a string, an integer, a boolean, or another BigInt
.
A BigInt
value. Number values must be integers and are converted to BigInts. The boolean value true
becomes 1n
, and false
becomes 0n
. Strings are parsed as if they are source text for integer literals, which means they can have leading and trailing whitespaces and can be prefixed with 0b
, 0o
, or 0x
.
RangeError
Thrown if the parameter is a non-integral number.
TypeError
Thrown in one of the following cases:
SyntaxError
Thrown if the parameter is a string that cannot be parsed as a BigInt
.
BigInt()
is the only case where a number can be converted to a BigInt without throwing, because it's very explicit. However, only integers are allowed.
BigInt(123); // 123n
BigInt(123.3); // RangeError: The number 123.3 cannot be converted to a BigInt because it is not an integer
Using string values
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
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4