uniapp本地存儲詳解

一、uniapp本地存儲介紹

uniapp提供了一套完整的本地存儲機制，既包括完整的API使用，也提供了一些簡化開發的封裝，使得開發者可以輕鬆地進行數據存儲。uniapp本地存儲可以在h5、小程序、app等多個平台上使用，而且使用起來非常簡單。uniapp主要提供了三種本地存儲方式：localStorage、sessionStorage、uni.setStorageSync。

二、localStorage和sessionStorage

localStorage和sessionStorage都是HTML5中新增的本地存儲技術，它們的主要區別在於存儲數據的作用域不同。localStorage存儲的數據沒有時間限制，即使關閉瀏覽器再打開，數據依然存在；而sessionStorage只能存儲會話期間需要保存的數據，即數據只在瀏覽器關閉前有效。uniapp提供了本地存儲API uni.setStorage和uni.getStorage，可以方便地對localStorage和sessionStorage進行操作。

// 存儲數據到localStorage
uni.setStorageSync('key', 'value');

// 從localStorage獲取數據
let value = uni.getStorageSync('key');

實際使用中, uni.setStorageSync和uni.getStorageSync方法的參數同樣也支持對象，可以通過該方法一次性存儲多個數據。

// 存儲多個數據到localStorage
uni.setStorageSync({
  key1: 'value1',
  key2: 'value2'
});

// 從localStorage獲取多個數據
let data = uni.getStorageSync({
  key1: '',
  key2: ''
});

三、uni.setStorageSync

uni.setStorageSync是uniapp提供的封裝本地存儲方法，它可以方便地存儲任何類型的數據，並且將數據存儲到特定的路徑中。使用uni.setStorageSync存儲數據有一個優勢，就是可以通過uni.vibrateShort()提示用戶數據已經存儲成功。uni.setStorageSync的存儲路徑有兩種方式：

1、uni.setStorageSync(key, value)：將數據存儲在uniapp自定義的存儲路徑中；

2、uni.setStorageSync({key: ”, data: ”})：將數據存儲在指定的路徑中，可以是本地文件路徑或是應用緩存路徑。

// 存儲數據到默認路徑
uni.setStorageSync('key', 'value');

// 存儲數據到指定路徑
uni.setStorageSync({
  key: 'path/to/file',
  data: 'Hello, World'
});

四、uni.getStorageSync

uni.getStorageSync是uniapp提供的讀取本地存儲數據的方法，它可以方便地讀取指定路徑下的數據，並將數據以Object形式返回。使用uni.getStorageSync讀取數據也有一個優勢，就是可以通過uni.showToast()方法提示用戶數據讀取成功。uni.getStorageSync讀取數據的路徑與uni.setStorageSync存儲數據的路徑是一樣的，使用方法如下：

// 從默認路徑中獲取數據
let value = uni.getStorageSync('key');

// 從指定路徑中獲取數據
let data = uni.getStorageSync({
  key: 'path/to/file',
  success: function(res) {
    uni.showToast({
      title: '數據讀取成功'
    });
  }
});

五、uni.removeStorageSync

uni.removeStorageSync是uni提供的刪除指定路徑下的本地存儲數據的方法。數據刪除之後，通過uni.getStorageSync無法再次讀取該數據。uni.removeStorageSync的使用方法與uni.getStorageSync、uni.setStorageSync的使用方法非常相似，只需要傳入要刪除的數據的路徑即可：

// 刪除指定路徑下的數據
uni.removeStorageSync({
  key: 'path/to/file',
  success: function(res) {
    uni.showToast({
      title: '數據刪除成功'
    });
  }
});

六、總結

通過以上的介紹，我們可以看到uniapp提供了非常完善的本地存儲機制，並且API使用非常簡單。在實際開發中，我們可以根據實際需求選擇存儲方式，進行數據的存取操作。當然，uniapp提供的本地存儲方式只是我們了解的冰山一角，在實際開發中我們還有更多的方案來進行數據的存取操作，需要我們不斷地學習和探索。