Interface: SubscribeChangesSnapshotOptions<T, TKey>#

Defined in: packages/db/src/types.ts:941

Extends#

• Omit<SubscribeChangesOptions<T, TKey>, "includeInitialState">

Type Parameters#

T#

T extends object = Record<string, unknown>

TKey#

TKey extends string | number = string | number

Properties#

limit?#

optional limit: number;

Defined in: packages/db/src/types.ts:946

Internal

Optional limit to include in loadSubset for query-specific cache keys.

Overrides#

SubscribeChangesOptions.limit

onLoadSubsetError()?#

optional onLoadSubsetError: (event) => void;

Defined in: packages/db/src/types.ts:938

Internal

Receives subset-load failures scoped to this subscription.

Parameters#

event#

SubscriptionLoadSubsetErrorEvent

Returns#

void

Inherited from#

Omit.onLoadSubsetError

onLoadSubsetResult()?#

optional onLoadSubsetResult: (result) => void;

Defined in: packages/db/src/types.ts:936

Internal

Callback that receives the loadSubset result (Promise or true) from requestSnapshot. Allows the caller to directly track the loading promise for isReady status.

Parameters#

result#

true | Promise<void>

Returns#

void

Inherited from#

Omit.onLoadSubsetResult

onStatusChange()?#

optional onStatusChange: (event) => void;

Defined in: packages/db/src/types.ts:920

Internal

Listener for subscription status changes. Registered BEFORE any snapshot is requested, ensuring no status transitions are missed.

Parameters#

event#

SubscriptionStatusChangeEvent

Returns#

void

Inherited from#

Omit.onStatusChange

orderBy?#

optional orderBy: OrderBy;

Defined in: packages/db/src/types.ts:945

Internal

Optional orderBy to include in loadSubset for query-specific cache keys.

Overrides#

SubscribeChangesOptions.orderBy

where()?#

optional where: (row) => any;

Defined in: packages/db/src/types.ts:912

Callback function for filtering changes using a row proxy. The callback receives a proxy object that records property access, allowing you to use query builder functions like eq, gt, etc.

Parameters#

row#

SingleRowRefProxy<WithVirtualProps<T, TKey>>

Returns#

any

Example#

import { eq } from "@tanstack/db"

collection.subscribeChanges(callback, {
  where: (row) => eq(row.status, "active")
})

Inherited from#

Omit.where

whereExpression?#

optional whereExpression: BasicExpression<boolean>;

Defined in: packages/db/src/types.ts:914

Pre-compiled expression for filtering changes

Inherited from#

SubscribeChangesOptions.whereExpression