Конструктор Number()

Конструктор Number() создаёт объекты Number. При вызове в качестве функции он возвращает примитивные значения типа Number.

Синтаксис

new Number(value)
Number(value)

Параметры

value

Числовое значение создаваемого объекта.

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

Когда Number() вызывается как функция (без new), он возвращает value, приведённое к числовому примитиву. В частности, значения BigInt конвертируются в числа вместо того, чтобы вызывать исключение. Если value отсутствует, оно становится 0.

Когда Number() вызывается как конструктор (с new), он использует описанный выше процесс приведения и возвращает обёрнутый объект Number, который не является примитивом.

Примеры

Создание объектов Number

const a = new Number("123"); // a === 123 is false
const b = Number("123"); // b === 123 is true
a instanceof Number; // is true
b instanceof Number; // is false
typeof a; // "object"
typeof b; // "number"

Использование Number() для преобразования BigInt в число

Number() — это единственный случай, когда BigInt может быть преобразован в число без вызова исключения, поскольку это очень явно задано.

+1n; // TypeError: Cannot convert a BigInt value to a number
0 + 1n; // TypeError: Cannot mix BigInt and other types, use explicit conversions

Number(1n); // 1

Обратите внимание, что это может привести к потере точности, если BigInt слишком велико, чтобы быть безопасно представленным.

BigInt(Number(2n ** 54n + 1n)) === 2n ** 54n + 1n; // false

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

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

См. также

• Полифилл современного поведения Number (с поддержкой двоичных и восьмеричных литералов) в core-js
• NaN
• Math
• BigInt