Custom retry logic

[stychu]

Describe the feature

Having a retry on specific status codes is great but could we get a more customizable way of getting a retry to happen? I think this is a common use case to retry a request if the response doest match criteria.

Now I need to do custom wrapper logic to get such functionality.

//custom wrapper
export async function retryCall<T>({
  callback,
  maxRetries = 5,
  isResponseMatch,
  delayMs = 1000,
}: {
  maxRetries?: number;
  isResponseMatch: (data: T) => boolean;
  callback: () => Promise<T>;
  delayMs?: number;
}): Promise<T> {
  for (let attempt = 1; attempt < maxRetries; attempt++) {
    try {
      const response = await callback();

      if (isResponseMatch(response)) {
        return response;
      }
    } catch (error) {
      throw error;
    }

    await new Promise((resolve) => setTimeout(resolve, delayMs));
  }

  return await callback();
}

await retryCall({
      callback: () => ofetch(...),
      isResponseMatch: (data) => data === 'success',
    })

Additional information

• Would you be willing to help implement this feature?

[faizanu94]

Thanks for opening this issue 💫 I’ve opened a PR to address it: #513 – Add retryCondition Option.

What it adds

• A new retryCondition(context) callback for custom retry logic.
• Works independently of retryStatusCodes; retries if either is satisfied.
• Errors thrown inside retryCondition are propagated to the consumer.
• Covered by unit tests (sync, async, status + condition interplay, thrown error, etc.).

Example usage:

await $fetch('/api/data', {
  retry: 3,
  retryCondition: (ctx) => {
    // Retry until response body contains expected field
    return ctx.response?._data?.status !== 'ready';
  }
});

Possible future extensions

• Built-in strategies (e.g. exponential backoff, jitter).
• Composable retry policies (e.g. combine multiple conditions).

Feedback welcome!