AbortSignal: метод timeout() статический

Статический метод AbortSignal.timeout() возвращает AbortSignal, который автоматически прервёт выполнение после указанного времени.

Сигнал прерывается с исключением TimeoutError DOMException при истечении времени ожидания или с исключением AbortError DOMException при нажатии пользователем кнопки остановки браузера (или любой другой встроенной операции остановки). Это позволяет пользовательским интерфейсам различать ошибки истечения времени ожидания, которые, как правило, требуют уведомления пользователя, от прерываний, вызванных пользователем, которые не требуют уведомления.

Время ожидания основано на активном, а не на прошедшем времени, и фактически приостановится, если код выполняется в приостановленном потоке или пока документ находится в кеше обратной навигации («bfcache»).

Для объединения нескольких сигналов можно использовать AbortSignal.any(), например, для непосредственного прерывания загрузки с помощью сигнала истечения времени ожидания или вызова AbortController.abort().

time

Время в миллисекундах ("активное") до прерывания возвращаемого AbortSignal. Значение должно находиться в диапазоне от 0 до Number.MAX_SAFE_INTEGER.

Объект AbortSignal.

Сигнал будет прерван со свойством AbortSignal.reason, установленным на TimeoutError DOMException при истечении времени ожидания или на AbortError DOMException если операция была прервана пользователем.

Ниже приведен пример операции fetch, которая будет прервана по истечении 5 секунд, если она не будет успешной. Обратите внимание, что это также может завершиться ошибкой, если метод не поддерживается, если пользователь нажмёт кнопку "стоп" в браузере или по другой причине.

const url = "https://path_to_large_file.mp4";

try {
  const res = await fetch(url, { signal: AbortSignal.timeout(5000) });
  const result = await res.blob();
  // …
} catch (err) {
  if (err.name === "TimeoutError") {
    console.error("Timeout: It took more than 5 seconds to get the result!");
  } else if (err.name === "AbortError") {
    console.error(
      "Fetch aborted by user action (browser stop button, closing tab, etc.",
    );
  } else if (err.name === "TypeError") {
    console.error("AbortSignal.timeout() method is not supported");
  } else {
    // A network error, or some other problem.
    console.error(`Error: type: ${err.name}, message: ${err.message}`);
  }
}