Number() Konstruktor

Syntax

new Number(value)
Number(value)

Parameter

value

Der numerische Wert des zu erstellenden Objekts.

Rckgabewert

Wenn Number() als Funktion aufgerufen wird (ohne new), gibt es value in einen Zahl-Primitive umgewandelt zurck. Insbesondere werden BigInts-Werte in Zahlen umgewandelt, anstatt einen Fehler auszulsen. Wenn value fehlt, wird es zu 0.

Wenn Number() als Konstruktor aufgerufen wird (mit new), verwendet es den oben beschriebenen Umwandlungsprozess und gibt ein umhllendes Number Objekt zurck, das kein Primitive ist.

Beispiele

Number-Objekte erstellen

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"

Verwendung von Number(), um ein BigInt in eine Zahl zu konvertieren

Number() ist der einzige Fall, bei dem ein BigInt ohne Fehler in eine Zahl konvertiert werden kann, da es sehr explizit ist.

+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

Beachten Sie, dass dies zu einem Przisionsverlust fhren kann, wenn das BigInt zu gro ist, um sicher dargestellt zu werden.

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Polyfill des modernen Number-Verhaltens (mit Untersttzung fr binre und oktale Literale) in core-js
• NaN
• Math
• BigInt