BluetoothRemoteGATTServer

Experimental

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

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 BluetoothGattServer (Firefox OS).

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 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 BluetoothRemoteGATTService offered by the bluetooth device for a specified BluetoothServiceUUID.
BluetoothRemoteGATTServer.getPrimaryServices()
Returns a promise to a list of primary BluetoothRemoteGATTService objects offered by the bluetooth device for a specified BluetoothServiceUUID.

Specifications

Specification
Web Bluetooth
# bluetoothgattremoteserver-interface

Browser compatibility

BCD tables only load in the browser