From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/serviceworker/index.html | 105 +++++++++++++++++++++ .../web/api/serviceworker/onstatechange/index.html | 73 ++++++++++++++ .../ru/web/api/serviceworker/scripturl/index.html | 46 +++++++++ files/ru/web/api/serviceworker/state/index.html | 65 +++++++++++++ 4 files changed, 289 insertions(+) create mode 100644 files/ru/web/api/serviceworker/index.html create mode 100644 files/ru/web/api/serviceworker/onstatechange/index.html create mode 100644 files/ru/web/api/serviceworker/scripturl/index.html create mode 100644 files/ru/web/api/serviceworker/state/index.html (limited to 'files/ru/web/api/serviceworker') diff --git a/files/ru/web/api/serviceworker/index.html b/files/ru/web/api/serviceworker/index.html new file mode 100644 index 0000000000..06cb74c21c --- /dev/null +++ b/files/ru/web/api/serviceworker/index.html @@ -0,0 +1,105 @@ +--- +title: ServiceWorker +slug: Web/API/ServiceWorker +translation_of: Web/API/ServiceWorker +--- +
{{APIRef("Service Workers API")}}
+ +
+ +

Интерфейс ServiceWorker, являющийся частью ServiceWorker API, позволяет взаимодействовать с Service Worker. К одному Service Worker могут быть привязаны несколько контекстов (например страниц, Web Workers, и т.д.), каждый с использованием собственного объекта ServiceWorker.

+ +

Объект ServiceWorker можно получить через свойства {{domxref("ServiceWorkerRegistration.active")}} и {{domxref("ServiceWorkerContainer.controller")}} — это Service Worker, который активировал и контролирует текущую страницу (в случае, если Service Worker был успешно зарегистрирован и страница была обновлена)

+ +

Интерфейс ServiceWorker обрабатывает события жизненного цикла: install и activate и функциональные события, например fetch. Объект ServiceWorker также содержит опцию {{domxref("ServiceWorker.state")}}, отражающую его состояние.

+ +

Свойства

+ +

Интерфейс ServiceWorker наследует свойства {{domxref("Worker")}}.

+ +
+
{{domxref("ServiceWorker.scriptURL")}} {{readonlyinline}}
+
URL кода для данного Service Worker. URL должен находиться в том же домене, что и документ, регистрирующий ServiceWorker.
+
{{domxref("ServiceWorker.state")}} {{readonlyinline}}
+
Состояние данного Service Worker. Может иметь следующие значения: installing, installed, activating, activated или redundant.
+
+ +

Обработчики событий

+ +
+
{{domxref("ServiceWorker.onstatechange")}} {{readonlyinline}}
+
Срабатывает при срабатывании события statechange; По сути, срабатывает при каждом изменении {{domxref("ServiceWorker.state")}}.
+
+ +

Методы

+ +

Интерфейс ServiceWorker наследует все методы интерфейса {{domxref("Worker")}}, кроме {{domxref("Worker.terminate")}}, который не должен быть доступен для Service Worker.

+ +

Примеры

+ +

Этот фрагмент кода из примера событий Service Worker (демо). Данный код возвращает значение {{domxref("ServiceWorker.state")}} при каждом изменении состояния.

+ +
if ('serviceWorker' in navigator) {
+    navigator.serviceWorker.register('service-worker.js', {
+        scope: './'
+    }).then(function (registration) {
+        var serviceWorker;
+        if (registration.installing) {
+            serviceWorker = registration.installing;
+            document.querySelector('#kind').textContent = 'installing';
+        } else if (registration.waiting) {
+            serviceWorker = registration.waiting;
+            document.querySelector('#kind').textContent = 'waiting';
+        } else if (registration.active) {
+            serviceWorker = registration.active;
+            document.querySelector('#kind').textContent = 'active';
+        }
+        if (serviceWorker) {
+            // logState(serviceWorker.state);
+            serviceWorker.addEventListener('statechange', function (e) {
+                // logState(e.target.state);
+            });
+        }
+    }).catch (function (error) {
+        // Произошла ошибка при регистрации Service Worker.
+        // Файл service-worker.js может быть недоступным или содержать ошибки синтаксиса.
+    });
+} else {
+    // Данный браузер не поддерживает Service Worker.
+}
+ +

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

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарии
{{SpecName('Service Workers', '#serviceworker', 'ServiceWorker')}}{{Spec2('Service Workers')}}Изначальное определение.
+ +

Поддержка

+ +
+ + +

{{Compat("api.ServiceWorker")}}

+
+ +

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

+ + diff --git a/files/ru/web/api/serviceworker/onstatechange/index.html b/files/ru/web/api/serviceworker/onstatechange/index.html new file mode 100644 index 0000000000..4a02488880 --- /dev/null +++ b/files/ru/web/api/serviceworker/onstatechange/index.html @@ -0,0 +1,73 @@ +--- +title: ServiceWorker.onstatechange +slug: Web/API/ServiceWorker/onstatechange +translation_of: Web/API/ServiceWorker/onstatechange +--- +
{{APIRef("Service Workers API")}}
+ +

