索引 |

目录

• Storages#

  #

  • name <string> 本地存储名称

  创建一个本地存储并返回一个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)#

  • name <string> 本地存储名称

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

  Storages#

  Storage.get(key[, defaultValue])#

  • key <string> 键值
  • defaultValue <any> 可选，默认值

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

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

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

  Storage.put(key, value)#

  • key <string> 键值
  • value <any> 值

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

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

  Storage.remove(key)#

  • key <string> 键值

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

  Storage.contains(key)#

  • key <string> 键值

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

  Storage.clear()#

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