HeliosStorageManager

class

Back to Helios Web API

Kind

class

Source

src/storage/HeliosStorageManager.js:779

Description

Base storage facade for Helios state snapshots, sessions, and portable network state.

Signature

export class HeliosStorageManager extends EventTarget {

Lifecycle

Creation, initialization, prewarming, cleanup, and renderer lifetime.

destroy()

Source: src/storage/HeliosStorageManager.js:3426

Manages destroy for the current instance.

Filtering And State

Graph filtering and interaction state. When active, FilterBehavior and SelectionBehavior coordinate this area.

pendingStateChangeCount()

Source: src/storage/HeliosStorageManager.js:1680

Configures or reads pending state change count.

hasPendingStateChanges()

Source: src/storage/HeliosStorageManager.js:1684

Returns the current pending state changes value or state.

Example

const value = helios.hasPendingStateChanges();

recordPortableState(path, value, options = {})

Source: src/storage/HeliosStorageManager.js:2140

Configures or reads record portable state.

Parameters

Name	Type	Attributes	Default	Description
path				Filesystem path to read from or write to.
value				New record portable state value. Omit this argument to read the current value.
options	Object	optional	{}	Options object for this operation.

restorePortableStateFromNetwork(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3334

Read or set the restore portable state from network setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current restore portable state from network value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.restorePortableStateFromNetwork({
  enabled: true,
});

Network And Persistence

Network replacement, serialization, and visualization state persistence. ExporterBehavior and InterfaceBehavior can surface parts of this flow in the UI.

loadPreferences()

Source: src/storage/HeliosStorageManager.js:1068

Handles preferences for the current graph or visualization state.

markNetworkDirty(reason = 'network-change')

Source: src/storage/HeliosStorageManager.js:1100

Configures or reads mark network dirty.

Parameters

Name	Type	Attributes	Default	Description
reason	string	optional	'network-change'	Reason for this operation.

serializeSnapshot(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2191

Read or set the serialize snapshot setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current serialize snapshot value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.serializeSnapshot({
  enabled: true,
});

serializeSessionSnapshot(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2443

Read or set the serialize session snapshot setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current serialize session snapshot value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.serializeSessionSnapshot({
  enabled: true,
});

saveSessionSnapshot(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2689

Read or set the save session snapshot setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current save session snapshot value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.saveSessionSnapshot({
  enabled: true,
});

restoreSessionSnapshot(snapshot = {}, options = {}) → {this}

Source: src/storage/HeliosStorageManager.js:2753

Updates the session snapshot state on the current instance.

Parameters

Name	Type	Attributes	Default	Description
snapshot		optional	{}	Value passed to restoreSessionSnapshot.
options	Object	optional	{}	Options object for this operation.

Returns

This instance.

Type this

serializeNetworkSnapshot(options = {}) → {Promise<Object>}

Source: src/storage/HeliosStorageManager.js:2850

Serialize a visualization envelope suitable for attachment to a portable network export. The envelope includes the current storageState snapshot.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional		Snapshot options forwarded to Helios.

Returns

Visualization-state envelope.

Type Promise<Object>

Example

helios.serializeNetworkSnapshot({
  enabled: true,
});

attachVisualizationStateToNetwork(snapshot = null, options = {}) → {Promise<unknown>}

Source: src/storage/HeliosStorageManager.js:2886

Attach a visualization-state envelope to the active network.

Parameters

Name	Type	Attributes	Default	Description
snapshot	Object|null	optional	null	Existing visualization envelope, or null to capture one through storage.
options	Object	optional		Attachment options.

Returns

The underlying Helios attachment result.

Type Promise<unknown>

saveNetworkSnapshot(format = 'zxnet', options = {}) → {Promise<unknown>}

Source: src/storage/HeliosStorageManager.js:2901

Save the active network with visualization state attached.

Parameters

Name	Type	Attributes	Default	Description
format	string	optional	'zxnet'	Portable network format.
options	Object	optional		Save options forwarded to Helios.

Returns

Serialized network payload.

Type Promise<unknown>

restoreNetworkSnapshot(source, options = {}) → {Promise<unknown>}

Source: src/storage/HeliosStorageManager.js:2919

Restore a portable network snapshot through Helios network loading.

Parameters

Name	Type	Attributes	Default	Description
source	unknown			Network payload or file-like source.
options	Object	optional		Restore options forwarded to Helios.

Returns

Loaded network result.

Type Promise<unknown>

restoreSnapshot(snapshot = {}, options = {}) → {this}

Source: src/storage/HeliosStorageManager.js:2927

Updates the snapshot state on the current instance.

Parameters

Name	Type	Attributes	Default	Description
snapshot		optional	{}	Value passed to restoreSnapshot.
options	Object	optional	{}	Options object for this operation.

Returns

This instance.

Type this

loadSession(sessionId = this.sessionId, options = {})

Source: src/storage/HeliosStorageManager.js:2945

Handles session for the current graph or visualization state.

Parameters

Name	Type	Attributes	Default	Description
sessionId		optional	this.sessionId	Value passed to loadSession.
options	Object	optional	{}	Options object for this operation.

restoreActiveSession(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3021

Read or set the restore active session setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current restore active session value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.restoreActiveSession({
  enabled: true,
});

saveSession(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3206

Read or set the save session setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current save session value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.saveSession({
  enabled: true,
});

restoreSession(sessionIdOrRecord, options = {}) → {this}

Source: src/storage/HeliosStorageManager.js:3302

Updates the session state on the current instance.

Parameters

Name	Type	Attributes	Default	Description
sessionIdOrRecord				Value passed to restoreSession.
options	Object	optional	{}	Options object for this operation.

Returns

This instance.

Type this

Layout And Positions

Layout selection, position sources, interpolation, and position snapshots. LayoutBehavior handles the built-in layout UI.

markPositionsDirty(reason = 'positions-change')

Source: src/storage/HeliosStorageManager.js:1131

Configures or reads mark positions dirty.

Parameters

Name	Type	Attributes	Default	Description
reason	string	optional	'positions-change'	Reason for this operation.

Configuration

General configuration setters and compatibility helpers.

getUnfinishedSessionId()

Source: src/storage/HeliosStorageManager.js:882

Returns the current unfinished session id value or state.

Example

const value = helios.getUnfinishedSessionId();

setUnfinishedSessionId(id) → {this}

Source: src/storage/HeliosStorageManager.js:886

Set the unfinished session id setting.

Parameters

Name	Type	Attributes	Default	Description
id				Value passed to setUnfinishedSessionId.

Returns

This instance.

Type this

setOverrideTrackingReady(ready = true) → {this}

Source: src/storage/HeliosStorageManager.js:890

Set the override tracking ready setting.

Parameters

Name	Type	Attributes	Default	Description
ready		optional	true	Value passed to setOverrideTrackingReady.

Returns

This instance.

Type this

getPreferences()

Source: src/storage/HeliosStorageManager.js:1056

Returns the current preferences value or state.

Example

const value = helios.getPreferences();

setSessionNickname(nickname, id = this.sessionId) → {this}

Source: src/storage/HeliosStorageManager.js:1171

Set the session nickname setting.

Parameters

Name	Type	Attributes	Default	Description
nickname				Value passed to setSessionNickname.
id		optional	this.sessionId	Value passed to setSessionNickname.

Returns

This instance.

Type this

getSession(id)

Source: src/storage/HeliosStorageManager.js:3215

Returns the current session value or state.

Parameters

Name	Type	Attributes	Default	Description
id				Value passed to getSession.

getResumeSessions(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3252

Read or set the get resume sessions setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current get resume sessions value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.getResumeSessions({
  enabled: true,
});

getResumePrompt(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3281

Read or set the get resume prompt setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current get resume prompt value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.getResumePrompt({
  enabled: true,
});

Utilities

Additional public helpers that do not belong to a narrower API area.

configure(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:1001

Read or set the configure setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current configure value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.configure({
  enabled: true,
});

updatePreferences(patch = {})

Source: src/storage/HeliosStorageManager.js:1072

Configures or reads update preferences.

Parameters

Name	Type	Attributes	Default	Description
patch		optional	{}	Value passed to updatePreferences.

acknowledgeSavedSnapshot(reason = 'save-acknowledged', options = {})

Source: src/storage/HeliosStorageManager.js:1688

Configures or reads acknowledge saved snapshot.

Parameters

Name	Type	Attributes	Default	Description
reason	string	optional	'save-acknowledged'	Reason for this operation.
options	Object	optional	{}	Options object for this operation.

debugStats(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2068

Read or set the debug stats setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current debug stats value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.debugStats({
  enabled: true,
});

status()

Source: src/storage/HeliosStorageManager.js:2149

Configures or reads status.

persistenceStatus()

Source: src/storage/HeliosStorageManager.js:2153

Configures or reads persistence status.

deserializeSessionSnapshot(snapshot = {})

Source: src/storage/HeliosStorageManager.js:2632

Configures or reads deserialize session snapshot.

Parameters

Name	Type	Attributes	Default	Description
snapshot		optional	{}	Value passed to deserializeSessionSnapshot.

captureSessionThumbnail(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2636

Read or set the capture session thumbnail setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current capture session thumbnail value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.captureSessionThumbnail({
  enabled: true,
});

configureSession(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:2977

Read or set the configure session setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current configure session value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.configureSession({
  enabled: true,
});

startNewSession(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3062

Read or set the start new session setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current start new session value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.startNewSession({
  enabled: true,
});

flushPreviousSessionForSwitch(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3098

Read or set the flush previous session for switch setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current flush previous session for switch value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.flushPreviousSessionForSwitch({
  enabled: true,
});

listSessions(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3222

Read or set the list sessions setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current list sessions value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.listSessions({
  enabled: true,
});

listSessionSummaries(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3245

Read or set the list session summaries setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current list session summaries value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.listSessionSummaries({
  enabled: true,
});

resumeSession(sessionId, options = {})

Source: src/storage/HeliosStorageManager.js:3297

Configures or reads resume session.

Parameters

Name	Type	Attributes	Default	Description
sessionId				Value passed to resumeSession.
options	Object	optional	{}	Options object for this operation.

deleteSession(id)

Source: src/storage/HeliosStorageManager.js:3309

Configures or reads delete session.

Parameters

Name	Type	Attributes	Default	Description
id				Value passed to deleteSession.

markSessionFinished(id = this.sessionId)

Source: src/storage/HeliosStorageManager.js:3320

Configures or reads mark session finished.

Parameters

Name	Type	Attributes	Default	Description
id		optional	this.sessionId	Value passed to markSessionFinished.

flush(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3345

Read or set the flush setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current flush value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.flush({
  enabled: true,
});

sync(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3383

Read or set the sync setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current sync value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.sync({
  enabled: true,
});

flushAutosync(options = {}) → {Object|this}

Source: src/storage/HeliosStorageManager.js:3403

Read or set the flush autosync setting.

Parameters

Name	Type	Attributes	Default	Description
options	Object	optional	{}	Options object for this operation.

Returns

Current flush autosync value when called without arguments; otherwise this instance for chaining.

Type Object|this

Example

helios.flushAutosync({
  enabled: true,
});