BluetoothDeviceEvent (Firefox OS)

This API is available on Firefox OS for internal applications only.

The BluetoothDeviceEvent interface of the Web Bluetooth API provides access to a found/paired device (BluetoothDevice) object or the address or an unpaired device as the parameter of a devicefounddevicepaired or deviceunpaired event handler (see BluetoothDiscoveryHandle.ondevicefound, BluetoothAdapter.ondevicepaired, and BluetoothAdapter.ondeviceunpaired), when fired.

Interface overview

JavaScript
[CheckPermissions="bluetooth"]
interface BluetoothDeviceEvent : Event
{
  readonly attribute <a href="https://wiki.mozilla.org/B2G/Bluetooth/WebBluetooth-v2/BluetoothDevice#BluetoothDevice" class="external" title="B2G/Bluetooth/WebBluetooth-v2/BluetoothDevice">BluetoothDevice</a>? <a href="https://wiki.mozilla.org/B2G/Bluetooth/WebBluetooth-v2/BluetoothDeviceEvent#device" class="external" title="B2G/Bluetooth/WebBluetooth-v2/BluetoothDeviceEvent">device</a>;
  readonly attribute DOMString? <a href="https://wiki.mozilla.org/B2G/Bluetooth/WebBluetooth-v2/BluetoothDeviceEvent#address" class="external" title="B2G/Bluetooth/WebBluetooth-v2/BluetoothDeviceEvent">address</a>;
};

Properties

BluetoothDeviceEvent.device Read only
Returns a BluetoothDevice object representing the paired remote device. Returns null for the BluetoothAdapter.ondeviceunpaired event handler since the that only requires the address of the unpaired device.
BluetoothDeviceEvent.address Read only
Returns a DOMString representing the address of the unpaired remote device. Returns null for the BluetoothDiscoveryHandle.ondevicefound and BluetoothAdapter.ondevicepaired event handlers since a found/paired remote device already has an BluetoothDevice.address property.

Methods

None.

Specifications

Specification Status Comment
Web Bluetooth
The definition of 'BluetoothDeviceEvent' in that specification.
Draft Rough draft; not part of any official specification yet. It should be discussed as part of the W3C's System Applications Working Group.

Browser Compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support No support No support No support No support
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support No support 2.1 No support No support No support No support

 

See also

Using the Web Bluetooth API

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/bluetoothdeviceevent

API B2G Bluetooth BluetoothDeviceEvent Certified Firefox OS Interface Non-standard Reference Référence Web Bluetooth WebAPI