swan.setStorageSync

解释：将数据存储在本地缓存中指定的 key 中。如果之前存在同名 key，会覆盖掉原来该 key 对应的内容。这是一个同步接口。

方法参数

String key, Object/String data

key参数说明 ：本地缓存中的指定的 key

data参数说明 ：需要存储的内容

示例

在开发者工具中预览效果

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

图片示例

swan.setStorageSync - 图2

swan.setStorageSync - 图3

swan.setStorageSync - 图4

代码示例

  • 在 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="setStorageSync" type="primary" hover-stop-propagation="true">存储数据</button>
  13.             <button  bindtap="getStorageSync" 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.     valueFocus() {
  11.         this.setData('value', '');
  12.     },
  13.     keyFocus() {
  14.         this.setData('key', '');
  15.     },
  16.     valueInput(e) {
  17.         this.setData('value', e.detail.value);
  18.     },
  19.     setStorageSync() {
  20.         let key = this.hasKey();
  21.         if (!key) {
  22.             return;
  23.         }
  24.         let res = swan.setStorageSync(key, this.getData('value'));
  25.         // 基础库 3.140.1 之前，无法判断接口是否调用失败
  26.         // 基础库 3.140.1 及以后，通过 instanceof 来判断接口是否调用失败
  27.         if (!res.errCode || !res.errMsg && !(res instanceof Error)) {
  28.             this.toast('存储成功', 'none');
  29.             this.setData('disabled', false);
  30.         }
  31.         else {
  32.             swan.showModal({
  33.                 title: '存储失败',
  34.                 content: res.message
  35.             });
  36.         }
  37.     },
  38.     getStorageSync() {
  39.         let key = this.hasKey();
  40.         if (!key) {
  41.             return;
  42.         }
  43.         let res = swan.getStorageSync(key);
  44.         // 基础库 3.140.1 之前，无法判断接口是否调用失败
  45.         // 基础库 3.140.1 及以后，通过 instanceof 来判断接口是否调用失败
  46.         if (!(res instanceof Error)) {
  47.             console.log('getStorageSync success:', res);
  48.             swan.showModal({
  49.                 title: '数据信息',
  50.                 content: res,
  51.                 showCancel: false
  52.             });
  53.         }
  54.         else {
  55.             this.toast('找不到key对应的值');
  56.         }
  57.     },
  58.     hasKey() {
  59.         let key = this.getData('key');
  60.         if (key) {
  61.             return key;
  62.         }
  63.         this.toast('key不能为空');
  64.     },
  65.     toast(title, icon = 'none') {
  66.         swan.showToast({title, icon});
  67.     }
  68. });

错误码

Android

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

iOS

错误码说明
202解析失败，请检查参数是否正确
1003超过最大存储文件大小

Bug & Tip

  • 基础库 3.140.1 之前，无法判断接口是否调用失败。
  • 基础库 3.140.1 及以后，接口调用失败时会返回一个标准的Error对象，可通过instanceof来判断接口是否调用失败。