toNumber()

toNumber(value): number

Converts value to a number.

DEPRECATED

Use Number() directly instead.

---

Parameters

value: unknown

The value to convert.

---

Returns: number

The converted number.

---

See Also

Number() - MDN

---

Since

2.0.0

---

Also known as

toNumber (Lodash, es-toolkit) · ❌ (Remeda, Radashi, Ramda, Effect, Modern Dash, Antfu)

---

Example

// ❌ Deprecated approach
toNumber('42');       // => 42
toNumber('3.14');     // => 3.14
toNumber(true);       // => 1
toNumber(null);       // => 0

// ✅ Recommended approach
Number('42');         // => 42
Number('3.14');       // => 3.14
Number(true);         // => 1
Number(null);         // => 0

---

How it works?

Converts value to a number. Deprecated: Use Number() directly.

Native Equivalent

// ❌ toNumber(value)
// ✅ Number(value)
// ✅ +value
// ✅ parseFloat(value)

---

Use Cases

Convert to number 📌

Convert values to numbers.

#convert#number#parse#coerce

Number(value);      // toNumber
parseInt(value, 10); // toInteger
Math.trunc(Number(value)); // toInteger

Safe integer conversion

Convert to safe integer range.

#safe#integer#bounds#clamp

const n = Number(value);
Math.min(Math.max(Math.trunc(n), Number.MIN_SAFE_INTEGER), Number.MAX_SAFE_INTEGER);

Handle edge cases

Handle non-numeric values.

#handle#edge#NaN#Infinity

const n = Number(value);
Number.isFinite(n) ? n : 0;