BigInt.asIntN()

The BigInt.asIntN static method is used to wrap a BigInt value to a signed integer between -2width-1 and 2width-1-1.

Syntax

BigInt.asIntN(width, bigint);

Parameters

width
The amount of bits available for the integer size.
bigint
The integer to clamp to fit into the supplied bits.

Returns

The value of bigint modulo 2width 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);
// ↪ -9223372036854775807n
// negative because of overflow

Specifications

Specification
ECMAScript (ECMA-262)
The definition of 'BigInt.asIntN()' in that specification.

Browser compatibility

DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
asIntNChrome Full support 67Edge Full support 79Firefox Full support 68IE No support NoOpera Full support 54Safari No support NoWebView Android Full support 67Chrome Android Full support 67Firefox Android Full support 68Opera Android Full support 48Safari iOS No support NoSamsung Internet Android Full support 9.0nodejs Full support 10.4.0

Legend

Full support
Full support
No support
No support

See also