Spark Framework Class: Store

new Store(options, data)

Parameters:

Name	Type	Argument	Description
`options`	Object	<optional>	Class options.
`data`	*	<optional>	Class data

Source:

core/Store.js, line 16

Extends

spark.core.Object

Methods

clear()

Removes all keys from store.

Source:

core/Store.js, line 155

destroy()

Destroys the object. Emits the following events before and after the object is destroyed. Sets data and options to null and calls the dispose and disposeInternal on parent to make a proper clean up. Calling dispose will set the Object.isDisposed to true and calling disposeInternal will unlisten all binded events so there won't be any event and/or memory leak.

Inherited From:

spark.core.Object#destroy

Source:

core/Object.js, line 184

emit(eventName, data)

Dispatches an event and calls all listeners listening for events of this event. See also goog.events.Listenable.prototype.dispatchEvent

Parameters:

Name	Type	Argument	Description
`eventName`	string		Name of the event.
`data`	*	<optional>	Data which will passed to listeners

Inherited From:

spark.core.Object#emit

Source:

core/Object.js, line 152

freeze()

Freezes object to prevent adding new properties, updating or deleting existing properties.

Inherited From:

spark.core.Object#freeze

Source:

core/Object.js, line 113

get(key, escape) → {*}

Returns value of the given key from the store. String values will be encoded by default to prevent possible XSS attacks. If you don't want the encoding for some reason pass a second false parameter.

Parameters:

Name	Type	Argument	Description
`key`	string		Key to be returned.
`escape`	boolean	<optional>	Whether you want to espace the value or not.

Source:

core/Store.js, line 43

Returns:

Type: *

getData() → {*}

Returns class data.

Inherited From:

spark.core.Object#getData

Source:

core/Object.js, line 84

Returns:

Class data.

Type: *

getKeys() → {Array}

Returns keys array.

Source:

core/Store.js, line 176

Returns:

Keys array.

Type: Array

getOption() → {*}

Returns value of a key in options object.

Inherited From:

spark.core.Object#getOption

Source:

core/Object.js, line 64

Returns:

Value of key or null.

Type: *

getOptions() → {Object}

Returns all options object.

Inherited From:

spark.core.Object#getOptions

Source:

core/Object.js, line 54

Returns:

Options object.

Type: Object

getUid() → {string}

Return unique id.

Inherited From:

spark.core.Object#getUid

Source:

core/Object.js, line 103

Returns:

Unique id of this component.

Type: string

getValues() → {Array}

Returns values array.

Source:

core/Store.js, line 186

Returns:

Values array.

Type: Array

has(key) → {boolean}

Returns true if the store has the given key.

Parameters:

Name	Type	Description
`key`	string	Key to be searched in store.

Source:

core/Store.js, line 166

Returns:

Whether the store has the key or not.

Type: boolean

isDestroyed() → {boolean}

Returns the object's destroy state.

Inherited From:

spark.core.Object#isDestroyed

Source:

core/Object.js, line 199

Returns:

Whether the object is destroyed or not.

Type: boolean

off(eventName, callback) → {boolean}

Removes an event listener which was added with @on or @once. See also goog.events.Listenable.prototype.unlisten

Parameters:

Name	Type	Description
`eventName`	string	Name of the event.
`callback`	function	Callback function for the event.

Inherited From:

spark.core.Object#off

Source:

core/Object.js, line 171

Returns:

Whether any listener was removed.

Type: boolean

on(eventName, callback) → {goog.events.ListenableKey|number}

Adds an event listener. See also goog.events.Listenable::listen

Parameters:

Name	Type	Description
`eventName`	string	Name of the event.
`callback`	function	Callback function for the event.

Inherited From:

spark.core.Object#on

Source:

core/Object.js, line 127

Returns:

Unique key for the listener.

Type: goog.events.ListenableKey | number

once(eventName, callback) → {goog.events.ListenableKey|number}

Adds an event listener that is removed automatically after the listener fired once. See also goog.events.Listenable.prototype.listenOnce

Parameters:

Name	Type	Description
`eventName`	string	Name of the event.
`callback`	function	Callback function for the event.

Inherited From:

spark.core.Object#once

Source:

core/Object.js, line 140

Returns:

Unique key for the listener.

Type: goog.events.ListenableKey | number

set(key, value) → {boolean}

Sets a new key value pair into store. It will also make a validation before setting the new value. If you set a validation rule in options.validations for that property, when validation failed, the property won't be updated. Store::set will return no and emit a 'PropertyRejected' event otherwise it will return true and it will also emit 'ProperySet'. Both events will include key and value. If the key and value passed to set does not related with a validation rule, it will directly set to store. This makes validation optional.