This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Clients

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨апрель 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

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

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