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

View in English Always switch to English

BigInt.asUintN()

基线 广泛可用

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

BigInt.asUintN 静态方法将 BigInt 转换为一个 0 和 2^width-1 之间的无符号整数。

尝试一下

const U64_CEIL = 2n ** 64n;

console.log(BigInt.asUintN(64, U64_CEIL - 1n));
// 18446744073709551615n (2n ** 64n - 1n, the maximum non-wrapping value)
console.log(BigInt.asUintN(64, U64_CEIL));
// 0n (wraps to zero)
console.log(BigInt.asUintN(64, U64_CEIL + 1n));
// 1n
console.log(BigInt.asUintN(64, U64_CEIL * 2n));
// 0n (wraps on multiples)
console.log(BigInt.asUintN(64, U64_CEIL * -42n));
// 0n (also wraps on negative multiples)

语法

BigInt.asUintN(width, bigint);

参数

width

可存储整数的位数。

bigint

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

返回值

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

示例

保持在 64 位范围内

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

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

BigInt.asUintN(64, max);
// ↪ 18446744073709551615n

BigInt.asUintN(64, max + 1n);
// ↪ 0n
// zero because of overflow

规范

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

浏览器兼容性

请参阅