swan.getStorageSync

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

方法参数

String key

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

示例

在开发者工具中预览效果

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

图片示例

swan.getStorageSync - 图2

swan.getStorageSync - 图3

swan.getStorageSync - 图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 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解析失败,请检查参数是否正确

Bug & Tip

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