This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The Bluetooth interface of the Web Bluetooth API returns a Promise to a BluetoothDevice object with the specified options.

Interface

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;

Properties

Inherits properties from its parent EventTarget.

Bluetooth.referringDevice Read only  
Returns a reference to the device, if any, from which the user opened the current page. For example, an Eddystone beacon might advertise a URL, which the user agent allows the user to open. A BluetoothDevice representing the beacon would be available through navigator.bluetooth.referringDevice.

Events

Bluetooth.onavailabilitychanged
An event handler that runs when an event of type availabilitychanged has fired.

Methods

Bluetooth.getAvailability()
Returns a Promise that resolved to a Boolean indicating whether the user-agent has the ability to support Bluetooth. Some user-agents let the user configure an option that affects what is returned by this value. If this option is set, that is the value returned by this method.
Bluetooth.requestDevice()
Returns a Promise to a BluetoothDevice object with the specified options.

Specifications

Specification Status Comment
Web Bluetooth
The definition of 'Bluetooth' in that specification.
Draft Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support56 ? ? ?43 ?
requestDevice56 ? ? ?43 ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No56 ? ?43 ? ?
requestDevice No56 ? ?43 ? ?

Document Tags and Contributors

Contributors to this page: ExE-Boss, fscholz, jpmedley, Alhadis, rolfedh
Last updated by: ExE-Boss,