Skip to main content

Function: safeJsonParseWithFallback()

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

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

Parses JSON with validation and returns a fallback on failure.

Type Parameters​

T​

T extends JsonValue

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 }
);