Skip to main content

Function: safeJsonParseWithFallback()

safeJsonParseWithFallback<T>(json: string, validator: (data: unknown) => data is T, fallback: T): T

Defined in: shared/utils/jsonSafety.ts:210

Parses JSON with validation and returns a fallback on failure.

Type Parametersโ€‹

Tโ€‹

T

Validated shape returned on success or fallback.

Parametersโ€‹

jsonโ€‹

string

Raw JSON string to parse.

validatorโ€‹

(data: unknown) => data is T

Type guard ensuring the parsed value satisfies T.

fallbackโ€‹

T

Value returned when parsing or validation fails.

Returnsโ€‹

T

The validated data or the provided fallback.

Remarksโ€‹

Delegates to safeJsonParse. When parsing fails the provided fallback is returned, ensuring callers always receive a value of type T.

Exampleโ€‹

const config = safeJsonParseWithFallback(
configString,
(data): data is Config => isValidConfig(data),
{ timeout: 5000, retries: 3 }
);