swan.getStorage

解释：从本地缓存中异步获取指定 key 对应的内容。

方法参数

Object object

object参数说明 ：

属性名类型必填默认值说明
keyString是本地缓存中的指定的 key
successFunction否接口调用成功的回调函数。
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明 ：

参数类型说明
dataObject/String/Number/Arraykey 对应的内容

示例

在开发者工具中预览效果

swan.getStorage - 图1请使用百度APP扫码

图片示例

swan.getStorage - 图2

swan.getStorage - 图3

swan.getStorage - 图4

代码示例

建议先使用 setStorage， 再使用 getStorage 。

  • 在 swan 文件中
  1. <view class="container">
  2.     <view class="card-area">
  3.         <view class="list-area border-bottom">
  4.             <label class="list-item-key-4">key</label>
  5.             <input class="list-item-value" bindfocus="keyFocus" bindinput="keyInput" type="text" value="{{key}}" placeholder="请输入key"/>
  6.         </view>
  7.         <view class="list-area border-bottom">
  8.             <label class="list-item-key-4">value</label>
  9.             <input class="list-item-value" bindfocus="valueFocus" bindinput="valueInput" type="text" value="{{value}}" placeholder="请输入value"/>
  10.         </view>
  11.         <view>
  12.             <button  bindtap="setStorage" type="primary" hover-stop-propagation="true">存储数据</button>
  13.             <button  bindtap="getStorage" type="primary" hover-stop-propagation="true" disabled="{{disabled}}">读取数据</button>
  14.         </view>
  15.     </view>
  16. </view>
  • 在 js 文件中
  1. Page({
  2.     data: {
  3.         key: '示例Key',
  4.         value: '示例Value',
  5.         disabled: true
  6.     },
  7.     keyInput(e) {
  8.         this.setData('key', e.detail.value);
  9.     },
  10.     valueInput(e) {
  11.         this.setData('value', e.detail.value);
  12.     },
  13.     valueFocus() {
  14.         this.setData('value', '');
  15.     },
  16.     keyFocus() {
  17.         this.setData('key', '');
  18.     },
  19.     setStorage() {
  20.         let key = this.hasKey();
  21.         if (!key) {
  22.             return;
  23.         }
  24.         swan.setStorage({
  25.             key,
  26.             data: this.getData('value'),
  27.             success: res => {
  28.                 this.toast('存储成功', 'none');
  29.                 this.setData('disabled', false);
  30.             },
  31.             fail: err => {
  32.                 this.toast('存储数据失败');
  33.             }
  34.         });
  35.     },
  36.     getStorage() {
  37.         let key = this.hasKey();
  38.         if (!key) {
  39.             return;
  40.         }
  41.         swan.getStorage({
  42.             key,
  43.             success: res => {
  44.                 const data = res.data;
  45.                 if (data) {
  46.                     swan.showModal({
  47.                         title: '数据信息',
  48.                         content: `${key}: ${data}`,
  49.                         showCancel: false
  50.                     });
  51.                 } else {
  52.                     this.toast('找不到key对应的值');
  53.                 }
  54.             },
  55.             fail: err => {
  56.                 this.toast('读取数据失败');
  57.             }
  58.         });
  59.     },
  60.     hasKey() {
  61.         let key = this.getData('key');
  62.         if (key) {
  63.             return key;
  64.         }
  65.         this.toast('key不能为空');
  66.     },
  67.     toast(title, icon = 'none') {
  68.         swan.showToast({title, icon});
  69.     }
  70. });

错误码

Android

错误码说明
201解析失败，请检查调起协议是否合法
1001执行失败

iOS

错误码说明
202解析失败，请检查参数是否正确

Bugs&Tips

通过swan.getStorage获取一个为设置的key对应值时， 目前会回调success函数并返回空字符串， 该问题会在后续版本修复，请关注公告及文档说明。