Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The BluetoothRemoteGATTServer interface of the Web Bluetooth API represents a GATT Server on a remote device.
This page describes the W3C Community Group Web Bluetooth API. For the Firefox OS Bluetooth API, see BluetoothGattService.
Interface
interface BluetoothRemoteGATTServer {
readonly attribute BluetoothDevice device;
readonly attribute boolean connected;
Promise<BluetoothRemoteGATTServer> connect();
void disconnect();
Promise<BluetoothRemoteGATTService> getPrimaryService(BluetoothServiceUUID service);
Promise<sequence<BluetoothRemoteGATTService>> getPrimaryServices(optional BluetoothServiceUUID service);
};
Properties
BluetoothRemoteGATTServer.connectedRead only- A boolean value that returns true while this script execution environment is connected to
this.device. It can be false while the user agent is physically connected. BluetoothRemoteGATTServer.deviceRead only- A reference to the
BluetoothDevicerunning the server.
Methods
BluetoothRemoteGATTServer.connect()- Causes the script execution environment to connect to
this.device. BluetoothRemoteGATTServer.disconnect()- Causes the script execution environment to disconnect from
this.device. BluetoothRemoteGATTServer.getPrimaryService()- Returns a promise to the primary
BluetoothGATTServiceoffered by the bluetooth device for a specifiedBluetoothServiceUUID. BluetoothRemoteGATTServer.getPrimaryServices()- Returns a promise to a list of primary
BluetoothGATTServiceobjects offered by the bluetooth device for a specifiedBluetoothServiceUUID.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Web Bluetooth | Draft | Initial definition. |
Browser Compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 45.0 [1] 52.0 [2] |
? | ? | ? | ? |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| Basic support | No support | No support | ? | ? | ? | ? | ? | 52.0 [2] |
[1] Behind a flag. Chrome OS only.
[2] Chrome origin trials only.