BluetoothRemoteGATTService

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

Note: This page describes the W3C Community Group BluetoothRemoteGATTService, formerly called BluethoothGATTService. For the Firefox OS interface of the same name, see BluetoothGattService.

The BluetoothRemoteGATTService interface of the Web Bluetooth API represents a service provided by a GATT server, including a device, a list of referenced services, and a list of the characteristics of this service.

Properties

BluetoothRemoteGATTService.deviceRead only

Returns information about a Bluetooth device through an instance of BluetoothDevice.

BluetoothRemoteGATTService.isPrimaryRead only

Returns a boolean value indicating whether this is a primary or secondary service.

BluetoothRemoteGATTService.uuidRead only

Returns a DOMString representing the UUID of this service.

Methods

BluetoothRemoteGATTService.getCharacteristic()

Returns a Promise to an instance of BluetoothRemoteGATTCharacteristic for a given universally unique identifier (UUID).

BluetoothRemoteGATTService.getCharacteristics()

Returns a Promise to an Array of BluetoothRemoteGATTCharacteristic instances for an optional universally unique identifier (UUID).

Specifications

Specification
Web Bluetooth
# bluetoothgattservice-interface

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
BluetoothRemoteGATTService
56
Before Chrome 70, this feature was only supported in macOS. In Chrome 70, support was added for Windows 10. Linux support is not enabled by default.
56
In Linux and versions of Windows earlier than 10, this flag must be enabled.
79
Supported by default only on macOS and Windows 10. Linux support is not enabled by default.
79
In Linux and versions of Windows earlier than 10, this flag must be enabled.
No
No
43
Before Opera 57, this feature was only supported in macOS. In Opera 57, support was added for Windows 10. Linux support is not enabled by default.
43
In Linux and versions of Windows earlier than 10, this flag must be enabled.
No
No
56
No
43
No
6.0
device
56
79
No
No
43
No
No
56
No
43
No
6.0
getCharacteristic
56
79
No
No
43
No
No
56
No
43
No
6.0
getCharacteristics
56
79
No
No
43
No
No
56
No
43
No
6.0
isPrimary
56
79
No
No
43
No
No
56
No
43
No
6.0
uuid
56
79
No
No
43
No
No
56
No
43
No
6.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BluetoothRemoteGATTService