AbortSignal: метод throwIfAborted()

Метод throwIfAborted() выбрасывает исключение сигнала прерывания reason, если сигнал был прерван; в противном случае он ничего не делает.

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

Этот метод также может быть использован для прерывания операций в определенных точках кода, а не передавая сигнал в функции.

Нет.

Нет (undefined).

Примеры ниже взяты из спецификации.

Этот пример демонстрирует, как использовать throwIfAborted() для прерывания цикла опроса.

Рассмотрим асинхронную функцию waitForCondition(), которая вызывается с другой асинхронной функцией func, целевым значением targetValue и объектом AbortSignal. Метод сравнивает результат func с targetValue в цикле, возвращая значение, когда они совпадают.

async function waitForCondition(func, targetValue, { signal } = {}) {
  while (true) {
    signal?.throwIfAborted();

    const result = await func();
    if (result === targetValue) {
      return;
    }
  }
}

На каждой итерации цикла мы используем throwIfAborted() для выброса сигнала прерывания reason, если операция была прервана (и в противном случае ничего не делает). Если сигнал прерван, это приведёт к отклонению промиса waitForCondition().

• API Fetch