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