Number.isInteger()

Baseline Widely available

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

Die statische Methode Number.isInteger() bestimmt, ob der übergebene Wert eine ganze Zahl ist.

Probieren Sie es aus

function fits(x, y) {
  if (Number.isInteger(y / x)) {
    return "Fits!";
  }
  return "Does NOT fit!";
}

console.log(fits(5, 10));
// Expected output: "Fits!"

console.log(fits(5, 11));
// Expected output: "Does NOT fit!"

Syntax

Number.isInteger(value)

Parameter

value: Der Wert, der getestet werden soll, ob er eine ganze Zahl ist.

Rückgabewert

Der boolesche Wert true, wenn der gegebene Wert eine ganze Zahl ist. Ansonsten false.

Wenn der Zielwert eine ganze Zahl ist, wird true zurückgegeben, ansonsten wird false zurückgegeben. Wenn der Wert NaN oder Infinity ist, wird false zurückgegeben. Die Methode gibt auch true zurück für Fließkommazahlen, die als ganze Zahl dargestellt werden können. Sie gibt immer false zurück, wenn der Wert keine Zahl ist.

Beachten Sie, dass einige Zahlenliterale, die wie keine ganzen Zahlen aussehen, tatsächlich ganze Zahlen darstellen — aufgrund der Präzisionsgrenze der ECMAScript Fließkomma-Zahlencodierung (IEEE-754). Zum Beispiel unterscheidet sich 5.0000000000000001 nur um 1e-16 von 5, was zu klein ist, um dargestellt zu werden. (Zur Referenz: Number.EPSILON speichert den Abstand zwischen 1 und der nächstgrößeren darstellbaren Fließkommazahl, und das ist etwa 2.22e-16.) Daher wird 5.0000000000000001 mit der gleichen Codierung wie 5 dargestellt, wodurch Number.isInteger(5.0000000000000001) true zurückgibt.

In ähnlicher Weise leiden Zahlen im Bereich der Größenordnung von Number.MAX_SAFE_INTEGER unter Präzisionsverlust und führen dazu, dass Number.isInteger true zurückgibt, auch wenn es sich nicht um eine ganze Zahl handelt. (Die tatsächliche Schwelle variiert je nachdem, wie viele Bits benötigt werden, um die Dezimalzahl darzustellen — zum Beispiel ist Number.isInteger(4500000000000000.1) true, aber Number.isInteger(4500000000000000.5) ist false.)

Beispiele

Verwendung von isInteger

Number.isInteger(0); // true
Number.isInteger(1); // true
Number.isInteger(-100000); // true
Number.isInteger(99999999999999999999999); // true

Number.isInteger(0.1); // false
Number.isInteger(Math.PI); // false

Number.isInteger(NaN); // false
Number.isInteger(Infinity); // false
Number.isInteger(-Infinity); // false
Number.isInteger("10"); // false
Number.isInteger(true); // false
Number.isInteger(false); // false
Number.isInteger([1]); // false

Number.isInteger(5.0); // true
Number.isInteger(5.000000000000001); // false
Number.isInteger(5.0000000000000001); // true, because of loss of precision
Number.isInteger(4500000000000000.1); // true, because of loss of precision

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-number.isinteger