SwUpdate — Angular | Spec-Zone.ru

Подписывайтесь на уведомления об обновлениях от Service Worker, запускайте проверки обновлений и принудительно активируйте обновления.

API

class SwUpdate {
  constructor(sw: NgswCommChannel): SwUpdate;
  readonly versionUpdates: Observable<VersionEvent>;
  readonly unrecoverable: Observable<UnrecoverableStateEvent>;
  readonly isEnabled: boolean;
  checkForUpdate(): Promise<boolean>;
  activateUpdate(): Promise<boolean>;
}

constructor

SwUpdate

@paramswNgswCommChannel

@returnsSwUpdate

versionUpdates

Observable<VersionEvent>

Выдаёт событие VersionDetectedEvent при обнаружении на сервере новой версии.

Выдаёт событие VersionInstallationFailedEvent при возникновении ошибки во время проверки или загрузки новой версии.

Выдаёт событие VersionReadyEvent после загрузки новой версии, когда она готова к активации.

unrecoverable

Observable<UnrecoverableStateEvent>

Выдаёт событие UnrecoverableStateEvent, если версия приложения, которую service worker использует для обслуживания этого клиента, находится в неисправном состоянии, из которого невозможно восстановиться без полной перезагрузки страницы.

isEnabled

boolean

Значение true, если Service Worker включён (поддерживается браузером и включён через ServiceWorkerModule).

checkForUpdate

Promise<boolean>

Проверяет наличие обновления и ожидает, пока новая версия не будет загружена с сервера и готова к активации.

@returnsPromise<boolean>

промис, который

выполняется со значением true, если найдена новая версия, готовая к активации;
выполняется со значением false, если новая версия не найдена;
отклоняется при возникновении любой ошибки.

activateUpdate

Promise<boolean>

Обновляет текущий клиент (например, вкладку браузера) до последней версии, готовой к активации.

В большинстве случаев не следует использовать этот метод — вместо этого обновите клиент, перезагрузив страницу.

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

Используйте этот метод, только если уверены, что он безопасен для вашего конкретного случая.

@returnsPromise<boolean>

промис, который

выполняется со значением true, если обновление успешно активировано;
выполняется со значением false, если обновление недоступно (например, клиент уже использует последнюю версию);
отклоняется при возникновении любой ошибки.