@lhvision/helpers

✨ 一些简单的工具函数封装 ✨

Install

pnpm add @lhvision/helpers

IMPORTANT: 从 2.0 开始移除了 CJS 产物只支持 ESM

helpers

默认导出为 browser.js shared.js 所有函数

import { } from '@lhvision/helpers'
import { } from '@lhvision/helpers/browser'
import { } from '@lhvision/helpers/shared'
import { } from '@lhvision/helpers/upload'

browser.js

工具函数集合，用于浏览器环境。

请求处理

• requestManager - 单例请求管理器
• request - 请求函数

全屏操作

• exitFullScreen - 退出全屏
• getFullScreenElement - 获取全屏元素
• isFullScreen - 判断是否全屏
• requestFullScreen - 请求全屏
• toggleFullScreen - 切换全屏状态
• onFullScreenChange - 监听全屏变化
• offFullScreenChange - 移除全屏监听

剪贴板

• copyText - 复制文本
• readText - 读取剪贴板文本
• pasteImage - 粘贴图片

下载

• downloadBlob - 下载 Blob 数据
• downloadUrl - 下载 URL
• streamDownload - 流式下载

其他

• watchVisibility - 监听页面可见性
• TabCommunication - 使用 BroadcastChannel 跨标签页通信
• getTokenPayload - 获取 Token 载荷
• isTokenExpiringSoon - 检查 Token 是否即将过期
• hexToRgb - 十六进制转 RGB
• rgbToHsl - RGB 转 HSL
• rgbToHsv - RGB 转 HSV
• AudioVisualizer - 音频可视化工具
• CenterTextRenderer - 居中文本渲染器
• getEyeDropperColor - 获取屏幕取色器颜色
• canvasToImage - 将 Canvas 转换为高清图片
• setTheme - 设置主题 dark 或 light
• initThemeListener - 初始化主题监听器，设置 dark 或 light 主题
• startViewTransition - document.startViewTransition api
• saveFileInBrowser - 保存文件到磁盘
• openFileInBrowser - 从磁盘读取文件

shared.js

通用工具函数。

流处理

• createBaseStream - fetch response.body..getReader() ReadableStreamDefaultReader 基础流处理
• createBinaryStream - 二进制流处理，使用迭代器的方式实现，for await (const chunk of createBinaryStream(response))
• createTextStream - 文本流处理，使用迭代器的方式实现
• createSSEStream - SSE 流处理，ai 对话 api 返回处理函数，使用迭代器的方式实现
• processByte - 字节处理

工具函数

• debounce - 防抖
• throttle - 节流
• pLimit - 并发限制

日期处理

• getTimeRemaining - 计算两个时间点之间的时间差
• formatCountdown - 格式化时间差显示
• getDayOfYear - 某一个日期在当年的第几天
• getMonthCalendar - 获取月历网格数据

其他

• AsyncLRUCache - 异步 LRU 缓存
• LRUCache - LRU 缓存
• eventBus - 单例事件总线，可以实现在响应拦截器中路由跳转等功能
• eventBusPromise - 简单的单发布订阅模式
• singleton - 使用 Proxy 代理模式实现单例模式

upload.js

文件上传相关功能，哈希计算功能基于 hash-wasm 实现。

哈希计算

• initHashWASM - 初始化 WASM
• calculateMD5 - 计算 MD5
• calculateStreamMD5 - 流式计算大文件 MD5
• calculateMD5WithWorker - Worker 方式计算 MD5
• calculateLargeFileMD5 - 智能选择方式计算大文件 MD5

分片处理

• calculateChunksMD5 - 计算文件分片 MD5
• calculateChunksMD5WithWorkers - Worker 并行计算分片 MD5

上传流程

• createFileHashStream - 创建文件哈希计算流
• hashStreamToUploadStream - 哈希流转上传流
• uploadFileInChunks - 通用分片上传流程

License

MIT License © 2024-PRESENT lhvision