yux-storage 是一个基于 HTML5 IndexedDB 封装的 Web 本地数据离线存储库。
- 使用类似 localStorage API, 无需考虑 IndexedDB 的复杂概念,上手无压力。
- 支持回调和 Promise 两种方式,各凭所愿。
- 非常轻量,100 行左右的源码,压缩后更小。
以下是继承 IndexedDB 的特点
- 可以存储多种类型的数据,而不仅仅是字符串。
- 储存空间大,一般来说不少于 250MB,甚至没有上限。
- 异步操作,在进行大量数据存取时不会阻塞应用程序。
- 直接在 github 获取 yux-storage.js
<script src="yux-storage.js"></script>
- 直接使用 unpkg 在线链接
<script src="https://unpkg.com/yux-storage"></script>
- 通过 npm 安装
npm i yux-storage
通过 script 引用,会得到一个全局变量 yuxStorage
通过 npm 安装,需要 import 导入
import yuxStorage from 'yux-storage';
在页面中使用
// 回调函数
yuxStorage.getItem('key',function(err,value){
if (err) {
console.log('出错了')
} else {
console.log(value)
}
})
// 同样支持promise
yuxStorage.setItem('key').then(doSomethingElse)
// 如果你的环境支持async,那么
const value = await yuxStorage.getItem('key')
console.log(value)
获取或设置离线仓库中的数据的 API。风格参考 localStorage API
yuxStorage.getItem(key, callback)
从仓库中获取 key 对应的值并将结果提供给回调函数。如果 key
不存在,getItem()
将返回 null
。
所有回调函数的第一个参数为错误标识,如果为
true
,说明出错
示例
yuxStorage.getItem('somekey').then(function(value) {
// 当离线仓库中的值被载入时,此处代码运行
console.log(value);
})
// async版本:
const value = await yuxStorage.getItem('somekey');
// 当离线仓库中的值被载入时,此处代码运行
console.log(value);
// 回调版本:
yuxStorage.getItem('somekey', function(err,value) {
// 当离线仓库中的值被载入时,此处代码运行
console.log(err, value);
});
yuxStorage.setItem(key, value, callback)
将数据保存到离线仓库。你可以存储如下类型的 JavaScript 对象:
- Array
- ArrayBuffer
- Blob
- Float32Array
- Float64Array
- Int8Array
- Int16Array
- Int32Array
- Number
- Object
- Uint8Array
- Uint8ClampedArray
- Uint16Array
- Uint32Array
- String
可能不太完整,理论上支持任意格式的数据
示例
yuxStorage.setItem('somekey', 'some value').then(function (value) {
// 当值被存储后,可执行其他操作
console.log(value);
})
// 不同于 localStorage,你可以存储非字符串类型
yuxStorage.setItem('my array', [1, 2, 'three']).then(function(value) {
// 如下输出 `1`
console.log(value[0]);
})
// 键名也可以是非字符串,比如一个数组
yuxStorage.setItem([1,2,3], [1, 2, 'three'])
// 还可以存储 file 文件
const file = new File(["foo"], "foo.txt", {
type: "text/plain",
});
yuxStorage.setItem('file', file)
yuxStorage.removeItem(key, callback)
从离线仓库中删除 key 对应的值。
示例
yuxStorage.removeItem('somekey').then(function() {
// 当值被移除后,此处代码运行
console.log('Key is cleared!');
})
yuxStorage.clear(callback)
从数据库中删除所有的 key,重置数据库。
!小心使用,其实就是遍历,然后执行 REMOVEITEM
示例
yuxStorage.clear().then(function() {
// 当数据库被全部删除后,此处代码运行
console.log('Database is now empty.');
})
yuxStorage.key(keyIndex, callback)
根据 key 的索引获取其名
有些鸡肋的方法,很多时候我们不知道键的索引。
示例
yuxStorage.key(2).then(function(keyName) {
// key 名
console.log(keyName);
})
yuxStorage.keys(callback)
获取数据仓库中所有的 key。
localStorage API 并没有这个方法,但比上面的 key 要有用的多。
示例
yuxStorage.keys().then(function(keyNames) {
// 所有的key名
console.log(keyNames);
})
现代浏览器,包括移动端,不支持 IE
有相关问题或者意见可与我联系 yanwenbin@yuewen.com