Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Number.isFinite: un Number finito senza coercizione

Number.isFinite restituisce true solo se l’argomento è un Number che non è NaN né infinito positivo o negativo.

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

Sintassi

Number.isFinite(number)

Number.isFinite(value) controlla prima il tipo dell’argomento. Restituisce true per ogni Number finito, inclusi +0, -0, numeri subnormali e Number.MAX_VALUE; restituisce false per NaN, Infinity e -Infinity. Un argomento mancante equivale a undefined e produce anch’esso false.

Il metodo non applica ToNumber. Stringhe, booleani, null, BigInt, Symbol, oggetti ordinari e wrapper new Number(...) producono false, senza chiamare i relativi hook di conversione. Ciò differisce da isFinite globale, che esegue coercizione: per esempio isFinite("21.25") è true, mentre Number.isFinite("21.25") è false; la forma globale può anche generare eccezioni durante la conversione.

Il metodo esiste da ECMAScript 2015 e non è un costruttore. L’esempio lo usa al confine di validazione di una temperatura, così toFixed viene chiamato solo su un vero Number finito. Se è ammesso testo numerico, analizzalo esplicitamente e poi verifica il risultato con Number.isFinite.

Esempi

function formatTemperature(value) {
  return Number.isFinite(value) ? `${value.toFixed(1)} C` : "invalid";
}

console.log([21.25, "21.25", NaN, Infinity].map(formatTemperature).join(" | "));
console.log(Number.isFinite(0), Number.isFinite(-0), Number.isFinite(Number.MAX_VALUE));
console.log(Number.isFinite(1n), Number.isFinite(Symbol("x")));
console.log(isFinite("21.25"), Number.isFinite("21.25"));

Risultato

21.3 C | invalid | invalid | invalid
true true true
false false
true false

Number.isFinite → validazione rigorosa della temperatura senza coercizione

Fonti