PendingTasks — Angular

Сервис, отслеживающий незавершённые задачи, влияющие на стабильность приложения Angular. Хотя несколько существующих сервисов Angular (например: HttpClient) управляют задачами, влияющими на стабильность, внутри себя, этот API позволяет разработчикам библиотек и приложений управлять стабильностью в конкретных случаях, не предусмотренных внутренними механизмами Angular.

API

class PendingTasks {
  add(): () => void;
  run(fn: () => Promise<unknown>): void;
}

add

() => void

Добавляет новую задачу, которая должна блокировать стабильность приложения.

@returns() => void

Функция очистки, которая при вызове удаляет задачу.

run

void

Запускает асинхронную функцию и блокирует стабильность приложения до завершения функции.

pendingTasks.run(async () => {
  const userData = await fetch('/api/user');
  this.userData.set(userData);
});

@paramfn() => Promise<unknown>

Асинхронная функция для выполнения

@returnsvoid

Описание

Стабильность важна в нескольких сценариях:

процесс SSR должен дождаться стабильности приложения, прежде чем сериализовать и отправить отрендеренный HTML;
тестам может потребоваться отложить проверки до тех пор, пока приложение не станет стабильным;

Примечания по использованию

const pendingTasks = inject(PendingTasks);
const taskCleanup = pendingTasks.add();
// do work that should block application's stability and then:
taskCleanup();