---
title: Number.isFinite()
slug: Web/JavaScript/Reference/Global_Objects/Number/isFinite
tags:
  - ECMAScript6
  - JavaScript
  - Méthode
  - Number
  - Reference
  - polyfill
translation_of: Web/JavaScript/Reference/Global_Objects/Number/isFinite
original_slug: Web/JavaScript/Reference/Objets_globaux/Number/isFinite
---
<div>{{JSRef}}</div>

<p>La méthode <strong><code>Number.isFinite()</code></strong> permet de déterminer si la valeur fournie est un nombre fini.</p>

<div>{{EmbedInteractiveExample("pages/js/number-isfinite.html")}}</div>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox notranslate">Number.isFinite(valeurÀTester);</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt><code>valeurÀTester</code></dt>
 <dd>La valeur dont on souhaite savoir si elle est finie.</dd>
</dl>

<h3 id="Valeur_de_retour">Valeur de retour</h3>

<p>Un booléen indiquant si la valeur passée en argument est un nombre fini.</p>

<h2 id="Description">Description</h2>

<p>Par rapport à la fonction de l'objet global {{jsxref("isFinite","isFinite()")}} qui convertit l'argument donné en un nombre, la fonction <code>Number.isFinite </code>ne convertit pas l'argument et ne renvoie pas <code>true</code>.</p>

<h2 id="Exemples">Exemples</h2>

<pre class="brush:js; notranslate">Number.isFinite(Infinity);  // false
Number.isFinite(NaN);       // false
Number.isFinite(-Infinity); // false

Number.isFinite(0);         // true
Number.isFinite(2e64);      // true

Number.isFinite("0");       // false, ce qui aurait
                            // renvoyé true avec isFinite("0")

Number.isFinite(null);      // false, ce qui aurait
                            // renvoyé true avc isFinite(null)
</pre>

<h2 id="Prothèse_démulation_polyfill">Prothèse d'émulation (<em>polyfill</em>)</h2>

<pre class="brush:js; notranslate">// Number.isFinite polyfill
// http://people.mozilla.org/~jorendorff/es6-draft.html#sec-number.isfinite
if (typeof Number.isFinite !== 'function') {
    Number.isFinite = function isFinite(value) {
        // 1. Si Type(number) n'est pas Number, on renvoie false.
        if (typeof value !== 'number') {
            return false;
        }
        // 2. Si le nombre est NaN, +∞, ou −∞, on renvoie false.
        if (value !== value || value === Infinity || value === -Infinity) {
            return false;
        }
        // 3. Sinon on renvoie true.
        return true;
    };
}
</pre>

<p>Deuxième version plus concise qui utilise la méthode globale <code>isFinite</code></p>

<pre class="brush: js notranslate">if (Number.isFinite === undefined) Number.isFinite = function(value) {
    return typeof value === "number" &amp;&amp; isFinite(value);
}</pre>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-number.isfinite', 'Number.isInteger')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td>Définition initiale.</td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-number.isfinite', 'Number.isInteger')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("javascript.builtins.Number.isFinite")}}</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>L'objet {{jsxref("Number")}} auquel appartient cette méthode</li>
 <li>La méthode {{jsxref("isFinite", "isFinite()")}} de l'objet global</li>
</ul>