Number() Konstruktor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Der Number() Konstruktor erstellt Number Objekte. Bei Aufruf als Funktion gibt er primitive Werte des Typs Number zurück.
Syntax
new Number(value)
Number(value)
Hinweis:
Number() kann mit oder ohne new aufgerufen werden, aber mit unterschiedlichen Effekten. Siehe Rückgabewert.
Parameter
value-
Der numerische Wert des zu erstellenden Objekts.
Rückgabewert
Wenn Number() als Funktion aufgerufen wird (ohne new), gibt es value in einen Zahl-Primitive umgewandelt zurück. Insbesondere werden BigInts-Werte in Zahlen umgewandelt, anstatt einen Fehler auszulösen. Wenn value fehlt, wird es zu 0.
Wenn Number() als Konstruktor aufgerufen wird (mit new), verwendet es den oben beschriebenen Umwandlungsprozess und gibt ein umhüllendes Number Objekt zurück, das kein Primitive ist.
Warnung:
Sie sollten Number selten als Konstruktor verwenden.
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 Präzisionsverlust führen kann, wenn das BigInt zu groß ist, um sicher dargestellt zu werden.
BigInt(Number(2n ** 54n + 1n)) === 2n ** 54n + 1n; // false
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-number-constructor |