Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

isFinite() — finitude après conversion numérique

La fonction globale isFinite(value) vérifie si son argument devient un nombre fini après conversion. Contrairement à Number.isFinite(), elle accepte aussi, par conversion, certaines valeurs qui ne sont pas des nombres, notamment "42" et null.

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

Syntaxe

isFinite(value)

isFinite(value) est une fonction globale ECMAScript. Elle convertit d’abord son argument en Number à l’aide de l’opération ToNumber, puis renvoie true si le résultat est fini. Elle renvoie false pour NaN, Infinity et -Infinity ; les deux zéros et les fractions finies donnent true.

La conversion est importante : "42" devient 42, tandis que "" et null deviennent 0. Ces arguments donnent donc tous true. undefined et la chaîne "hello" deviennent NaN et donnent false. Appeler isFinite() sans argument donne également false.

Ce n’est pas une vérification stricte du type numérique. Pour vérifier qu’une valeur est déjà un nombre fini de type Number, utilisez Number.isFinite(value) : cette fonction ne fait aucune conversion et renvoie false pour "42", null et toute autre valeur qui n’est pas de type Number. Être fini ne signifie pas être un entier ni un entier sûr.

La conversion peut aussi lever une exception : un argument de type Symbol ou BigInt provoque une TypeError au lieu de renvoyer false. Pour les objets, la conversion peut exécuter du code personnalisé et propager une exception. L’exemple compare les deux vérifications sans utiliser d’objets ni de valeurs qui déclenchent une exception.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources