BluetoothDevice

{{APIRef("Bluetooth API")}}{{SeeCompatTable}}{{SecureContext_Header}}

The BluetoothDevice interface of the Web Bluetooth API represents a Bluetooth device inside a particular script execution environment.

{{InheritanceDiagram}}

Instance properties

• {{DOMxRef("BluetoothDevice.id")}} {{Experimental_Inline}} {{ReadOnlyInline}}
  • : A string that uniquely identifies a device.
• {{DOMxRef("BluetoothDevice.name")}} {{Experimental_Inline}} {{ReadOnlyInline}}
  • : A string that provides a human-readable name for the device.
• {{DOMxRef("BluetoothDevice.gatt")}} {{Experimental_Inline}} {{ReadOnlyInline}}
  • : A reference to the device's {{DOMxRef("BluetoothRemoteGATTServer")}}.

Instance methods

• {{DOMxRef("BluetoothDevice.watchAdvertisements()")}} {{Experimental_Inline}}
  • : A {{jsxref("Promise")}} that resolves to undefined or is rejected with an error if advertisements can't be shown for any reason.
• {{DOMxRef("BluetoothDevice.forget()")}} {{Experimental_Inline}}
  • : Provides a way for the page to revoke access to a device the user has granted access to.

Events

Listen to these events using {{domxref("EventTarget.addEventListener", "addEventListener()")}} or by assigning an event listener to the oneventname property of this interface.

• {{DOMxRef("BluetoothDevice/gattserverdisconnected_event", "gattserverdisconnected")}} {{experimental_inline}}
  • : Fired on a device when an active GATT connection is lost.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}