Skip to main content

Function: safeParsePercentage()

safeParsePercentage(value: unknown, defaultValue: number): number

Defined in: shared/utils/safeConversions.ts:159

Safely converts a value to a percentage (0-100) with fallback.

Parameters​

value​

unknown

Value to convert to percentage

defaultValue​

number = 0

Fallback value if conversion fails (default: 0)

Returns​

number

Valid percentage clamped between 0 and 100, or the default value

Remarks​

First converts the value to a float, then clamps the result to the valid percentage range of 0-100. Useful for progress indicators and completion ratios.

Example​

safeParsePercentage("75"); // 75
safeParsePercentage("150"); // 100 (clamped)
safeParsePercentage("-10"); // 0 (clamped)
safeParsePercentage("invalid"); // 0