isFinite()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die isFinite() Funktion bestimmt, ob ein Wert endlich ist, wobei der Wert bei Bedarf zuerst in eine Zahl umgewandelt wird. Eine endliche Zahl ist eine Zahl, die weder NaN noch ±Infinity ist. Da die Zwangsumwandlung innerhalb der isFinite() Funktion überraschend sein kann, bevorzugen Sie möglicherweise die Verwendung von Number.isFinite().

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 testende Wert.

Rückgabewert

false, wenn der gegebene Wert nach der Umwandlung in eine Zahl NaN, Infinity oder -Infinity ist; andernfalls true.

Beschreibung

isFinite() ist eine Funktionseigenschaft des globalen Objekts.

Wenn das Argument der isFinite() Funktion nicht vom Typ Number ist, wird der Wert zuerst in eine Zahl umgewandelt und der resultierende Wert dann mit NaN und ±Infinity verglichen. Dies ist ebenso verwirrend wie das Verhalten von isNaN — zum Beispiel ist isFinite("1") true.

Number.isFinite() ist eine verlässlichere Methode, um zu testen, ob ein Wert ein endlicher Zahlenwert ist, da es für jeden nicht numerischen Eingang false zurückgibt.

Beispiele

Verwendung von isFinite()

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

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

// Would've been false with the more robust Number.isFinite():
isFinite(null); // true
isFinite("0"); // true

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-isfinite-number

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch