目录

• 存储 (Storages)
  • storages.create(name)
  • storages.remove(name)
• Storages
  • Storage.get(key[, defaultValue])
  • Storage.put(key, value)
  • Storage.remove(key)
  • Storage.contains(key)
  • Storage.clear()

存储 (Storages)#

---

此章节待补充或完善...

Marked by SuperMonster003 on Oct 22, 2022.

---

storages模块提供了保存简单数据、用户配置等的支持. 保存的数据除非应用被卸载或者被主动删除, 否则会一直保留.

storages支持number, boolean, string等数据类型以及把Object, Array用JSON.stringify序列化存取.

storages保存的数据在脚本之间是共享的, 任何脚本只要知道storage名称便可以获取到相应的数据, 因此它不能用于敏感数据的储存. storages无法像Web开发中LocalStorage一样提供根据域名独立的存储, 因为脚本的路径随时可能改变.

storages.create(name)#

创建一个本地存储并返回一个Storage对象. 不同名称的本地存储的数据是隔开的, 而相同名称的本地存储的数据是共享的.

例如在一个脚本中, 创建名称为ABC的存储并存入a=123:

var storage = storages.create("ABC");
storage.put("a", 123);

而在另一个脚本中是可以获取到ABC以及a的值的：

var storage = storages.create("ABC");
log("a = " + storage.get("a"));

因此, 本地存储的名称比较重要, 尽量使用含有域名、作者邮箱等唯一信息的名称来避免冲突, 例如：

var storage = storages.create("2732014414@qq.com:ABC");

storages.remove(name)#

删除一个本地存储以及他的全部数据. 如果该存储不存在, 返回false；否则返回true.

Storages#

Storage.get(key[, defaultValue])#

从本地存储中取出键值为key的数据并返回.

如果该存储中不包含该数据, 这时若指定了默认值参数则返回默认值, 否则返回undefined.

返回的数据可能是任意数据类型, 这取决于使用Storage.put保存该键值的数据时的数据类型.

Storage.put(key, value)#

把值value保存到本地存储中. value可以是undefined以外的任意数据类型. 如果value为undefined则抛出TypeError.

存储的过程实际上是使用JSON.stringify把value转换为字符串再保存, 因此value必须是可JSON化的才能被接受.

Storage.remove(key)#

移除键值为key的数据. 不返回任何值.

Storage.contains(key)#

返回该本地存储是否包含键值为key的数据. 是则返回true, 否则返回false.

Storage.clear()#

移除该本地存储的所有数据. 不返回任何值.