@chonglou_/storage v1.0.8-beta.0

@variety/storage

开箱即用的浏览器本地持久化数据缓存工具，并且可开启数据加密，支持 sessionStorage, localStorage, indexedDB 等本地存储

特性

• 1. 支持 sessionStorage, localStorage，indexedDB 三个位置存储，并且提供数据加密
• 2. ts 开发支持智能的类型语法提示
• 3. hooks 思维，只提供便捷的钩子函数
• 2. 基于 pnpm

安装

# 安装工具
pnpm add @variety/storage -S

API

useEncrypt

AES 非对称数据加密

//加密数据
let encrypt =  useEncrypt({ name: 'xiaoming' })

useDecrypt

AES 非对称数据解密

//加密数据
let encrypt = useEncrypt({ name: 'xiaoming' })
let object = useDecrypt(encrypt)

useBase64Encrypt

BASE64 数据加密

//加密数据
let encrypt =  useBase64Encrypt({ name: 'xiaoming' })

useBase64Decrypt

BASE64 数据解密

//加密数据
let encrypt = useEncrypt({ name: 'xiaoming' })
let object = useDecrypt(encrypt)

useSetStorage

设置本地缓存数据

options

//存储数据
useSetStorage({
  isEncrypt: true,
  storage: 'localStorage',
  data: {
    key: '__TEST_DATA__',
    value: { name: 'xiaoming' , expire: 32}
  }
})

useGetStorage

获取缓存数据(过期数据删除本地缓存，并返回 null)

options

//存储数据
useSetStorage({
  isEncrypt: true,
  storage: 'localStorage',
  data: {
    key: '__TEST_DATA__',
    value: { name: 'xiaoming' , expire: 32}
  }
})

//获取本地数据
let state = useGetStorage({
  isEncrypt: true,
  storage: 'localStorage',
  key: '__TEST_DATA__'
})

useRemoveStorage

删除本地缓存数据

options

//删除本地数据
let state = useRemoveStorage({
  storage: 'localStorage',
  key: '__TEST_DATA__'
})

useClearStorage

清空本地缓存

//删除本地数据
let state = useClearStorage('localStorage')

useOpenDataBase

打开数据库，并返回 Promise，数据库对象 db

options

注： 由于indexedDB的表建立是在数据库升级的时候才允许创建，也就是versionchange的事件。所以新建表的逻辑，也是更
新数据库的版本号

//打开数据库，并新建variety-table表
useOpenDataBase({
  version: 1.0,
  dbName: 'variety-indexdb',
  storeName: 'variety-table'
}).then(db => {
 console.log('数据库对象', db)
})

useCloseDataBase

关闭数据库

//打开数据库，并新建variety-table表
let db = await useOpenDataBase({
  version: 1.0,
  dbName: 'variety-indexdb',
  storeName: 'variety-table'
})

//关闭数据库
useCloseDataBase(db)

useDeleteDataBase

删除数据库

//打开数据库，并新建variety-table表
let db = await useOpenDataBase({
  version: 1.0,
  dbName: 'variety-indexdb',
  storeName: 'variety-table'
})

//关闭数据库
useDeleteDataBase(‘variety-indexdb’)

useSetDataStore

添加数据到数据表，返回 Promise，是 boolean

options

//添加数据到数据库，只针对新增的数据
useSetDataStore({
  isEncrypt: true,
  dbName: 'variety-indexdb',
  storeName: 'variety-table',
  data: { id: '3243124132432', value: 'xiamiung' }
})

useUpdateDataStore

更新数据到数据表 ，返回 Promise，是 boolean

options

//更新或者添加新的数据到数据库
useUpdateDataStore({
  isEncrypt: true,
  dbName: 'variety-indexdb',
  storeName: 'variety-table',
  data: { id: '3243124132432', value: 'xiamiung' }
})

useGetDataStore

根据主键 id 获取数据，返回 Promise, result 为存储的数据对象

options

//更新或者添加新的数据到数据库
useGetDataStore({
  isEncrypt: true,
  dbName: 'variety-indexdb',
  storeName: 'variety-table',
  id: '3243124132432'
}).then(data => {
  console.log('数据库存储的数据', data)
})

useRemoveDataStore

根据主键 id 获取数据，返回 Promise，是 boolean

options

//更新或者添加新的数据到数据库
useRemoveDataStore({
  dbName: 'variety-indexdb',
  storeName: 'variety-table',
  id: '3243124132432'
})