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

CKTIS / JavaScript

Number.isFinite : un Number fini sans coercition

Number.isFinite renvoie true uniquement si l’argument est un Number qui n’est ni NaN ni une infinité positive ou négative.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Number.isFinite(number)

Number.isFinite(value) vérifie d’abord le type de l’argument. Elle renvoie true pour tout Number fini, y compris +0, -0, les nombres subnormaux et Number.MAX_VALUE, mais false pour NaN, Infinity et -Infinity. Un argument absent vaut undefined et donne aussi false.

La méthode n’applique pas ToNumber. Les chaînes, booléens, null, BigInt, Symbol, objets ordinaires et wrappers new Number(...) donnent false, sans appeler leurs mécanismes de conversion. Elle diffère donc du isFinite global, qui effectue une coercition : isFinite("21.25") vaut par exemple true, alors que Number.isFinite("21.25") vaut false ; la forme globale peut aussi lever une exception pendant la conversion.

La méthode existe depuis ECMAScript 2015 et n’est pas un constructeur. L’exemple l’utilise à la frontière de validation d’une température afin de n’appeler toFixed que sur un véritable Number fini. Si le texte numérique est autorisé, analysez-le explicitement puis vérifiez le résultat avec Number.isFinite.

Exemples

function formatTemperature(value) {
  return Number.isFinite(value) ? `${value.toFixed(1)} C` : "invalid";
}

console.log([21.25, "21.25", NaN, Infinity].map(formatTemperature).join(" | "));
console.log(Number.isFinite(0), Number.isFinite(-0), Number.isFinite(Number.MAX_VALUE));
console.log(Number.isFinite(1n), Number.isFinite(Symbol("x")));
console.log(isFinite("21.25"), Number.isFinite("21.25"));

Résultat

21.3 C | invalid | invalid | invalid
true true true
false false
true false

Number.isFinite → validation stricte d’une température sans coercition

Sources