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

CKTIS / JavaScript

isFinite() — finitude após conversão numérica

A função global isFinite(value) verifica se o argumento se torna um número finito após a conversão. Ao contrário de Number.isFinite(), também aceita, por conversão, alguns valores que não são números, incluindo "42" e null.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

isFinite(value)

isFinite(value) é uma função global ECMAScript. Primeiro converte o argumento para Number através da operação ToNumber e, em seguida, devolve true se o resultado for finito. Devolve false para NaN, Infinity e -Infinity; ambos os zeros e as fracções finitas produzem true.

A conversão é importante: "42" passa a 42, enquanto "" e null passam a 0, pelo que todos estes argumentos produzem true. undefined e a cadeia "hello" passam a NaN e produzem false. Chamar isFinite() sem argumentos também produz false.

Isto não é uma verificação estrita do tipo numérico. Para verificar se um valor já é um número finito do tipo Number, utiliza Number.isFinite(value): não faz conversões e devolve false para "42", null e qualquer outro valor que não seja do tipo Number. Ser finito não significa ser um número inteiro ou um número inteiro seguro.

A conversão também pode lançar uma excepção: um argumento do tipo Symbol ou BigInt provoca um TypeError, em vez de devolver false. No caso de objectos, a conversão pode executar código personalizado e propagar uma excepção. O exemplo compara as duas verificações sem usar objectos nem valores que provoquem uma excepção.

Exemplos

const values = [42, "42", "", null, NaN, Infinity, undefined];
for (const value of values) {
  console.log(`${isFinite(value)} | ${Number.isFinite(value)}`);
}

Resultado

true | true
true | false
true | false
true | false
false | false
false | false
false | false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes