BluetoothRemoteGATTServer: getPrimaryService() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The BluetoothRemoteGATTServer.getPrimaryService() method returns a promise to the primary BluetoothRemoteGATTService offered by the Bluetooth device for a specified bluetooth service UUID.

Syntax

js
getPrimaryService(bluetoothServiceUUID)

Parameters

bluetoothServiceUUID

A Bluetooth service universally unique identifier for a specified device, that is either a 128-bit UUID, a 16-bit or 32-bit UUID alias, or a string from the list of GATT assigned services keys.

Return value

A Promise that resolves to a BluetoothRemoteGATTService object.

Specifications

Specification
Web Bluetooth
# dom-bluetoothremotegattserver-getprimaryservice

Browser compatibility

BCD tables only load in the browser