Bluetooth

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Объект Bluetooth интерфейса Web Bluetooth API возвращает объект Promise объекту BluetoothDevice с указанными параметрами.

Интерфейс

interface Bluetooth : EventTarget {
  [SecureContext] Promise<boolean> getAvailability();
  [SecureContext] attribute EventHandler onavailabilitychanged;
  [SecureContext, SameObject] readonly attribute BluetoothDevice? referringDevice;
  [SecureContext] Promise<BluetoothDevice> requestDevice(optional RequestDeviceOptions options);
};
Bluetooth implements BluetoothDeviceEventHandlers;
Bluetooth implements CharacteristicEventHandlers;
Bluetooth implements ServiceEventHandlers;

Свойства

Наследует свойства от родителя EventTarget.

Bluetooth.referringDevice Только для чтения

Возвращает ссылку на устройство, если таковое имеется, из которого пользователь открыл страницу. Например, Eddystone beacon может найти URL - адрес, который позволяет открыть строка агента адреса. Устройство Bluetooth предоставляет маяк, который будет доступен через navigator.bluetooth.referringDevice.

События

Bluetooth.onavailabilitychanged

Обработчик событий, который запускается при возникновении события availabilitychanged.

Методы

Bluetooth.getAvailability()

Возвращает Promise, который возвращает Boolean, указывая, поддерживает ли браузер Bluetooth. Некоторые браузеры дают возможность управлять возвращаемым значением этого метода.

Bluetooth.requestDevice()

Возвращает Promise объекту BluetoothDevice с переданными параметрами.

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

Specification
Web Bluetooth
# bluetooth

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Bluetooth
Experimental
getAvailability
Experimental
getDevices
Experimental
requestDevice
Experimental
options.exclusionFilters parameter
Experimental
options.filter.manufacturerData parameter
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.