ExtendableEvent.waitUntil()

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

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

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

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

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

Синтаксис

extendableEvent.waitUntil(promise);

Параметры

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

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