Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.isFinite: um Number finito sem coerção

Number.isFinite devolve true apenas se o argumento for um Number que não seja NaN nem infinito positivo ou negativo.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Number.isFinite(number)

Number.isFinite(value) verifica primeiro o tipo do argumento. Devolve true para qualquer Number finito, incluindo +0, -0, números subnormais e Number.MAX_VALUE; devolve false para NaN, Infinity e -Infinity. A ausência de argumento equivale a undefined e também produz false.

O método não aplica ToNumber. Strings, booleanos, null, BigInt, Symbol, objetos comuns e wrappers new Number(...) produzem false, sem chamar os respetivos mecanismos de conversão. Isto difere do isFinite global, que faz coerção: por exemplo, isFinite("21.25") é true, enquanto Number.isFinite("21.25") é false; a forma global também pode lançar durante a conversão.

O método existe desde ECMAScript 2015 e não é construtor. O exemplo usa-o na fronteira de validação de uma temperatura para chamar toFixed apenas sobre um Number finito real. Se for permitido texto numérico, analisa-o explicitamente e verifica depois o resultado com Number.isFinite.

Exemplos

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

Resultado

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

Number.isFinite → validação estrita de temperatura sem coerção

Fontes