This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.
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.
Interface
interface BluetoothRemoteGATTService : ServiceEventHandlers { readonly attribute UUID uuid; readonly attribute boolean isPrimary; readonly attribute BluetoothDevice device; Promise<BluetoothGATTCharacteristic> getCharacteristic(BluetoothCharacteristicUUID characteristic); Promise<sequence<BluetoothGATTCharacteristic>> getCharacteristics(optional BluetoothCharacteristicUUID characteristic); Promise<BluetoothGATTService> getIncludedService(BluetoothServiceUUID service); Promise<sequence<BluetoothGATTService>> getIncludedServices(optional BluetoothServiceUUID service); };
Properties
BluetoothRemoteGATTService.device
Read only- Returns information about a Bluetooth device through an instance of
BluetoothDevice
. BluetoothRemoteGATTService.isPrimary
Read only- Returns a
Boolean
Indicating whether this is a primary or secondary service. BluetoothRemoteGATTService.uuid
Read only- Returns a
DOMString
representing the UUID of this service.
Methods
BluetoothRemoteGATTService.getCharacteristic()
- Returns a
Promise
to an instance ofBluetoothGATTCharacteristic
for a given universally unique identifier (UUID). BluetoothRemoteGATTService.getCharacteristics()
- Returns a
Promise
to anArray
ofBluetoothGATTCharacteristic
instances for an optional universally unique identifier (UUID). BluetoothRemoteGATTService.getIncludedService()
- Returns a
Promise
to an instance ofBluetoothRemoteGATTService
for a given universally unique identifier (UUID). BluetoothRemoteGATTService.getIncludedServices()
- Returns a
Promise
to anArray
ofBluetoothRemoteGATTService
instances for an optional universally unique identifier (UUID).
Specifications
Specification | Status | Comment |
Web BluetoothThe definition of 'BluetoothRemoteGATTService' in that specification. | Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome Full support 56 Full support 56 Notes' macOS only. Full support 56 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 56: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 43 Full support 43 Notes' macOS only. Full support 43 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 43: this feature is behind the Notes' Windows 10. |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 56 |
Firefox Android
No support No |
Opera Android
Full support 43 |
Safari iOS
No support No |
Samsung Internet Android
Full support 6.0 |
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera Full support 43 Full support 43 Notes' macOS only. Full support 43 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 43: this feature is behind the Notes' Windows 10. |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
Full support 43 |
Safari iOS
No support No |
Samsung Internet Android
No support No | |
Chrome Full support 56 Full support 56 Notes' macOS only. Full support 56 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 56: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 43 Full support 43 Notes' macOS only. Full support 43 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 43: this feature is behind the Notes' Windows 10. |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 56 |
Firefox Android
No support No |
Opera Android
Full support 43 |
Safari iOS
No support No |
Samsung Internet Android
Full support 6.0 | |
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
No support No | |
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
No support No | |
Chrome Full support 56 Full support 56 Notes' macOS only. Full support 56 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 56: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 43 Full support 43 Notes' macOS only. Full support 43 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 43: this feature is behind the Notes' Windows 10. |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 56 |
Firefox Android
No support No |
Opera Android
Full support 43 |
Safari iOS
No support No |
Samsung Internet Android
Full support 6.0 | |
Chrome
No support No |
Edge
No support No |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
No support No |
WebView Android
No support No |
Chrome Android
No support No |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
No support No |
Samsung Internet Android
No support No | |
Chrome Full support 56 Full support 56 Notes' macOS only. Full support 56 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 56: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 43 Full support 43 Notes' macOS only. Full support 43 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 43: this feature is behind the Notes' Windows 10. |
Safari
No support No |
WebView Android
No support No |
Chrome Android
Full support 56 |
Firefox Android
No support No |
Opera Android
Full support 43 |
Safari iOS
No support No |
Samsung Internet Android
Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.'
- Experimental. Expect behavior to change in the future.
- See implementation notes.'
- See implementation notes.
- User must explicitly enable this feature.'
- User must explicitly enable this feature.
BluetoothRemoteGATTService by Mozilla Contributors is licensed under CC-BY-SA 2.5.