parseFloatDef()

parseFloatDef(value, defaultValue): number

Parses a string to a float with a fallback default value.

note

Returns default for null, undefined, empty strings, and invalid inputs.

---

Parameters

value: Nullish<string>

The string value to parse (can be nullish or empty).

defaultValue: number

The value to return if parsing fails.

---

Returns: number

The parsed float or default value.

---

See Also

• parseFloat
• parseIntDef

---

Since

1.0.0

---

Example

parseFloatDef('42.99', 0);   // => 42.99
parseFloatDef('invalid', 0); // => 0
parseFloatDef('', 10.5);     // => 10.5
parseFloatDef(null, 1.0);    // => 1.0

---

How it works?

Parses a string to a float with a fallback default value, handling nullish inputs.

Validation Flow

Common Inputs

Value	Default	Result
'42.99'	0	42.99
'invalid'	0	0
''	10.5	10.5
null	1.0	1.0
undefined	5	5

---

Use Cases

Handle optional floating-point inputs 📌

Parse a float from potentially null or undefined inputs safely. Perfect for optional query parameters or partial API responses.

#handle#optional#float#nullable#query-params#API

// queryParam might be null, undefined, or string
const height = parseFloatDef(queryParam, 1.0);

Set defaults for missing data

Provide sensible defaults when parsing possibly empty strings. Useful for data normalization pipelines.

#defaults#missing#normalization#empty#fallback#parsing

const value = parseFloatDef("", 0.0); // Returns 0.0