auto.js_本地存储-Storages_ZHOU125disorder_

本地存储-Storages

• Storages

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

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

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

创建一个本地存储并返回一个Storage对象

• storages.create(name)

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

例如在一个脚本中，创建名称为Content的存储并存入love=1314520:

var storage = storages.create("Content");
storage.put("love", 1314520);

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

var storage = storages.create("Content");
log("love = " + storage.get("love"));

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

var storage = storages.create("3440681909@qq.com:Content");

删除一个本地存储以及他的全部数据

• storages.remove(name)

name：本地存储名称
删除一个本地存储以及他的全部数据。如果该存储不存在，返回false；否则返回true。

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

• Storage.get(key[, defaultValue])

key：键值 
defaultValue（any）可选，默认值
从本地存储中取出键值为key的数据并返回。

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

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

把值value保存到本地存储中

• Storage.put(key, value)

key {string} 键值 
value {any} 值
把值value保存到本地存储中。value可以是undefined以外的任意数据类型。如果value为undefined则抛出TypeError。

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

移除键值为key的数据

• Storage.remove(key)

key {string} 键值
移除键值为key的数据。不返回任何值。

返回该本地存储是否包含键值为key的数据

• Storage.contains(key)

key {string} 键值
返回该本地存储是否包含键值为key的数据。是则返回true，否则返回false。

移除该本地存储的所有数据

• Storage.clear()

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