WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.isFinite: endliche Number ohne Koercion

Number.isFinite liefert nur dann true, wenn das Argument eine Number und weder NaN noch positive oder negative Unendlichkeit ist.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

Number.isFinite(number)

Number.isFinite(value) prüft zuerst den Typ des Arguments. Für jede endliche Number, einschließlich +0, -0, subnormaler Zahlen und Number.MAX_VALUE, liefert es true; für NaN, Infinity und -Infinity liefert es false. Ein fehlendes Argument ist undefined und ergibt ebenfalls false.

Die Methode wendet ToNumber nicht an. Zeichenketten, boolesche Werte, null, BigInt, Symbol, normale Objekte und Wrapper aus new Number(...) ergeben false; ihre Konvertierungshooks werden nicht aufgerufen. Das unterscheidet sie vom globalen isFinite, das konvertiert: isFinite("21.25") ist etwa true, Number.isFinite("21.25") dagegen false; die globale Form kann bei der Konvertierung auch werfen.

Die Methode existiert seit ECMAScript 2015 und ist kein Konstruktor. Das Beispiel nutzt sie an einer Temperatur-Validierungsgrenze, damit toFixed nur für eine echte endliche Number aufgerufen wird. Soll numerischer Text erlaubt sein, parse ihn ausdrücklich und prüfe danach das Ergebnis mit Number.isFinite.

Beispiele

function formatTemperature(value) {
  return Number.isFinite(value) ? `${value.toFixed(1)} C` : "invalid";
}

console.log([21.25, "21.25", NaN, Infinity].map(formatTemperature).join(" | "));
console.log(Number.isFinite(0), Number.isFinite(-0), Number.isFinite(Number.MAX_VALUE));
console.log(Number.isFinite(1n), Number.isFinite(Symbol("x")));
console.log(isFinite("21.25"), Number.isFinite("21.25"));

Ergebnis

21.3 C | invalid | invalid | invalid
true true true
false false
true false

Number.isFinite → strikte Temperaturvalidierung ohne Koercion

Quellen