Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.isInteger: całkowita wartość Number bez koercji

Number.isInteger zwraca true, gdy argument jest skończoną wartością Number bez części ułamkowej, bez konwertowania innych typów.

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

Składnia

Number.isInteger(number)

Number.isInteger(value) zwraca true dla skończonej wartości typu Number, której matematyczna wartość jest całkowita. Obejmuje to +0, -0 i liczby ujemne; NaN, Infinity, -Infinity oraz wartości z reprezentowaną częścią ułamkową dają false. Brak argumentu także daje false.

Metoda nie stosuje ToNumber, więc "3", BigInt, Symbol, null, boolean, zwykły obiekt i new Number(3) dają false bez konwersji. Test dotyczy już zapisanej wartości binary64: literał z bardzo małą częścią ułamkową może wcześniej zaokrąglić się do liczby całkowitej. Ponadto Number.isInteger(2 ** 53) daje true, choć ta wartość nie jest bezpieczną liczbą całkowitą; do tego służy Number.isSafeInteger.

Metoda istnieje od ECMAScript 2015 i nie jest konstruktorem. Przykład waliduje numer strony i rozmiar strony jako liczby całkowite w jawnym zakresie, a następnie wybiera rekordy c d. Przy indeksach, licznikach i identyfikatorach zawsze połącz test całkowitości z granicami dziedziny; jeśli dokładność kolejnych liczb całkowitych ma znaczenie, wymagaj też bezpiecznego zakresu.

Przykłady

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));

Wynik

c d
true false false
true true false

Number.isInteger → walidacja stronicowania oraz granica safe integer

Źródła