SimpleStorage – это хранилище объектов. Так же как объект Map в JavaScript, это коллекция пар ключ-/значение, в которой ключи могут быть разных типов.
Используйте методы данного класса, например, для управления данными, которые могут понадобиться в разные моменты жизни страницы клиентским скриптам виджетов или формы.
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | Использование Storage |
---|
linenumbers | true |
---|
|
if (SimpleStorage.hasItem('portalLogo')) {
s_widget.setFieldValue("hasLogo", true);
s_widget.setFieldValue("logo", SimpleStorage.getItem("portalLogo"));
} else {
await s_widget.serverUpdate();
SimpleStorage.setItem('portalLogo', s_widget.getFieldValue("logo"));
} |
getItem(key)
Используйте этот метод, чтобы получить значение на основе ключа.
Параметр:
Название | Тип | Обязательный | Дефолтное значение |
---|
key | String | ДДа | ННет |
Возвращаемое значение:
Тип | Описание |
---|
String | Этот метод возвращает элемент, указанный ключом. |
Пример:
Code Block |
---|
language | xml |
---|
title | getItem |
---|
linenumbers | true |
---|
|
SimpleStorage.getItem('name'); // "Иван" |
hasItem(key)
Данный метод предназначен для проверки наличия ключа в хранилище.
Параметр:
Название | Тип | Обязательный | Дефолтное значение |
---|
key | любой | ДДа | ННет |
Возвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает значение true, если ключ, указанный в параметре key был найден; в противном случае, метод возвращает false. |
Пример:
Code Block |
---|
language | xml |
---|
title | hasItem |
---|
linenumbers | true |
---|
|
SimpleStorage.hasItem('name'); // true |
setItem(key, value)
Используйте этот метод, чтобы установить значение для ключа.
Параметры:
Название | Тип | Обязательный | Дефолтное значение |
---|
key | String | ДДа | ННет |
value | Любой | ДДа | ННет |
Возвращаемое значение:
Тип | Описание |
---|
Void | Данный метод не возвращает значение. |
Пример:
Code Block |
---|
language | xml |
---|
title | setItem |
---|
linenumbers | true |
---|
|
SimpleStorage.setItem('name', 'Иван') |
getEntries()
Используйте этот метод, чтобы получить массив пар (ключ, значение).
Возвращаемое значение:
Тип | Описание |
---|
Array | Метод возвращает массив массивов, содержащих названия ключей и их значения, или пустой массив. |
Пример:
Code Block |
---|
language | xml |
---|
title | getEntries |
---|
linenumbers | true |
---|
|
SimpleStorage.getEntries(); // [["name", "Иван"],[ ["secondName", "Петров"]]] |
getKeys()
Используйте этот метод, чтобы получить массив ключей.
Возвращаемое значение:
Тип | Описание |
---|
Array | Метод возвращает массив ключей или пустой массив. |
Пример:
Code Block |
---|
language | xml |
---|
title | getKeys |
---|
linenumbers | true |
---|
|
SimpleStorage.getKeys(); // ["name", "secondName"] |
getSize()
Используйте данный метод, чтобы узнать количество значений в хранилище.
Пример:
Code Block |
---|
language | xml |
---|
title | getSize |
---|
linenumbers | true |
---|
|
SimpleStorage.getSize(); // 2 |
reset()
Используйте этот метод, чтобы очистить хранилище.
Возвращаемое значение:
Тип | Описание |
---|
Void | Данный метод не возвращает значение. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | reset |
---|
|
SimpleStorage.reset(); |