Запрос отображения: метод getAvailability()
Ограниченная доступность
Эта функция не относится к базовому уровню, так как она не работает в некоторых из наиболее широко используемых браузеров.
Экспериментальная функция: Это экспериментальная технология
Перед использованием в продакшене тщательно ознакомьтесь с таблицей совместимости браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
При вызове метода getAvailability() пользовательский агент ОБЯЗАН выполнить следующие шаги:
- Входные данные
-
presentationUrls, список URL-адресов запроса отображения
- Выходные данные
-
P, Promise
-
Если выполняется одно из следующих условий:
- Результат выполнения алгоритма проверки смешанных контекстов безопасности для объекта настроек документа settings object равен
"Prohibits Mixed Security Contexts"и presentationUrl является URL-адресом, не прошедшим априорную аутентификацию. - В наборе активных флагов для контекста активного сандбоксинга установлен флаг sandboxed presentation browsing context.
Выполнить следующие подшаги:
- Возвратить Promise, отклоненный с
SecurityErrorDOMException. - Прервать эти шаги.
- Результат выполнения алгоритма проверки смешанных контекстов безопасности для объекта настроек документа settings object равен
-
Пусть P будет новым Promise.
-
Возвратить P, но продолжить выполнение этих шагов параллельно.
-
Если пользовательский агент не может отслеживать список доступных дисплеев отображения в течение всего времени действия контролируемого контекста браузера (например, из-за того, что пользователь отключил эту функцию), то:
-
Выполнить разрешение P с новым
PresentationAvailabilityобъектом, у которого свойствоvalueустановлено вfalse. - Прервать все оставшиеся шаги.
-
Выполнить разрешение P с новым
-
Если пользовательский агент не может непрерывно отслеживать список доступных дисплеев отображения, но может найти дисплеи отображения для начала подключения, то:
-
Отклонить P с
NotSupportedErrorDOMException. - Прервать все оставшиеся шаги.
-
Отклонить P с
-
Если существует кортеж (A, presentationUrls) в наборе объектов доступности, то:
- Выполнить разрешение P со значением A.
- Прервать все оставшиеся шаги.
-
Пусть A будет новым
PresentationAvailabilityобъектом, у которого свойствоvalueустановлено следующим образом:-
falseесли список доступных дисплеев отображения пуст. -
trueесли существует хотя бы один совместимый дисплей отображения для некоторого элемента в presentationUrls. Это означает, что в списке доступных дисплеев отображения имеется запись (presentationUrl, display) для некоторого presentationUrl в presentationUrls. -
falseв противном случае.
-
-
Создать кортеж (A, presentationUrls) и добавить его в набор объектов доступности.
-
Выполнить алгоритм отслеживания списка доступных дисплеев отображения.
-
Выполнить разрешение P со значением A.
Спецификации
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getAvailability |
47 | 79 | Нет | 34 | Нет | 47 | Нет | 34 | Нет | 5.0 | Нет |
© 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/PresentationRequest/getAvailability