isFinite()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La fonction globale isFinite() détermine si la valeur passée en argument est un nombre fini. Si nécessaire, le paramètre est d'abord converti en nombre.

Exemple interactif

Syntaxe

js
isFinite(valeurÀTester);

Paramètres

valeurÀTester

La valeur dont on souhaite savoir si elle est finie ou non.

Valeur de retour

false si la valeur passée en argument vaut Infinity (en positif ou en négatif),NaN ou undefined, true sinon.

Description

isFinite() est une fonction qui n'est rattachée à aucun objet et qui est disponible au plus haut niveau.

Cette fonction peut être utilisée pour déterminer si un nombre est fini ou non. La fonction isFinite() examine le nombre passé en argument : si celui-ci vaut NaN, Infinity (pour l'infini) ou -Infinity (pour l'infini négatif), cette fonction renvoie false sinon elle renvoie true.

Exemples

js
isFinite(Infinity); // false
isFinite(NaN); // false
isFinite(-Infinity); // false

isFinite(0); // true
isFinite(2e64); // true
isFinite(910); // true
isFinite(null); // true, ce qui aurait été false
// avec la méthode Number.isFinite(null)

isFinite("0"); // true ce qui aurait été false
// avec la méthode Number.isFinite("0")

Spécifications

Specification
ECMAScript Language Specification
# sec-isfinite-number

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi