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