Skip to content

RetryDecorator

katanakit-js / RetryDecorator

function RetryDecorator<T>(fn, retries?, delayMs?): T;

Defined in: infrastructure/decorators/retry.decorator.ts:36

RetryDecorator - Decorator Pattern para reintentos.

Envuelve una función asíncrona y la re-ejecuta cuando lanza, con un intervalo fijo entre intentos. No modifica la función original: la decoración se aplica en tiempo de composición (Open/Closed).

Nota: el nombre usa mayúscula inicial porque es un decorador composible, no una función utilitaria (use*) del API pública.

Type Parameter Description
T extends (…args) => Promise<unknown> Tipo de la función envuelta.
Parameter Type Default value Description
fn T undefined La función asíncrona a decorar.
retries? number 3 Número máximo de reintentos adicionales (default 3).
delayMs? number 1000 Intervalo entre intentos en ms (default 1000).

T

La función decorada con reintentos.

import { RetryDecorator } from "katanakit-js";
const fetchWithRetry = RetryDecorator(() => fetch("/api"), 3, 500);
// reintenta hasta 3 veces con 500ms de espera antes de propagar el error
await fetchWithRetry();

Composición con otros decoradores

const robust = RetryDecorator(LoggerDecorator(flakyRequest), 2, 200);

Only thrown errors trigger a retry. KatanaKit’s Safe Result helpers (useFetch, useGet, …) never throw — they return { ok: false } — so they are not retried as-is. To retry those, make fn throw on failure (e.g. unwrap with useSafeQueryFn) or check result.ok inside fn.