ExtendableEvent.waitUntil()

Метод ExtendableEvent.waitUntil() сообщает диспетчеру событий, что выполняется действие. Также этот метод может быть использован, для того чтобы определить было ли то действие успешным. В рамках service workers, waitUntil() сообщает браузеру, что действие продолжается пока обещание не завершится (promise settles) и браузер не должен прерывать service worker если он хочет, чтобы это действие завершилось.

События install в service workers используют waitUntil() чтобы задержать service worker в installing фазе пока не завершатся задачи. Если обещание переданное в waitUntil() отклоняется, установка считается неудачной и устанавлеваемый service worker отбрасывается.  В первую очередь это используется для гарантии того, что service worker не рассматривается как установленный (installed), пока все основные кэши на которые он зависит успешно не заполнены.

События activate в service workers используют waitUntil() для размещения в буфере функциональных событий таких как fetch и push пока обещание переданное в waitUntil() не завершится успешно. Это дает service worker время, чтобы обновить схемы базы данных и удалить устаревшие caches, таким образом другие события могут полагаться на полностью обновленное состояние.

Метод waitUntil() должен быть изначально вызван внутри события обратного вызова (event callback), но после этого он может быть вызван множество раз, до тех пор пока все обещания переданные в него не завершатся успешно.

Примечание: Поведение описанное в параграфе выше, было исправлено в Firefix 43 (смотрите баг 1180274).

Синтаксис

extendableEvent.waitUntil(promise);

Параметры

Возвращаемое значение

undefined.

Примеры

Использование waitUntil() внутри события install в service worker:

addEventListener('install', event => {
  const preCache = async () => {
    const cache = await caches.open('static-v1');
    return cache.addAll([
      '/',
      '/about/',
      '/static/styles.css'
    ]);
  };
  event.waitUntil(preCache());
});

Спецификации

Спецификации Статус Комментарий
Service Workers
Определение 'waitUntil()' в этой спецификации.
Рабочий черновик Изначальное определение

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также