---
title: Node.js Device Readiness
description: Check device readiness for the configured metrics and camera, and handle the result.
---

> SmartSpectra SDK developer docs for v3.5.0, the latest stable release. Web page: https://presagetech.com/docs/smartspectra-sdk/nodejs/device-readiness
> Index of all pages: https://presagetech.com/docs/smartspectra-sdk/llms.txt

# Node.js Device Readiness

> **Important:** SDK metrics are offered for general wellness and informational purposes only. SDK metrics have not been cleared by the FDA and may not be used for medical diagnosis or treatment.

Configure the SDK's authentication, metrics, and camera, then check readiness
before starting a measurement:

```javascript
const result = await sdk.checkDeviceReadiness();
```

Use `result.verdict` for application decisions and `result.reason` for the
explanation and recommended next step. Keep the returned result if you need it later.

Compare the verdict explicitly, for example `result.verdict === 'ready'`.
Every verdict string is truthy, including `'blocked'`.

See [Device Readiness](../../docs/device-readiness.md) for
verdict meanings, supported inputs, and result handling.

## Telemetry

Telemetry is on by default. When it is enabled, each check sends its full
diagnostic report to Presage: device and SDK details, requested metrics and camera
settings, performance measurements, and free-text diagnostic messages. The report
never includes video frames or vital signs.

To turn it off, pass `enableTelemetry: false` when creating the SDK:

```javascript
const sdk = new SmartSpectraSDK({
  // ...authentication and metrics...
  enableTelemetry: false,
});
```

See [SDK Telemetry & Privacy](../../docs/telemetry-and-privacy.md) for the full
report contents, storage, and retention.

## When a measurement stops for low frame rate

When the frame rate stays too low to measure reliably during a measurement, the
session ends and the `'error'` event receives
`SmartSpectraErrorCode.kSustainedLowFrameRate` (14) instead of
`SmartSpectraErrorCode.kProcessingFailed`. The message is "SmartSpectra stopped
because the frame rate stayed too low to measure reliably." A frame submitted as
the session ends is rejected with the same code. `retryable` is `false` when the
SDK plays a video file, because the same file stops the same way; it is `true` for
cameras and custom input:
the host may offer a user-initiated fresh start; do not restart automatically.
To check whether a device can sustain measurement before starting, call
`checkDeviceReadiness()`.

The SDK measures frame rate from frame timestamps: the timestamp file when one is
given, otherwise the video's playback position. The interframe delay
(`interframeDelayMs`) changes playback speed, not the measured frame rate.
