- Tutorials:
- See:
stbStorage provides API to access global key-value storage.
Members
(static, readonly) length :number
Get the total number of keys.
Type:
- number
Methods
(static) clear()
Remove all the keys and data.
(static) key(index) → (nullable) {string}
Get the key name by its index.
If there is no key associated with the index then return null.
Example
// get key name by its position in the storage hash
var keyName = stbStorage.key(3);
Parameters:
| Name | Type | Description |
|---|---|---|
index |
number | key position |
Returns:
key name or null if the key does not exist
- Type
- string
(static) getItem(keyName) → (nullable) {string}
Get key's value using key name.
See stbStorage.setItem.
Example
// receive key value
var data = stbStorage.getItem('someName');
Parameters:
| Name | Type | Description |
|---|---|---|
keyName |
string | unique key name |
Returns:
key value or null if the key does not exist
- Type
- string
(static) setItem(keyName, keyValue)
Set key value for key keyName.
Old key value will be replaced with the new one.
If there was no value associated with the key then new one will be stored.
See stbStorage.getItem.
Example
// create or update key
stbStorage.setItem('someName', 128);
Parameters:
| Name | Type | Description |
|---|---|---|
keyName |
string | unique key name |
keyValue |
string | number | new key value |
(static) removeItem(keyName)
Remove the given key.
Example
// delete key
stbStorage.removeItem('someName');
Parameters:
| Name | Type | Description |
|---|---|---|
keyName |
string | unique key name |