Обработчик события, вызываемый при срабатывании события statechange; по сути, срабатывает при изменении {{domxref("ServiceWorker.state")}}.

+ +

Синтаксис

+ +
ServiceWorker.onstatechange = function(statechangeevent) { ... }
+ServiceWorker.addEventListener('statechange', function(statechangeevent) { ... } )
+ +

Примеры

+ +

Данный фрагмент кода из примера событий service worker (демо) возвращает состояние при каждом его изменении.

+ +
var serviceWorker;
+if (registration.installing) {
+  serviceWorker = registration.installing;
+  document.querySelector('#kind').textContent = 'installing';
+} else if (registration.waiting) {
+  serviceWorker = registration.waiting;
+  document.querySelector('#kind').textContent = 'waiting';
+} else if (registration.active) {
+  serviceWorker = registration.active;
+  document.querySelector('#kind').textContent = 'active';
+}
+
+if (serviceWorker) {
+  logState(serviceWorker.state);
+  serviceWorker.addEventListener('statechange', function(e) {
+  logState(e.target.state);
+  });
+}
+ +

Обратите внимание, что при срабатывании statechange, ссылки на service worker могли измениться. Например:

+ +
navigator.serviceWorker.register(..).then(function(swr) {
+  swr.installing.state == "installing"
+  swr.installing.onstatechange = function() {
+    swr.installing == null;
+    // At this point, swr.waiting OR swr.active might be true. This is because the statechange
+    // event gets queued, meanwhile the underlying worker may have gone into the waiting
+    // state and will be immediately activated if possible.
+  }
+})
+ +

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

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарии
{{SpecName('Service Workers', '#dom-serviceworker-onstatechange', 'ServiceWorker.onstatechange')}}{{Spec2('Service Workers')}}Изначальное определение
+ +

Совместимость

+ +
+ + +

{{Compat("api.ServiceWorker.onstatechange")}}

+
diff --git a/files/ru/web/api/serviceworker/scripturl/index.html b/files/ru/web/api/serviceworker/scripturl/index.html new file mode 100644 index 0000000000..c01cb6c968 --- /dev/null +++ b/files/ru/web/api/serviceworker/scripturl/index.html @@ -0,0 +1,46 @@ +--- +title: ServiceWorker.scriptURL +slug: Web/API/ServiceWorker/scriptURL +translation_of: Web/API/ServiceWorker/scriptURL +--- +
{{APIRef("Service Workers API")}}
+ +

Возвращает URL, указывающий на скрипт данного Service Worker, определенный с помощью ServiceWorkerRegistration. URL должен находиться в том же домене, что и документ, регистрирующий ServiceWorker.

+ +

Синтаксис

+ +
someURL = ServiceWorker.scriptURL
+
+ +

Значение

+ +

{{domxref("USVString")}} (см. WebIDL-определение USVString.)

+ +

Примеры

+ +
TBD
+ +

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

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('Service Workers', '#service-worker-url', 'scriptURL')}}{{Spec2('Service Workers')}}Изначальное определение
+ +

Поддержка в браузерах

+ +
+ + +

{{Compat("api.ServiceWorker.scriptURL")}}

+
diff --git a/files/ru/web/api/serviceworker/state/index.html b/files/ru/web/api/serviceworker/state/index.html new file mode 100644 index 0000000000..19133ae4c1 --- /dev/null +++ b/files/ru/web/api/serviceworker/state/index.html @@ -0,0 +1,65 @@ +--- +title: ServiceWorker.state +slug: Web/API/ServiceWorker/state +translation_of: Web/API/ServiceWorker/state +--- +
{{APIRef("Service Workers API")}}
+ +

Свойство интерфейса {{domxref("ServiceWorker")}} state, доступное только для чтения является строкой, показывающей текущее состояние данного Service Worker. Его возможные значения: installing, installed, activating, activated и redundant.

+ +

Синтаксис

+ +
someURL = ServiceWorker.state
+
+ +

Значение

+ +

Определение {{domxref("ServiceWorkerState")}} (см. спецификацию)

+ +

Примеры

+ +

Это фрагмент кода из примера событий Service Worker (демо). Данный код возвращает значение ServiceWorker.state при каждом изменении состояния.

+ +
var serviceWorker;
+if (registration.installing) {
+  serviceWorker = registration.installing;
+  document.querySelector('#kind').textContent = 'installing';
+} else if (registration.waiting) {
+  serviceWorker = registration.waiting;
+  document.querySelector('#kind').textContent = 'waiting';
+} else if (registration.active) {
+  serviceWorker = registration.active;
+  document.querySelector('#kind').textContent = 'active';
+}
+
+if (serviceWorker) {
+  logState(serviceWorker.state);
+  serviceWorker.addEventListener('statechange', function(e) {
+  logState(e.target.state);
+  });
+}
+ +

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

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('Service Workers', '#service-worker-state', 'state')}}{{Spec2('Service Workers')}}Изначальное определение
+ +

Поддержка в браузерах

+ +
+ + +

{{Compat("api.ServiceWorker.state")}}

+
-- cgit v1.2.3-54-g00ecf