Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

BluetoothRemoteGATTServer

This article needs a technical review. How you can help.

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.connected Read only
A boolean value that returns rue while this script execution environment is connected to this.device. It can be false while the user agent is physically connected.
BluetoothRemoteGATTServer.device Read only
A reference to the BluetoothDevice running 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 BluetoothGATTService offered by the bluetooth device for a specified BluetoothServiceUUID.
BluetoothRemoteGATTServer.getPrimaryServices()
Returns a promise to a list of primary BluetoothGATTService objects offered by the bluetooth device for a specified BluetoothServiceUUID.

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.

Document Tags and Contributors

 Contributors to this page: jpmedley, rolfedh
 Last updated by: jpmedley,