WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number – Werte in Zahlen umwandeln

Number(value) wandelt einen Wert in eine primitive Zahl um. Erfahre den Unterschied zwischen dieser Umwandlung und dem Wrapper-Objekt new Number(value) sowie wie Number.prototype.toString eine Zahl in Text umwandelt.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Number(value)
Number()
new Number(value)
number.toString(radix)

Number(value) gibt einen primitiven Wert vom Typ number zurück; Number() gibt 0 zurück. Dagegen erstellt new Number(value) ein Wrapper-Objekt: Sein typeof ist "object", nicht "number". Verwende für gewöhnliche Berechnungen und Umwandlungen den Aufruf ohne new.

Bei der Umwandlung von Zeichenfolgen wird nach dem Entfernen führender und nachfolgender Leerzeichen die gesamte Darstellung berücksichtigt: Number("255px") ergibt NaN, während Number("") den Wert 0 ergibt. Number(null) ergibt 0, Number(undefined) ergibt NaN, und boolesche Werte werden zu 1 oder 0. Die Umwandlung eines Symbol löst einen TypeError aus. Number kann einen BigInt ausdrücklich umwandeln, dabei kann das Ergebnis jedoch an Genauigkeit verlieren.

Der Typ number verwendet das binäre IEEE-754-Format mit doppelter Genauigkeit: Viele Dezimalbrüche sind Näherungswerte. Der sichere Ganzzahlbereich reicht von -(2 ** 53 - 1) bis 2 ** 53 - 1; außerhalb dieses Bereichs wird nicht jede Ganzzahl exakt dargestellt.

Number.prototype.toString funktioniert in die entgegengesetzte Richtung: value.toString(radix) gibt Text zurück. Die Standardbasis ist 10; verwende eine ganzzahlige Basis von 2 bis 36, etwa 16 für Hexadezimalzahlen. Eine Basis außerhalb dieses Bereichs löst nach der Umwandlung einen RangeError aus. Die Methode erfordert als this eine Zahl oder ein Number-Objekt; ein anderer Empfänger führt zu einem TypeError.

Beispiele

const value = Number(" 255 ");
console.log(typeof value);
console.log(value);
console.log(value.toString(16));
console.log(Number(""));
console.log(Number.isNaN(Number("255px")));

Ergebnis

number
255
ff
0
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen