介绍

一个用于管理 cookies 和本地/会话存储的实用工具库，支持可选的加密功能。

目录

• 安装
• 使用说明
  • Cookies
  • 存储
• API
  • Cookies API
  • 存储 API
• 贡献
• 许可证

安装

可以使用 npm 或 yarn 安装这个库：

npm install @coderlzw/store
# or
yarn add @coderlzw/store
# or
pnpm add @coderlzw/store

使用说明

Cookies

import {cookie} from '@coderlzw/store';

// 示例 1: 设置单个 Cookie
cookie.setCookie({
    key: 'userToken',
    value: 'abc123',
    expires: 'Fri, 31 Dec 2024 23:59:59 GMT',
    maxAge: 3600, // 1 小时
    path: '/',
    domain: 'example.com',
    secure: true
});

// 示例 2: 批量设置 Cookies
cookie.setCookies([
    {
        key: 'sessionID',
        value: 'xyz456',
        expires: 'Fri, 31 Dec 2024 23:59:59 GMT',
        path: '/'
    },
    {
        key: 'preferences',
        value: 'darkMode=true',
        path: '/'
    }
]);

// 示例 3: 获取单个 Cookie
const userToken = cookie.getCookie('userToken');

// 示例 4: 获取多个 Cookies
const cookies = cookie.getCookies(['sessionID', 'preferences']);

// 示例 5: 删除单个 Cookie
const isRemoved = cookie.removeCookie('userToken');

// 示例 6: 删除多个 Cookies
const areRemoved = cookie.removeCookies(['sessionID', 'preferences']);

// 示例 7: 清空所有 Cookies
const isCleared = cookie.clearCookies();

存储

import {storage, StorageTypeEnum, CryptoJS} from "@coderlzw/store";

// 示例数据
const secretKey = "mySecretKey";

// 1. 存储数据到 sessionStorage（加密）
storage.setStorage({
    key: "userSession",
    value: {username: "JohnDoe", role: "admin"},
    type: StorageTypeEnum.Session,
    expire: 3600000, // 1小时过期
    encrypt: true,
    secretKey: secretKey
});

// 2. 存储数据到 localStorage（未加密）
storage.setStorage({
    key: "userPreferences",
    value: {theme: "dark", language: "en"},
    type: StorageTypeEnum.Local,
    expire: 86400000, // 1天过期
    encrypt: false
});

// 3. 获取 sessionStorage 中的加密数据
const userSession = storage.getStorage<{ username: string; role: string }>({
    key: "userSession",
    type: StorageTypeEnum.Session,
    secretKey: secretKey
});

// 4. 获取 localStorage 中的未加密数据
const userPreferences = storage.getStorage<{ theme: string; language: string }>({
    key: "userPreferences",
    type: StorageTypeEnum.Local
});

// 5. 获取 sessionStorage 中所有数据
const allSessionStorage = storage.getAllStorage(StorageTypeEnum.Session);

// 6. 获取 localStorage 中所有数据
const allLocalStorage = storage.getAllStorage(StorageTypeEnum.Local);

// 7. 删除 sessionStorage 中的某个键值对
storage.removeStorage({key: "userSession", type: StorageTypeEnum.Session});

// 8. 清空 localStorage
storage.clearStorage(StorageTypeEnum.Local);

API

Cookies API

• setCookie(options: CookieOptions): boolean：设置一个 cookie，返回 true 表示成功设置 cookie，否则返回 false。
  • key: Cookie 的名称。
  • value: Cookie 的值。
  • expires（可选）：Cookie 的过期时间。
  • maxAge（可选）：Cookie 的最大存活时间，单位为秒。
  • path（可选）：Cookie 的路径。
  • domain（可选）：Cookie 的域名。
  • secure（可选）：是否为安全 cookie。
• getCookie(key: string): string | null：获取指定名称的 cookie 值。返回 cookie 的值或 null（如果 cookie 不存在）。
• removeCookie(key: string): boolean：删除指定名称的 cookie。返回 true 表示成功删除 cookie，否则返回 false。
• clearCookies(): boolean：清空所有 cookies。返回 true 表示成功清空所有 cookies，否则返回 false。

Storage API

• setStorage(data: StorageData<K, V>): void：设置一个存储值，支持可选的加密功能。

  • key: 存储键。
  • value: 存储值。
  • type: 存储类型 (sessionStorage 或 localStorage)。
  • expire（可选）：过期时间，单位为毫秒。
  • encrypt（可选）：是否加密存储值。
  • secretKey（可选）：加密密钥。

• getStorage(params: { key: K; type: StorageTypeVal; secretKey?: string; }): V | null：从存储中获取一个值。返回存储的值或 null（如果项不存在或已过期）。

  • key: 存储键。
  • type: 存储类型 (sessionStorage 或 localStorage)。
  • secretKey（可选）：解密密钥。

• removeStorage(params: { key: string; type: StorageTypeVal; }): void：删除存储项。

  • key: 存储键。
  • type: 存储类型 (sessionStorage 或 localStorage)。

• clearStorage(type: StorageTypeVal): void：清空指定存储类型中的所有项。

贡献

如果你希望为这个项目做出贡献，请在 GitHub 上提交 Issues 或 Pull Requests。

许可证

该项目使用 MIT 许可证 - 详情请参阅 LICENSE 文件。