saveCategoryNoTimeWithData(params: Object)

Requires:
HealthKit≥5.18.0@ray-js/ray≥1.6.17
Platforms:
iOS
import { health } from '@ray-js/ray';

const { saveCategoryNoTimeWithData } = health;

// Promise usage
try {
  const res = await saveCategoryNoTimeWithData({ ...params });
  console.log(res);
} catch (err) {
  console.log(err.errorMsg);
}

Description

Write Category-type health data (no time provided; start and end default to the current time) [iOS only]

Parameters

PropertyTypeRequiredDescription
permissionsstring[]NoPermission types (used by the API for requesting read/write permissions); see the enum list below for values e.g. ["1","2"]
readPermissionsstring[]NoRead permission types (used by the API that checks whether the user has already authorized); see the enum list below for values e.g. ["1","2"]
writePermissionsstring[]NoWrite permission types (used by the API that checks whether the user has already authorized); see the enum list below for values e.g. ["1","2"]
writePermissionnumberNoWrite permission types (used by the API that checks whether write permission is granted); see the enum list below for values
valuenumberNoValue to write (specific measurement for Quantity or Category data)
unitTypestringNoUnit to pass in, e.g., "mg/dL", "g", "cm", "count"; required when querying and writing Quantity-type data. For the unit applicable to each data type, refer to Apple's HKTypeIdentifiers.h.
startTimenumberNoStart time, Unix timestamp in seconds
endTimenumberNoEnd time, Unix timestamp in seconds
typenumberNoData type to read/write (used by read/write APIs); see the enum list below for values
complete() => voidNoCompletion callback (executed on both success and failure)
success() => voidNoCallback on successful API call
fail(params: Object) => voidNoFailure callback
fail callback parameters
PropertyTypeDescription
errorMsgstringError message
errorCodestring | numberError code
Error extension

Return Value

None

Error Code

Error CodeError Message
1AppleHealthParamsError
2AppleHealthNoPermission

Examples

Write sleep analysis data at the current time

import { health } from '@ray-js/ray'

const endTime = Math.floor(Date.now() / 1000);
const startTime = endTime - 60 * 60;

health.saveCategoryNoTimeWithData({
  permissions: ["1"],
  readPermissions: ["1"],
  writePermissions: ["1"],
  writePermission: 1,
  value: 65.5,
  unitType: "count",
  startTime,
  endTime,
  type: 1,
  success: data => {
    console.log(data);
  },
  fail: error => {
    console.error(error);
  },
});