Number : méthode statique isFinite()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La méthode statique Number.isFinite() permet de déterminer si la valeur fournie est un nombre fini — c'est-à-dire qu'elle vérifie qu'une valeur donnée est un nombre, et que ce nombre n'est ni Infinity positif, ni Infinity négatif, ni NaN.
Exemple interactif
console.log(Number.isFinite(1 / 0));
// Sortie attendue : false
console.log(Number.isFinite(10 / 5));
// Sortie attendue : true
console.log(Number.isFinite(0 / 0));
// Sortie attendue : false
Syntaxe
Number.isFinite(value)
Paramètres
value-
La valeur dont on souhaite savoir si elle est finie.
Valeur de retour
La valeur booléenne true si la valeur donnée est un nombre fini. Sinon false.
Exemples
Utiliser isFinite()
Number.isFinite(Infinity); // false
Number.isFinite(NaN); // false
Number.isFinite(-Infinity); // false
Number.isFinite(0); // true
Number.isFinite(2e64); // true
Différence entre Number.isFinite() et le isFinite() natif
En comparaison avec la fonction native isFinite() de l'objet global, cette méthode ne convertit pas d'abord le paramètre en nombre. Cela signifie que seules les valeurs de type nombre et finies retournent true, et que les non-nombres retournent toujours false.
isFinite("0"); // true ; converti en nombre 0
Number.isFinite("0"); // false
isFinite(null); // true ; converti en nombre 0
Number.isFinite(null); // false
Spécifications
| Spécification |
|---|
| ECMAScript® 2027 Language Specification # sec-number.isfinite |