介绍
通过 typescript 编写对浏览器存储方法封装,可以进行数据加密
封装的方法有 localStorage、sessionStorage、cookie
cookie 是使用 js-cookie, 具体可以看官方文档
安装
sh
# npm
npm i l-browser-storage
# yarn
yarn add l-browser-storage使用
tsx
// ES
import { local, session, cookie } from "l-browser-storage";
// CommonJS
const { local, session, cookie } = require("l-browser-storage");Local
localStorage 本地存储
set(key, value, options)
设置存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
| value | any | 设置的 value | 是 | - |
| options | object | 额外的选项 | 否 | - |
options
额外选项的参数
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| encode | boolean | 是否加密 | 否 | - |
| duration | number | 有效时间 | 否 | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 设置的数据 |
example
示例
tsx
import { local } from "l-browser-storage";
local.set("userinfo", { name: "LiuYang", age: 21 }, { encode: true, duration: 60000 });get(key, options)
获取存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
| options | object | 额外的选项 | 否 | - |
options
额外选项的参数
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| decode | boolean | 是否解析 | - | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 返回的数据 |
example
示例
tsx
import { local } from "l-browser-storage";
local.get("userinfo", { decode: true });remove(key)
删除存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 删除的数据 |
example
示例
tsx
import { local } from "l-browser-storage";
local.remove("userinfo");clear()
清空存储
example
示例
tsx
import { local } from "l-browser-storage";
local.clear();Session
set(key, value, options)
设置存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
| value | any | 设置的 value | 是 | - |
| options | object | 额外的选项 | 否 | - |
options
额外选项的参数
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| encode | boolean | 是否加密 | 否 | - |
| duration | number | 有效时间 | 否 | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 设置的数据 |
example
示例
tsx
import { session } from "l-browser-storage";
session.set("userinfo", { name: "LiuYang", age: 21 }, { encode: true, duration: 60000 });get(key, options)
获取存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
| options | object | 额外的选项 | 否 | - |
options
额外选项的参数
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| decode | boolean | 是否解析 | - | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 返回的数据 |
example
示例
tsx
import { session } from "l-browser-storage";
session.get("userinfo", { decode: true });remove(key)
删除存储
参数说明
| 属性值 | 类型 | 描述 | 必填 | 默认值 |
|---|---|---|---|---|
| key | string | 设置的 key | 是 | - |
return
返回值
| 属性值 | 类型 | 描述 |
|---|---|---|
| code | number | 状态码 |
| data | any | 删除的数据 |
example
示例
tsx
import { session } from "l-browser-storage";
session.remove("userinfo");clear()
清空存储
example
示例
tsx
import { session } from "l-browser-storage";
session.clear();Cookie
cookie 本地存储
官方文档:链接点我
状态码
| 错误码 | 描述 |
|---|---|
| 10000 | 成功 |
| 10001 | 失败 |
| 10002 | 值为空 |
| 10003 | 不存在 |
| 10004 | 已过期 |