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));
// Résultat attendu : false
console.log(Number.isFinite(10 / 5));
// Résultat attendu : true
console.log(Number.isFinite(0 / 0));
// Résultat attendu : 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 |
Compatibilité des navigateurs
Voir aussi
- La prothèse d'émulation de
Number.isFinitedanscore-js(angl.) - La prothèse d'émulation es-shims de
Number.isFinite(angl.) - L'objet natif
Number - La fonction native
isFinite()