[go: up one dir, main page]

si-store

0.1.2 • Public • Published

si-store

一个基于 Web Storage 的存储库,提供简单的api操作,可以设置缓存时间

安装

用 npm 安装

npm install si-store --save

直接在 script 标签中导入,先要在github 上下载代码,然后:

<script src="si-store.js" charset="utf-8"></script>

开始使用

import store from 'si-store'  // ES6 可以这么写
 
var store = require('si-store') // commonJs 规范写法
 
// 如果是script 标签引入的可以不用管,直接使用store对象即可
 
store.set('test1', 'this is value')  // 存储字符串
store.set('test2', {
  key: 'this is test'
})                                   // 也可以存储对象
 
store.get('test1')                   //  获取存储的值 this is value
 
store.remove('test2')                // 删除key为 test2的存储

设置过期时间

store.set('test', 'test value',  30)   // 设置过期时间在30ms之后
 
setTimeout(function () {
  store.get('test')                    // null
}, 31)

新建一个新的缓存实例

var newStore = store.create({
  id: 'iStore',            // id 必需 每一个存储实例的唯一值
  expires: 10 * 1000 * 60, // 默认缓存时间,以毫秒为单位,设为null 不限时间
  storage: 'local'         // 用那种储存方式, local => localStorage, session => sessionStorage 目前只支持者两种
})

遍历和清空存储

store.clear()           //清空当前实例下存储的所有数据
store.forEach(function (value, key) {
    console.log(key, value)
}) // 遍历当前实例下存储的所有的数据
 
let allObj = store.getAll()    //获取所有存储的数据 返回一个 Object

API

set([key, value, expires])

存储数据

  • key 存储数据的key,获取时根据key获取
  • value 储存的数据, 不限制类型
  • expires 过期时间,不设置默认是永不过期

get([key])

根据 key 获取存储的数据

remove([key])

删除缓存的数据

has([key])

判断某一个key 在当前实例下是否存在

getAll()

获取所有的缓存的数据, 返回一个 Object 对象, 例: {key1: '', key2: ''}

clear()

清除当前实例下存储的所有的数据

forEach([callback])

遍历当前实例下存储的所有数据

  • callback function 遍历的回调函数 例:store.forEach(function (value, key) { // ... })

create([options])

创建一个新的存储实例, 只有全局 store才具有的方法。

options 是一个 Object, 支持以下参数

  • id 必须,当前实例的id,唯一值不可重复
  • expires 默认过期时间
  • storage 存储方式 'local'/'session' 默认是 'local'

下一步要做的

  • 支持存储数量的限制
  • 支持多个key的get
  • 支持异步的storage 例如 indexDB 这些的支持

License

MIT

Copyright (c) 2016 myron

Readme

Keywords

Package Sidebar

Install

npm i si-store

Weekly Downloads

3

Version

0.1.2

License

MIT

Last publish

Collaborators

  • myronliu347