Skip to main content

isFinite()

isFinite(value): value is number

Checks if value is a finite number.

DEPRECATED

Use Number.isFinite() directly instead.


Parametersโ€‹

value: unknownโ€‹

The value to check.


Returns: value is numberโ€‹

true if value is a finite number, else false.


See Alsoโ€‹


Sinceโ€‹

2.0.0


Also known asโ€‹

isFinite (Lodash, es-toolkit) ยท โŒ (Remeda, Radashi, Ramda, Effect, Modern Dash, Antfu)


Exampleโ€‹

// โŒ Deprecated approach
isFinite(42); // => true
isFinite(Infinity); // => false
isFinite(NaN); // => false
isFinite('42'); // => false

// โœ… Recommended approach
Number.isFinite(42); // => true
Number.isFinite(Infinity); // => false
Number.isFinite(NaN); // => false
Number.isFinite('42'); // => false

How it works?โ€‹

Checks if value is a finite number.

Type Narrowingโ€‹

Common Checksโ€‹

ValueResult
42checkmark true
3.14checkmark true
Infinitycross false
-Infinitycross false
NaNcross false
'42'cross false

warning Deprecated: Use Number.isFinite() directly.


Use Casesโ€‹

Validate finite number ๐Ÿ“Œโ€‹

Check if value is a finite number.

Number.isFinite(42);        // true
Number.isFinite(Infinity); // false
Number.isFinite(NaN); // false

Guard calculationsโ€‹

Ensure calculation results are valid.

const result = a / b;
if (Number.isFinite(result)) {
return result;
}
return 0; // fallback for Infinity/NaN