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 September 2020.

BigInt.asIntN — это статический метод, который позволяет перенести BigInt-значение в целое число со знаком между -2ширина-1 and 2ширина-1-1.

Синтаксис

BigInt.asIntN(width, bigint);

Аргументы

width: Количество битов, доступных для целочисленного размера.
bigint: Целое число для зажима, чтобы соответствовать поставляемым битам.

Возвращаемое значение

Значение bigint по модулю 2width как целое число со знаком.

Примеры

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

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

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

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

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

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

Specification
ECMAScript® 2025 Language Specification # sec-bigint.asintn