LocalStorage
Introduction
让使用 localStorage 变得更简单
- 原生
localStorage只能存储字符串 - 对于复杂数据结构，在存储之前，必须先进行序列化
- 对于复杂数据结构，在读取的时候，又需要反序列化
- 直接操作数据，可能会对数据造成覆盖，中间最好有一层检测机制，保证数据的准确性
- 对于
查询当前剩余容量获取key列表等一些快捷操作，也做了封装
针对上述，对 localStorage 进行一次封装，默认对数据进行序列化、反序列化、覆盖提醒、快捷处理等操作，用户只需关心自己要保存、获取的数据的一系列操作。
Usage
ES6
import LS from 'n-localstorage';UMD
// download files
use n-localstorage/dist/localstorage.jsset(key, value, cover)
存储数据，返回 set 的对象
* set(key, value, cover = false)
* @params key
* @params value
* @params cover 是否覆盖
* return {
key: key,
val: value
}
Example:
LS.set('name', 'realign');
/**
return
{
key: 'name',
val: 'realign'
}
*/
get(key)
获取数据，返回 对应值（会保持原来的数据类型）
* get(key)
* return valye
Example:
LS.get('name'); // 'realign'
has(key)
判断是否存在此 key，返回 boolean
* has(key)
* return boolean
Example:
LS.has('name'); // true
LS.has('my'); // false
remove(key)
删除 key 对应的这条数据，
返回 boolean，该条数据是否仍存在
已成功删除 true（传入不存在的key，仍会返回 true）
未成功删除 false
* remove(key)
* return boolean
Example:
LS.remove('name'); // true
clear
清空当前域下 localstorage 数据
* clear()
* return boolean
Example:
LS.clear(); // true
getKeyList
获取 localstorage 所有 key
* getKeyList()
* return array 默认 []
Example:
LS.getKeyList(); // ['name', 'age']
getAll
获取 localstorage 所有 数据
* getAll()
* return object 默认 {}
Example:
LS.getAll(); // {'name': 'realign', 'age': 23}
getSurplusCapacityKb
保留，但会有误差，建议用下面的新 api { getSurplusCapacity }
获取 localstorage 剩余容量（kb）
* getSurplusCapacityKb()
* return number
Example:
LS.getSurplusCapacityKb(); // 5119.998046875
getSurplusCapacity
/** 获取 localstorage 剩余容量
* getSurplusCapacity(unit)
* @param unit => b | kb | mb
* @returns number
*/
// Example:
LS.getSurplusCapacity('kb'); // 4119.998046875
