BigInt.asIntN()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2020年9月.
BigInt.asIntN は静的メソッドで、 BigInt 値を符号付き整数値に丸め、その値を返します。
試してみましょう
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)
構文
js
BigInt.asIntN(bits, bigint);
引数
返値
bigint を 2^bits で割った剰余の値の符号付き整数です。
例
64 ビットの範囲に収める
BigInt.asIntN() メソッドは、 64 ビットの数値の範囲に収めるのに便利です。
js
const max = 2n ** (64n - 1n) - 1n;
BigInt.asIntN(64, max);
// ↪ 9223372036854775807n
BigInt.asIntN(64, max + 1n);
// ↪ -9223372036854775808n
// オーバーフローするので負数になる
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-bigint.asintn |
ブラウザーの互換性
Loading…