WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

isFinite() — Endlichkeit nach numerischer Umwandlung

Die globale Funktion isFinite(value) prüft, ob ihr Argument nach der Umwandlung eine endliche Number ergibt. Anders als Number.isFinite() akzeptiert sie durch Umwandlung auch einige Werte anderer Typen, etwa "42" und null.

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

isFinite(value)

isFinite(value) ist eine globale ECMAScript-Funktion. Sie wandelt ihr Argument zunächst mit der Operation ToNumber in eine Number um und gibt anschließend true zurück, wenn das Ergebnis endlich ist. Für NaN, Infinity und -Infinity gibt sie false zurück; beide Nullen und endliche Brüche ergeben true.

Die Umwandlung ist entscheidend: "42" wird zu 42, während "" und null zu 0 werden. Daher ergeben alle diese Argumente true. undefined und der Text "hello" werden zu NaN und ergeben false. Auch ein Aufruf von isFinite() ohne Argument ergibt false.

Dies ist keine strenge Prüfung des Zahlentyps. Um zu prüfen, ob ein Wert bereits eine endliche Zahl vom Typ Number ist, verwende Number.isFinite(value): Diese Funktion führt keine Umwandlung durch und gibt für "42", null sowie alle anderen Werte außerhalb des Typs Number false zurück. Endlichkeit bedeutet nicht, dass die Zahl eine ganze oder sichere Ganzzahl ist.

Die Umwandlung kann auch eine Ausnahme auslösen: Ein Argument vom Typ Symbol oder BigInt verursacht einen TypeError, statt false zurückzugeben. Bei Objekten kann die Umwandlung eigenen Code ausführen und eine ausgelöste Ausnahme weitergeben. Das Beispiel vergleicht beide Prüfungen, ohne Objekte oder Werte zu verwenden, die eine Ausnahme auslösen.

Beispiele

const values = [42, "42", "", null, NaN, Infinity, undefined];
for (const value of values) {
  console.log(`${isFinite(value)} | ${Number.isFinite(value)}`);
}

Ergebnis

true | true
true | false
true | false
true | false
false | false
false | false
false | false

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