Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

isFinite()

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.

Die Funktion isFinite() bestimmt, ob ein Wert endlich ist. Falls nötig, wandelt sie den Wert zuvor in eine Zahl um. Eine endliche Zahl ist weder NaN noch ±Infinity. Da die Typumwandlung innerhalb der Funktion isFinite() überraschend sein kann, sollten Sie gegebenenfalls Number.isFinite() verwenden.

Probieren Sie es aus

function div(x) {
  if (isFinite(1000 / x)) {
    return "Number is NOT Infinity.";
  }
  return "Number is Infinity!";
}

console.log(div(0));
// Expected output: "Number is Infinity!"

console.log(div(1));
// Expected output: "Number is NOT Infinity."

Syntax

js
isFinite(value)

Parameter

value

Der zu prüfende Wert.

Rückgabewert

true, außer wenn der angegebene Wert nach der Umwandlung in eine Zahl entweder Infinity, -Infinity oder NaN ist.

Beschreibung

isFinite() ist eine Funktionseigenschaft des globalen Objekts.

Wenn das Argument der Funktion isFinite() nicht vom Typ Number ist, wird der Wert zunächst in eine Zahl umgewandelt. Anschließend wird das Ergebnis mit NaN und ±Infinity verglichen. Das ist ebenso verwirrend wie das Verhalten von isNaN – beispielsweise ist isFinite("1") gleich true.

Number.isFinite() ist eine zuverlässigere Möglichkeit, zu prüfen, ob ein Wert eine endliche Zahl ist, da die Methode für jeden Wert, der keine Zahl ist, false zurückgibt.

Beispiele

isFinite() verwenden

js
isFinite(Infinity); // false
isFinite(NaN); // false
isFinite(-Infinity); // false

isFinite(0); // true
isFinite(2e64); // true
isFinite(910); // true

// Following would've been false with the more robust Number.isFinite():

isFinite(null); // true, because null is converted to 0
isFinite(""); // true, because empty string is converted to 0
isFinite("123"); // true, because string can be parsed as a number

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-isfinite-number

Browser-Kompatibilität

Siehe auch