Як перевірити, чи число є скінченним?

Повне пояснення

Що це і навіщо

Number.isFinite() – глобальна функція JavaScript, яка визначає, чи передане значення є конкретним числом (не Infinity, -Infinity, NaN). Використовується для валідації даних, що надходять з користувача або зовнішніх API.

Ключові принципи

• Працює лише з типом number; інші типи автоматично повертають false.
• Не конвертує значення (на відміну від глобального isFinite).
• Враховує тільки конкретні числа, тому Number.isFinite('10') → false.

Як це працює

Функція перевіряє три умови:

1. Значення є типом number.
2. Не дорівнює Infinity або -Infinity.
3. Не дорівнює NaN (через Number.isNaN). Якщо всі три виконані, повертається true.

Практика і реалізація

// Приклад перевірки
const values = [42, Infinity, -Infinity, NaN, '10', 0];
values.forEach(v => console.log(Number.isFinite(v)));

Вивід: true false false false false true.

Тестування

import { describe, it, expect } from 'vitest';

describe('Number.isFinite', () => {
  it('should return true for finite numbers', () => {
    expect(Number.isFinite(123)).toBe(true);
  });
  it('should return false for Infinity', () => {
    expect(Number.isFinite(Infinity)).toBe(false);
  });
});

Дизайн‑рішення

У випадках, коли потрібна валідація даних з форми або API, Number.isFinite слід комбінувати з перевіркою типу (typeof value === 'number'). Якщо потрібно приймати рядки, що представляють числа, спочатку перетворюйте їх через Number(value) і потім застосовуйте Number.isFinite.

Безпека та приватність

Перевірка допомагає запобігти некоректним або шкідливим даним у бізнес‑логіці, зменшуючи ризик помилок типу overflow чи розрахункових помилок.

Альтернативи

• isFinite(value) – глобальна функція, яка конвертує значення до числа; менш безпечна.
• Number.isNaN() + перевірка на Infinity для ручної реалізації.

Часті помилки

1. Використання isFinite замість Number.isFinite.
2. Не перевіряти тип перед викликом.
3. Очікувати, що рядок '10' буде валідним.
4. Забувати про NaN, який також не є скінченним.
5. Перетворювати значення до числа безпосередньо в логіці.
6. Не враховувати -0 (але це все одно скінчне).
7. Використовувати Number.isFinite() у колбеках, що повертають об’єкти.
8. Застосовувати до великих масивів без оптимізації.

Cheatsheet