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 July 2015.

Die Number.isInteger() statische Methode 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 zu testende Wert, ob er eine ganze Zahl ist.

Rückgabewert

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

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

Beachten Sie, dass einige Zahlendaten, obwohl sie wie Nicht-Ganzzahlen 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ächsten darstellbaren Fließkommazahl größer als 1, und das ist etwa 2.22e-16.) Daher wird 5.0000000000000001 mit der gleichen Codierung wie 5 dargestellt, was dazu führt, dass Number.isInteger(5.0000000000000001) true zurückgibt.

In ähnlicher Weise werden Zahlen in der Größenordnung von Number.MAX_SAFE_INTEGER an Präzision verlieren, und Number.isInteger wird true zurückgeben, selbst wenn es sich nicht um eine ganze Zahl handelt. (Die tatsächliche Schwelle variiert basierend darauf, 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® 2025 Language Specification # sec-number.isinteger