此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

BigInt.asIntN()

基线 广泛可用

自 2020年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

BigInt.asIntN 静态方法将 BigInt 值转换为一个 -2^(width-1)2^(width-1)-1 之间的有符号整数。

尝试一下

const I64_CEIL = 2n ** 63n;

console.log(BigInt.asIntN(64, I64_CEIL - 1n));
// 9223372036854775807n (2n ** 64n - 1n, the maximum non-wrapping value)
console.log(BigInt.asIntN(64, I64_CEIL));
// -9223372036854775808n (wraps to min value)
console.log(BigInt.asIntN(64, I64_CEIL + 1n));
// -9223372036854775807n (min value + 1n)
console.log(BigInt.asIntN(64, I64_CEIL * 2n));
// 0n (wrapped around to zero)
console.log(BigInt.asIntN(64, -I64_CEIL * -42n));
// 0n (also wraps on negative multiples)

语法

BigInt.asIntN(width, bigint);

参数

width

可存储整数的位数。

bigint

要存储在指定位数上的整数。

返回值

bigint 模 (modulo) 2^width 作为有符号整数的值。

示例

保持在 64 位范围内

BigInt.asIntN() 方法对于保持在 64 位 (64-bit) 算数范围内非常有用。

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

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

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

规范

规范
ECMAScript® 2027 Language Specification
# sec-bigint.asintn

浏览器兼容性

请参阅