Appearance
Utils
@qxs-bns/utils 提供日期处理、设备检测、上传、存储、请求等通用工具函数,适合按需导入使用。
安装
bash
pnpm add @qxs-bns/utils基础引入
ts
import { DateTransfer, Storage } from '@qxs-bns/utils'
const storage = new Storage('demo_')
const dateText = DateTransfer.format(new Date(), 'YYYY-MM-DD')推荐始终使用 named import,便于 Tree Shaking。useApi、FetchApiService 等请求工具会依赖 axios 或 ky,按实际用法安装对应依赖。
上传相关工具接入前,需要先准备业务侧的凭证或接口能力。
工具概览
| 工具 | 说明 | 文档 |
|---|---|---|
| ArgoLog | 日志工具 | ✅ |
| Storage | 本地存储 | ✅ |
| DateTransfer | 日期处理 | ✅ |
| Device | 设备检测 | ✅ |
| FileOperations | 文件操作 | ✅ |
| UseApi | API 请求封装 | ✅ |
| OssUploader | OSS 上传 | ✅ |
| Watermark | 水印工具 | ✅ |
适用场景
- 日期、设备、文件、存储等通用业务逻辑。
- 需要统一日志、请求封装和上传流程的项目。
- 希望把工具函数独立于 UI 组件使用的场景。
使用建议
- 工具库适合和
@qxs-bns/components或@qxs-bns/hooks组合使用。 - 如果只需要少量能力,优先按需导入单个工具,而不是整包命名空间导入。
- 请求和上传能力通常还需要业务侧接口、鉴权或上传凭证配合。