BigInt.asIntN()

The BigInt.asIntN static method clamps a BigInt value to a signed integer value, and returns that value.

Syntax

BigInt.asIntN(bits, bigint);

Parameters

bits

The amount of bits available for the integer size.

bigint

The BigInt value to clamp to fit into the supplied bits.

Returns

The value of bigint modulo 2^bits, as a signed integer.

Examples

Staying in 64-bit ranges

The BigInt.asIntN() method can be useful to stay in the range of 64-bit arithmetic.

const max = 2n ** (64n - 1n) - 1n;

BigInt.asIntN(64, max);
// ↪ 9223372036854775807n

BigInt.asIntN(64, max + 1n);
// ↪ -9223372036854775808n
// negative because of overflow

Specifications

Specification
ECMAScript Language Specification
# sec-bigint.asintn

Browser compatibility

BCD tables only load in the browser

See also