Bluetooth: метод getAvailability()
Ограниченная доступность
Эта функция не является Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Экспериментальная: Это экспериментальная технология
Перед использованием в производстве внимательно изучите таблицу совместимости с браузерами.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
Метод getAvailability() интерфейса Bluetooth формально возвращает true, если пользовательский агент может поддерживать Bluetooth (потому что у устройства есть адаптер Bluetooth), и false в противном случае.
Слово «формально» используется, потому что если разрешение на использование API Web Bluetooth запрещено разрешением Permissions-Policy: bluetooth, метод всегда будет возвращать false. Кроме того, пользователь может настроить свой браузер на возврат false от вызова getAvailability() даже если в браузере есть рабочий адаптер Bluetooth, и наоборот. Это значение настройки игнорируется, если доступ заблокирован разрешением.
Даже если getAvailability() возвращает true и у устройства фактически есть адаптер Bluetooth, это не обязательно означает, что вызов navigator.bluetooth.requestDevice() завершится с BluetoothDevice. Адаптер Bluetooth может быть выключен, и пользователь может запретить использование API при запросе.
Синтаксис
getAvailability()
Параметры
Нет.
Возвращаемое значение
A Promise, который разрешается значением Boolean.
Promise будет разрешен значением false, если доступ запрещен Permissions-Policy: bluetooth, если пользователь настроил браузер на всегда разрешение false, или если у устройства нет адаптера Bluetooth. В противном случае он будет разрешен значением true.
Исключения
Нет.
Примеры
Следующий фрагмент выводит сообщение в консоль, указывающее, поддерживает ли устройство Bluetooth:
navigator.bluetooth.getAvailability().then((available) => {
if (available) {
console.log("This device supports Bluetooth!");
} else {
console.log("Doh! Bluetooth is not supported");
}
});
Спецификации
| Спецификация |
|---|
| Web Bluetooth # dom-bluetooth-getavailability |
Совместимость с браузерами
| Рабочие столы | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
getAvailability |
78 | 79 | Нет | 65 | Нет | 78 | Нет | 56 | Нет | 12.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/Bluetooth/getAvailability