lstore 是 localStorage 的一个工具类,支持 AMD 规范
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dist
src
.gitignore
LICENSE
README.md
gulpfile.js
package.json

README.md

lstore

lstore 是利用 HTML5 的新特性实现的一个本地存储的类库,支持 AMD 规范,支持高版本的浏览器,低版本 IE 不做支持,如 IE 6、7

API

属性
  • version: 版本号
  • isSupportStore:所在环境是否支持 localStorage
  • storage:localStorage 的引用
方法
set(key, val, opt) --- 设置要存储的数据
  • key 要存储数据的名称
  • val 要存储数据的值
  • opt 对象,可选参数。如:{excludeRm : true} 默认当 localStorage 数据存储满的时候,会删除 5 条旧数据,用了腾出空间来存储新数据,当值为 true 时,该数据不会被清理,当为 false 时,有可能会被清理。
  • 失败返回 false
lstore.set('a',{a:'aa'});
lstore.set('b','bb');
lstore.set('c', 'cc', {excludeRm : true});
get(key, defaultVal) --- 获取所存储的数据
  • key:要获取数据的名称
  • defaultVal:若要获取的数据不存在或已过去可指定默认值
lstore.get('a');
lstore.get('d', 'defaultVal');
remove(key) --- 删除已存储的数据
  • key:要删除数据的名称
lstore.remove('a');

注意这里删除的数据是忽略上文中提及的 excludeRm

has(key) --- 判断数据是否已存储
  • key:要判断数据的名称
lstore.has('a');
clear() --- 删除所有存储过的数据
lstore.clear();
lstore.expiration.set(key, val, exp) --- 设置要存储的数据,并指定有效时间
  • key 要存储数据的名称
  • val 要存储数据的值
  • exp 有效时间单位 ms
lstore.expiration.set('e', 'eeee', 1000);  // 1 秒后过期

结语

存储时的 key 可以增添一个前缀,降低冲突的可能性,在这没做处理,需要的可自行添加