MemoryStorage

MemoryStorage

MemoryStorage 类是参考 Web Storage API 的 Storage 接口设计的。其目的是提供 JS 元件在不同窗口之间通信的能力。

注意:

  • 系统的唯一 MemoryStorage 实例为 window.memoryStorage
  • MemoryStorage 将数据存储在 HMI 或 Viewer 的内存中。当 HMI 重新启动或 Viewer 关闭时,数据将被清除。
  • HMI 和 Viewer 各自的 MemoryStorage 是独立的,互不影响。
  • 每个 MemoryStorage 的最大数据限制为 2MB。
  • 适用版本:EasyBuilder Pro V6.09.02

Members

(readonly) length :Number

返回存储在 MemoryStorage 对象中的数据项数量。

Type:
  • Number

Methods

clear()

该方法清除 MemoryStorage 对象中存储的所有键。

Example
window.memoryStorage.clear();

getItem(keyName) → {String}

该方法接受一个键名,返回该键的值。如果键不存在,则返回 null

Example
const currentFont = window.memoryStorage.getItem("currentFont");
Parameters:
Name Type Description
keyName String

一个字符串,表示要获取值的键名。

Returns:

包含键值的字符串。如果键不存在,则返回 null

Type
String

key(index) → {String}

该方法接受一个数字 n,返回 MemoryStorage 对象中第 n 个键的名称。

Example

遍历存储键

for (let i = 0; i < window.memoryStorage.length; i++) {
  console.log(window.memoryStorage.key(i));
}
Parameters:
Name Type Description
index Number

一个整数,表示要获取键名的索引。索引是从零开始的。

Returns:

包含键名的字符串。如果索引不存在,则返回 null

Type
String

removeItem(keyName)

该方法接受一个键名,若 MemoryStorage 对象中存在该键,则将其移除。 如果没有与该键相关的项目,则此方法不会执行任何操作。

Example
window.memoryStorage.removeItem("currentFont");
Parameters:
Name Type Description
keyName String

一个字符串,表示要移除的键名。

setItem(keyName, keyValue)

该方法接受一个键名和一个值,在 MemoryStorage 对象中添加该键, 或者如果该键已存在,则更新其值。

Example
window.memoryStorage.setItem("currentFont", "Helvetica");
Parameters:
Name Type Description
keyName String

一个字符串,表示要创建/更新的键名。

keyValue String

一个字符串,表示要赋给该键的值。