ofetch: onRequestError called 3 times (with retry), is this expected?

[WailanTirajoh]

Environment

• Nuxt 4.0.2
• ofetch version: 1.4.1

Code

import type { FetchOptions } from "ofetch";

export default defineNuxtPlugin(async (_nuxtApp) => {
  const config = useRuntimeConfig();

  const baseConfig: FetchOptions = {
    baseURL: config.public.retailBaseAPI,
    retry: 2,
    retryDelay: 500,
    onRequestError: handleRequestError,
    onResponseError: handleResponseError,
  };

  const api = $fetch.create({
    ...baseConfig,
    async onRequest({ options }) {
      const defaultHeader = await useApiHeader();
      options.headers = {
        ...defaultHeader,
        ...options.headers,
      };
    },
  });

  const publicApi = $fetch.create(baseConfig);

  return {
    provide: {
      api,
      publicApi,
    },
  };
});

Description

With the configuration above:

• retry is set to 2 and retryDelay is set to 500ms.
• onResponseError works as expected: it is only called after the last retry fails (i.e., after 3 total attempts).
• But for onRequestError, it gets called 3 times, once for each failed attempt.

Objective

My goal is to show a toast error notification only once, after the final retry fails, for network-related issues or other request errors.

Right now, because onRequestError is called on each retry, the toast shows multiple times which is not the desired UX.

Question

Is this the intended behavior of onRequestError?
And is there a way to make it behave like onResponseError, so it only gets called once after all retries fail?

Or is there any recommended workaround to achieve this behavior?

Thanks in advance!

[WailanTirajoh]

I just found out i can get ctx.options.retry and manually invoke my function when it reaches 0