Number() Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der Number() Konstruktor erstellt Number Objekte. Bei Aufruf als Funktion gibt er primitive Werte des Typs Number zurück.

In diesem Artikel

Syntax

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

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

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

js
+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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Number
Konstruktor
1. Number()
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor

Number() Konstruktor

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beispiele

Number-Objekte erstellen

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN