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 г..

BigInt.asIntN — это статический метод, который позволяет перенести BigInt-значение в целое число со знаком между -2ширина-1 and 2ширина-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 по модулю 2width как целое число со знаком.

Примеры

Пребывание в 64-битных диапазонах

Метод BigInt.asIntN() может быть полезен, чтобы оставаться в диапазоне 64-битной арифметики.

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

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

BigInt.asIntN(64, max + 1n);
// ↪ -9223372036854775807n
// отрицательное число из-за переполнения

Спецификации

Specification

ECMAScript® 2027 Language Specification
# sec-bigint.asintn

Совместимость с браузерами

Enable JavaScript to view this browser compatibility table.

Смотрите также

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 28 мар. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content

Стандартные встроенные объекты
BigInt
Конструктор
1. BigInt()
Статические методы
1. BigInt.asIntN()
2. asUintN()
Методы экземпляра
Наследование
Object/Function
Статические методы
Статические свойства
Методы экземпляра
Свойства экземпляра
1. Object.prototype.__proto__
2. Object.prototype.constructor

BigInt.asIntN()

In this article

Help improve MDN