Clients

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Интерфейс Clients Service Workers API представляет собой контейнер со списком объектов Client.

Методы

Clients.get()

Получает клиента сервис воркера, соответствующего данному id, и возвращает его в Promise.

Clients.matchAll()

Получает список клиентов сервис воркера и возвращает их в Promise. Включает параметр options для возврата всех клиентов сервис воркера, чьи источники являются теми же источниками, что и у связанного источника сервис воркера. Если options не включены, метод возвращает только тех клиентов сервис воркера, которых тот контролирует.

Clients.openWindow()

Открывает Client сервис воркера в новом окне браузера.

Clients.claim()

Позволяет активному Сервис Воркеру установить себя, как активного воркера для клиентской страницы, когда воркер и страница находятся в одной области.

Примеры

js
clients.matchAll(options).then(function (clients) {
  for (i = 0; i < clients.length; i++) {
    if (clients[i] === "index.html") {
      clients.openWindow(clients[i]);
      // или сделать что-то другое, с учётом подошедшего клиента
    }
  }
});

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

Specification
Service Workers
# clients-interface

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

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