Клиенты: метод matchAll()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с апреля 2018 года.

Примечание: Эта функция доступна только в работе с сервисами.

Метод matchAll() интерфейса Clients возвращает Promise для списка объектов Client работы с сервисами. Включите параметр options для возвращения всех клиентов работы с сервисами, чей источник совпадает с источником связанного сервиса. Если опции не указаны, метод возвращает только клиентов работы с сервисами, контролируемые сервисом.

Синтаксис

matchAll()
matchAll(options)

Параметры

options Необязательно

Объект опций, позволяющий задать параметры для операции сопоставления. Доступные параметры:

includeUncontrolled: Булевое значение — если установлено в true, операция сопоставления вернет всех клиентов работы с сервисами, которые имеют тот же источник, что и текущий сервис. В противном случае, возвращаются только клиенты работы с сервисами, контролируемые текущим сервисом. По умолчанию false.
type: Устанавливает тип клиентов, которые должны быть сопоставлены. Доступные значения: "window", "worker", "sharedworker", и "all". По умолчанию "window".

Возвращаемое значение

A Promise, который разрешается до массива объектов Client. В Chrome 46/Firefox 54 и более поздних версиях этот метод возвращает клиентов в порядке, последнего фокуса, как указано в спецификации.

Примеры

clients.matchAll(options).then((clientList) => {
  for (const client of clientList) {
    if (client.url === "index.html") {
      clients.openWindow(client);
      // or do something else involving the matching client
    }
  }
});

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

Спецификация
Сервисы # clients-matchall

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

	Рабочий стол					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`matchAll`	42 `Client` объекты возвращаются в порядке последнего фокуса.	17 `Client` объекты возвращаются в порядке последнего фокуса.	54 44–54 До Firefox 54, `Client` объекты не возвращались в порядке последнего фокуса, как требуется спецификацией.	29	11.1	42 `Client` объекты возвращаются в порядке последнего фокуса.	54 44–54 До Firefox для Android 54, `Client` объекты не возвращались в порядке последнего фокуса, как требуется спецификацией.	29	11.3	4.0 `Client` объекты возвращаются в порядке последнего фокуса.	42 `Client` объекты возвращаются в порядке последнего фокуса.
`options_includeUncontrolled_parameter`	42 `Client` объекты возвращаются в порядке последнего фокуса.	17 `Client` объекты возвращаются в порядке последнего фокуса.	44	38	11.1	42 `Client` объекты возвращаются в порядке последнего фокуса.	44	41	11.3	4.0 `Client` объекты возвращаются в порядке последнего фокуса.	42 `Client` объекты возвращаются в порядке последнего фокуса.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Clients/matchAll