Skip to main content

SyncStatus

Constructors​

new SyncStatus()​

new SyncStatus(options): SyncStatus

Parameters​

ParameterType
optionsSyncStatusOptions

Returns​

SyncStatus

Accessors​

connected​

Get Signature​

get connected(): boolean

Indicates if the client is currently connected to the PowerSync service.

Returns​

boolean

True if connected, false otherwise. Defaults to false if not specified.

connecting​

Get Signature​

get connecting(): boolean

Indicates if the client is in the process of establishing a connection to the PowerSync service.

Returns​

boolean

True if connecting, false otherwise. Defaults to false if not specified.

dataFlowStatus​

Get Signature​

get dataFlowStatus(): Partial<{
  downloadError: Error;
  downloading: boolean;
  uploadError: Error;
  uploading: boolean;
}>

Provides the current data flow status regarding uploads and downloads.

Returns​

Partial<{ downloadError: Error; downloading: boolean; uploadError: Error; uploading: boolean; }>

An object containing:

  • downloading: True if actively downloading changes (only when connected is also true)
  • uploading: True if actively uploading changes Defaults to {downloading: false, uploading: false} if not specified.

hasSynced​

Get Signature​

get hasSynced(): undefined | boolean

Indicates whether there has been at least one full sync completed since initialization.

Returns​

undefined | boolean

True if at least one sync has completed, false if no sync has completed, or undefined when the state is still being loaded from the database.

lastSyncedAt​

Get Signature​

get lastSyncedAt(): undefined | Date

Time that a last sync has fully completed, if any. This timestamp is reset to null after a restart of the PowerSync service.

Returns​

undefined | Date

The timestamp of the last successful sync, or undefined if no sync has completed.

priorityStatusEntries​

Get Signature​

get priorityStatusEntries(): SyncPriorityStatus[]

Provides sync status information for all bucket priorities, sorted by priority (highest first).

Returns​

SyncPriorityStatus[]

An array of status entries for different sync priority levels, sorted with highest priorities (lower numbers) first.

Methods​

getMessage()​

getMessage(): string

Creates a human-readable string representation of the current sync status. Includes information about connection state, sync completion, and data flow.

Returns​

string

A string representation of the sync status

isEqual()​

isEqual(status): boolean

Compares this SyncStatus instance with another to determine if they are equal. Equality is determined by comparing the serialized JSON representation of both instances.

Parameters​

ParameterTypeDescription
statusSyncStatusThe SyncStatus instance to compare against

Returns​

boolean

True if the instances are considered equal, false otherwise

statusForPriority()​

statusForPriority(priority): SyncPriorityStatus

Reports the sync status (a pair of SyncStatus#hasSynced and SyncStatus#lastSyncedAt fields) for a specific bucket priority level.

When buckets with different priorities are declared, PowerSync may choose to synchronize higher-priority buckets first. When a consistent view over all buckets for all priorities up until the given priority is reached, PowerSync makes data from those buckets available before lower-priority buckets have finished syncing.

This method returns the status for the requested priority or the next higher priority level that has status information available. This is because when PowerSync makes data for a given priority available, all buckets in higher-priorities are guaranteed to be consistent with that checkpoint.

For example, if PowerSync just finished synchronizing buckets in priority level 3, calling this method with a priority of 1 may return information for priority level 3.

Parameters​

ParameterTypeDescription
prioritynumberThe bucket priority for which the status should be reported

Returns​

SyncPriorityStatus

Status information for the requested priority level or the next higher level with available status

toJSON()​

toJSON(): SyncStatusOptions

Serializes the SyncStatus instance to a plain object.

Returns​

SyncStatusOptions

A plain object representation of the sync status