swan.setStorage

解釋：將數(shù)據(jù)存儲在本地緩存中指定的 key 中，會覆蓋掉原來該 key 對應的內(nèi)容。主動刪除歷史小程序，卸載百度 APP ，或在系統(tǒng)中清除百度 APP 的緩存即可清除數(shù)據(jù)。目前單個 key 允許存儲的最大數(shù)據(jù)長度無限制，沒有自動清理存儲機制。storage 上限 10MB ，用戶需主動清理，期間數(shù)據(jù)一直可用。

成都創(chuàng)新互聯(lián)服務項目包括巴楚網(wǎng)站建設、巴楚網(wǎng)站制作、巴楚網(wǎng)頁制作以及巴楚網(wǎng)絡營銷策劃等。多年來，我們專注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術優(yōu)勢、行業(yè)經(jīng)驗、深度合作伙伴關系等，向廣大中小型企業(yè)、政府機構等提供互聯(lián)網(wǎng)行業(yè)的解決方案，巴楚網(wǎng)站推廣取得了明顯的社會效益與經(jīng)濟效益。目前，我們服務的客戶以成都為中心已經(jīng)輻射到巴楚省份的部分城市，未來相信會繼續(xù)擴大服務區(qū)域并繼續(xù)獲得客戶的支持與信任！

Web 態(tài)說明：受瀏覽器限制，Web 態(tài) storage 的容量一般為 5MB ，具體視瀏覽器 localStorage 的容量大小而定。

方法參數(shù)

Object object

object 參數(shù)說明

屬性名	類型	必填	說明
key	String	是	本地緩存中的指定的 key
data	Object/String/Number/Array/Boolean	是	需要存儲的內(nèi)容
success	Function	否	接口調(diào)用成功的回調(diào)函數(shù)
fail	Function	否	接口調(diào)用失敗的回調(diào)函數(shù)
complete	Function	否	接口調(diào)用結束的回調(diào)函數(shù)（調(diào)用成功、失敗都會執(zhí)行）

示例

跳轉編輯工具

在開發(fā)者工具中打開

在 WEB IDE 中打開

掃碼體驗

代碼示例

請使用百度APP掃碼

圖片示例

代碼示例

SWAN
JS

代碼示例 2：利用本地緩存提前渲染界面

業(yè)務場景：我們實現(xiàn)的小程序首頁是展示一堆商品的列表。數(shù)據(jù)渲染的方式一般是在頁面 onLoad 回調(diào)之后通過 swan.request 向服務器發(fā)起一個請求去拉取列表數(shù)據(jù)，在 success 回調(diào)中把數(shù)據(jù)通過 setData 渲染到界面上，如下代碼所示。

 
 
 
  
  
  Page({
  
  
   onLoad() {
  
  
   swan.request({
  
  
   // 僅為示例，并非真實的接口地址
  
  
   url: 'https://www.baidu.com/xxx', 
  
  
   success: res => {
  
  
   if (res.statusCode === 200) {
  
  
   this.setData({
  
  
   list: res.data.list
  
  
   })
  
  
   }
  
  
   }
  
  
   })
  
  
   }
  
  
  })

在請求到數(shù)據(jù)前，我們避免頁面白屏的方式一般是把之前的請求成功請求存在本地緩存里，在 onLoad 發(fā)起請求前，先檢查是否有緩存過列表，如果有的話直接渲染界面，然后等到 swan.request 的 success 回調(diào)之后再覆蓋本地緩存重新渲染新的列表，如下代碼所示。

 
 
 
  
  
  Page({
  
  
   onLoad() {
  
  
   let list = swan.getStorageSync('list');
  
  
   if (list) {
  
  
   // 本地如果有緩存列表，提前渲染 
  
  
   this.setData({
  
  
   list: list
  
  
   })
  
  
   }
  
  
  
  
  
   swan.request({
  
  
   // 僅為示例，并非真實的接口地址
  
  
   url: 'https://www.baidu.com/xxx', 
  
  
   success: res => {
  
  
   if (res.statusCode === 200) {
  
  
   list = res.data.list;
  
  
   // 再次渲染列表
  
  
   this.setData({ 
  
  
   list: list
  
  
   })
  
  
   // 覆蓋緩存數(shù)據(jù)
  
  
   swan.setStorageSync("list", list); 
  
  
   }
  
  
   }
  
  
   })
  
  
   }
  
  
  })

錯誤碼

Android

錯誤碼	說明
201	解析失敗，請檢查調(diào)起協(xié)議是否合法
1001	執(zhí)行失敗

iOS

錯誤碼	說明
202	解析失敗，請檢查參數(shù)是否正確
1003	超過最大存儲文件大小

網(wǎng)站名稱：創(chuàng)新互聯(lián)百度小程序教程：swan.setStorage
文章起源：http://m.fisionsoft.com.cn/article/dhoehgi.html

新聞中心

swan.setStorage

方法參數(shù)

object 參數(shù)說明

示例

圖片示例

代碼示例

代碼示例 2：利用本地緩存提前渲染界面

錯誤碼

Android

iOS

其他資訊