Storages - 本地存储
<p>[TOC]</p>
<h1>Storages</h1>
<blockquote>
<p>Stability: 2 - Stable</p>
</blockquote>
<p>storages模块提供了保存简单数据、用户配置等的支持。保存的数据除非应用被卸载或者被主动删除，否则会一直保留。</p>
<p>storages支持<code>number</code>, <code>boolean</code>, <code>string</code>等数据类型以及把<code>Object</code>, <code>Array</code>用<code>JSON.stringify</code>序列化存取。</p>
<p>storages保存的数据在脚本之间是共享的，任何脚本只要知道storage名称便可以获取到相应的数据，因此它不能用于敏感数据的储存。
storages无法像Web开发中LocalStorage一样提供根据域名独立的存储，因为脚本的路径随时可能改变。</p>
<h2>storages.create(name)</h2>
<ul>
<li><code>name</code> {string} 本地存储名称</li>
</ul>
<p>创建一个本地存储并返回一个<code>Storage</code>对象。不同名称的本地存储的数据是隔开的，而相同名称的本地存储的数据是共享的。</p>
<p>例如在一个脚本中，创建名称为ABC的存储并存入a=123:</p>
<pre><code>var storage = storages.create("ABC");
storage.put("a", 123);</code></pre>
<p>而在另一个脚本中是可以获取到ABC以及a的值的：</p>
<pre><code>var storage = storages.create("ABC");
log("a = " + storage.get("a"));</code></pre>
<p>因此，本地存储的名称比较重要，尽量使用含有域名、作者邮箱等唯一信息的名称来避免冲突，例如：</p>
<pre><code>var storage = storages.create("2732014414@qq.com:ABC");</code></pre>
<h2>storages.remove(name)</h2>
<ul>
<li><code>name</code> {string} 本地存储名称</li>
</ul>
<p>删除一个本地存储以及他的全部数据。如果该存储不存在，返回false；否则返回true。</p>
<h1>Storages</h1>
<h2>Storage.get(key[, defaultValue])</h2>
<ul>
<li><code>key</code> {string} 键值</li>
<li><code>defaultValue</code> {any} 可选，默认值</li>
</ul>
<p>从本地存储中取出键值为key的数据并返回。</p>
<p>如果该存储中不包含该数据，这时若指定了默认值参数则返回默认值，否则返回undefined。</p>
<p>返回的数据可能是任意数据类型，这取决于使用<code>Storage.put</code>保存该键值的数据时的数据类型。</p>
<h2>Storage.put(key, value)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
<li><code>value</code> {any} 值</li>
</ul>
<p>把值value保存到本地存储中。value可以是undefined以外的任意数据类型。如果value为undefined则抛出TypeError。</p>
<p>存储的过程实际上是使用JSON.stringify把value转换为字符串再保存，因此value必须是可JSON化的才能被接受。</p>
<h2>Storage.remove(key)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
</ul>
<p>移除键值为key的数据。不返回任何值。</p>
<h2>Storage.contains(key)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
</ul>
<p>返回该本地存储是否包含键值为key的数据。是则返回true，否则返回false。</p>
<h2>Storage.clear()</h2>
<p>移除该本地存储的所有数据。不返回任何值。# Storages</p>
<blockquote>
<p>Stability: 2 - Stable</p>
</blockquote>
<p>storages模块提供了保存简单数据、用户配置等的支持。保存的数据除非应用被卸载或者被主动删除，否则会一直保留。</p>
<p>storages支持<code>number</code>, <code>boolean</code>, <code>string</code>等数据类型以及把<code>Object</code>, <code>Array</code>用<code>JSON.stringify</code>序列化存取。</p>
<p>storages保存的数据在脚本之间是共享的，任何脚本只要知道storage名称便可以获取到相应的数据，因此它不能用于敏感数据的储存。
storages无法像Web开发中LocalStorage一样提供根据域名独立的存储，因为脚本的路径随时可能改变。</p>
<h2>storages.create(name)</h2>
<ul>
<li><code>name</code> {string} 本地存储名称</li>
</ul>
<p>创建一个本地存储并返回一个<code>Storage</code>对象。不同名称的本地存储的数据是隔开的，而相同名称的本地存储的数据是共享的。</p>
<p>例如在一个脚本中，创建名称为ABC的存储并存入a=123:</p>
<pre><code>var storage = storages.create("ABC");
storage.put("a", 123);</code></pre>
<p>而在另一个脚本中是可以获取到ABC以及a的值的：</p>
<pre><code>var storage = storages.create("ABC");
log("a = " + storage.get("a"));</code></pre>
<p>因此，本地存储的名称比较重要，尽量使用含有域名、作者邮箱等唯一信息的名称来避免冲突，例如：</p>
<pre><code>var storage = storages.create("2732014414@qq.com:ABC");</code></pre>
<h2>storages.remove(name)</h2>
<ul>
<li><code>name</code> {string} 本地存储名称</li>
</ul>
<p>删除一个本地存储以及他的全部数据。如果该存储不存在，返回false；否则返回true。</p>
<h1>Storages</h1>
<h2>Storage.get(key[, defaultValue])</h2>
<ul>
<li><code>key</code> {string} 键值</li>
<li><code>defaultValue</code> {any} 可选，默认值</li>
</ul>
<p>从本地存储中取出键值为key的数据并返回。</p>
<p>如果该存储中不包含该数据，这时若指定了默认值参数则返回默认值，否则返回undefined。</p>
<p>返回的数据可能是任意数据类型，这取决于使用<code>Storage.put</code>保存该键值的数据时的数据类型。</p>
<h2>Storage.put(key, value)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
<li><code>value</code> {any} 值</li>
</ul>
<p>把值value保存到本地存储中。value可以是undefined以外的任意数据类型。如果value为undefined则抛出TypeError。</p>
<p>存储的过程实际上是使用JSON.stringify把value转换为字符串再保存，因此value必须是可JSON化的才能被接受。</p>
<h2>Storage.remove(key)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
</ul>
<p>移除键值为key的数据。不返回任何值。</p>
<h2>Storage.contains(key)</h2>
<ul>
<li><code>key</code> {string} 键值</li>
</ul>
<p>返回该本地存储是否包含键值为key的数据。是则返回true，否则返回false。</p>
<h2>Storage.clear()</h2>
<p>移除该本地存储的所有数据。不返回任何值。</p>