getIncludedService method

Future<WebBluetoothRemoteGATTService> getIncludedService(String serviceUUID)

Get an included service from this service.

This function doesn't exist if the current service has no included services. Check hasGetIncludedServiceFunction to make sure.

serviceUUID is the UUID (lower case) of the service to get.

• May throw NativeAPINotImplementedError if the function does not exist.

• May throw SecurityError if the service's UUID is on a blocklist.

• May throw NetworkError if the GATT server is not connected.

• May throw InvalidStateError if service is null.

• May throw NotFoundError if the service was not found.

NOTE: Some services are on a block list, and are thus not available. The complete blocklist can be found here: https://github.com/WebBluetoothCG/registries/blob/master/gatt_blocklist.txt

See:

• hasGetIncludedServiceFunction

ignore: deprecated_member_use_from_same_package

• getIncludedServices

• https://webbluetoothcg.github.io/web-bluetooth/#dom-bluetoothremotegattservice-getincludedservice

Implementation

Future<WebBluetoothRemoteGATTService> getIncludedService(
    final String serviceUUID) async {
  if (!hasGetIncludedServiceFunction()) {
    throw NativeAPINotImplementedError("getIncludedService");
  }
  final promise = _JSUtil.callMethod(
      _jsObject, "getIncludedService", [serviceUUID.toLowerCase()]);
  final result = await _JSUtil.promiseToFuture(promise);
  return WebBluetoothRemoteGATTService.fromJSObject(result, device);
}