@kvaser/canking-api/doc_md/hooks/functions/useSignalData.md

CanKing API to communicate with the CanKing service using Node.js.

[**Kvaser CanKing GUI Extensions SDK v7.5.1**](../../README.md)

***

[Kvaser CanKing GUI Extensions SDK](../../modules.md) / [hooks](../README.md) / useSignalData

# Function: useSignalData()

> **useSignalData**(`id`, `subscriptionName`, `subscribedSignals`): [`ISignalData`](../interfaces/ISignalData.md)[]

A hook for extracting signal data from the measurement context.

## Parameters

### id

`number`

The unique id of the view.

### subscriptionName

`string`

The subscription name for the data. Must be unique per view.

### subscribedSignals

`object`[]

The signals to extract data for. To avoid unnecessary re-renders, memoize this object.

## Returns

[`ISignalData`](../interfaces/ISignalData.md)[]

The extracted signal data. If an empty array is returned, all previously received data is invalid and should be discarded.

## Remarks

This hook buffers incoming frame data during initialization (before frame keys and historical data are ready)
and merges it with historical data once available.