-
+
- Overview - 综述 +
- Q&A - 常见问题 +
- Globals - 一般全局函数 +
- WidgetsBasedAutomation - 基于控件的触摸模拟 +
- CoordinatesBasedAutomation - 基于坐标的触摸模拟 +
- Images - 图片与图色处理 +
- Console - 控制台 +
- Events - 事件与监听 +
- Timers - 定时器 +
- Shell - Shell命令 +
- UI - 用户界面 +
- Dialogs - 对话框 +
- Files - 文件系统 +
- Storages - 本地存储 +
- Http - HTTP +
- App - 应用 +
- Engines - 脚本引擎 +
- Modules - 模块 +
- Threads - 多线程 +
- Work with Java - 调用Java API +
Auto.js 3.0.0 文档
+ ++
目录
+ + +Storages#
+storages模块提供了保存简单数据、用户配置等的支持。保存的数据除非应用被卸载或者被主动删除，否则会一直保留。
+storages支持number, boolean, string等数据类型以及把Object, Array用JSON.stringify序列化存取。
storages保存的数据在脚本之间是共享的，任何脚本只要知道storage名称便可以获取到相应的数据，因此它不能用于敏感数据的储存。 +storages无法像Web开发中LocalStorage一样提供根据域名独立的存储，因为脚本的路径随时可能改变。
+storages.create(name)#
+-
+
name<string> 本地存储名称
+
创建一个本地存储并返回一个Storage对象。不同名称的本地存储的数据是隔开的，而相同名称的本地存储的数据是共享的。
例如在一个脚本中，创建名称为ABC的存储并存入a=123:
+var storage = stroages.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()#
+移除该本地存储的所有数据。不返回任何值。
+ +