WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Number.isInteger: ganzzahlige Number ohne Koercion

Number.isInteger liefert true, wenn das Argument eine endliche Number ohne Bruchteil ist, ohne andere Typen umzuwandeln.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

Number.isInteger(number)

Number.isInteger(value) liefert true für eine endliche Number, deren mathematischer Wert ganzzahlig ist. Dazu gehören +0, -0 und negative Ganzzahlen; NaN, Infinity, -Infinity und Werte mit dargestelltem Bruchteil ergeben false. Auch ein fehlendes Argument ergibt false.

Die Methode wendet ToNumber nicht an; daher ergeben "3", BigInt, Symbol, null, boolesche Werte, normale Objekte und new Number(3) ohne Konvertierung false. Der Test sieht den bereits gespeicherten binary64-Wert: Ein Literal mit winzigem Bruchteil kann zuvor auf eine Ganzzahl gerundet worden sein. Außerdem ist Number.isInteger(2 ** 53) true, obwohl der Wert keine sichere Ganzzahl ist; dafür dient Number.isSafeInteger.

Die Methode existiert seit ECMAScript 2015 und ist kein Konstruktor. Das Beispiel validiert Seitennummer und Seitengröße als Ganzzahlen mit expliziten Grenzen und wählt danach c d. Kombiniere den Ganzzahltest bei Indizes, Zählern und Kennungen mit Bereichsgrenzen; wenn aufeinanderfolgende Ganzzahlen exakt sein müssen, verlange zusätzlich den sicheren Bereich.

Beispiele

function page(records, pageNumber, pageSize) {
  if (!Number.isInteger(pageNumber) || pageNumber < 1 || pageNumber > 1000) return [];
  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) return [];
  const start = (pageNumber - 1) * pageSize;
  return records.slice(start, start + pageSize);
}

console.log(page(["a", "b", "c", "d", "e"], 2, 2).join(" "));
console.log(Number.isInteger(3), Number.isInteger(3.2), Number.isInteger("3"));
console.log(Number.isInteger(-0), Number.isInteger(2 ** 53), Number.isSafeInteger(2 ** 53));

Ergebnis

c d
true false false
true true false

Number.isInteger → Paginierungsvalidierung und sichere Ganzzahlgrenze

Quellen