uni-halo/.agents/bak-skills/uniappx-project/examples/api/storage/set-storage.md

uni.setStorage - 数据存储示例

官方文档

参考官方文档：https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstorage

概述

uni.setStorage 用于将数据存储在本地缓存中指定的 key 中，异步接口。

基础用法

uni.setStorage({
  key: 'userInfo',
  data: {
    name: 'John',
    age: 30
  },
  success: () => {
    console.log('存储成功')
  },
  fail: (err) => {
    console.error('存储失败', err)
  }
})

完整示例

示例 1: 存储用户信息

// 存储用户信息
const userInfo = {
  id: 1,
  name: 'John Doe',
  email: 'john@example.com',
  avatar: 'https://example.com/avatar.jpg'
}

uni.setStorage({
  key: 'userInfo',
  data: userInfo,
  success: () => {
    uni.showToast({
      title: '保存成功',
      icon: 'success'
    })
  },
  fail: (err) => {
    uni.showToast({
      title: '保存失败',
      icon: 'none'
    })
  }
})

示例 2: 存储字符串

uni.setStorage({
  key: 'token',
  data: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
  success: () => {
    console.log('Token 已保存')
  }
})

示例 3: 存储数组

const shoppingCart = [
  { id: 1, name: '商品1', price: 99 },
  { id: 2, name: '商品2', price: 199 }
]

uni.setStorage({
  key: 'shoppingCart',
  data: shoppingCart,
  success: () => {
    console.log('购物车已保存')
  }
})

示例 4: 封装存储函数

// utils/storage.js
const storage = {
  set(key, data) {
    return new Promise((resolve, reject) => {
      uni.setStorage({
        key: key,
        data: data,
        success: () => {
          resolve()
        },
        fail: (err) => {
          reject(err)
        }
      })
    })
  },
  
  get(key) {
    return new Promise((resolve, reject) => {
      uni.getStorage({
        key: key,
        success: (res) => {
          resolve(res.data)
        },
        fail: (err) => {
          reject(err)
        }
      })
    })
  }
}

// 使用
storage.set('userInfo', { name: 'John' })
  .then(() => {
    console.log('存储成功')
  })
  .catch(err => {
    console.error('存储失败', err)
  })

同步版本

使用 uni.setStorageSync 进行同步存储：

try {
  uni.setStorageSync('userInfo', {
    name: 'John',
    age: 30
  })
  console.log('存储成功')
} catch (err) {
  console.error('存储失败', err)
}

注意事项

1. 存储的数据会被持久化，除非手动删除或清除缓存
2. 单个 key 允许存储的最大数据长度为 1MB
3. 异步接口不会阻塞后续代码执行
4. 建议使用 try-catch 处理同步接口的错误

参考资源

• 官方文档: https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstorage
• 同步版本: https://doc.dcloud.net.cn/uni-app-x/api/storage/storage.html#setstoragesync