Utils

packages/utils 提供各 H5 應用共享的工具函式，內部聚合了 @vh5-core/shared 的快取和工具模組。

非同步錯誤處理

to()

消除 try/catch 巢狀，將 Promise 轉為 [error, data] 元組：

import { to } from '@vh5/utils';

const [err, data] = await to(getProductList());
if (err) {
  console.error('請求失敗', err);
  return;
}
console.log(data);

進度條

import { startProgress, stopProgress } from '@vh5/utils';

router.beforeEach(() => startProgress());
router.afterEach(() => stopProgress());

全域 Loading

unmountGlobalLoading()

移除 HTML 中注入的全域骨架屏 loading，帶 fade-out 過渡：

import { unmountGlobalLoading } from '@vh5/utils';
unmountGlobalLoading();

日期格式化

import { formatDate, formatDateTime } from '@vh5/utils';

formatDate(new Date()); // '2024-01-01'
formatDateTime(new Date()); // '2024-01-01 12:00:00'

快取管理

StorageManager

帶前綴和過期時間的 localStorage 封裝：

import { StorageManager } from '@vh5/utils';

const storage = new StorageManager({ prefix: 'my-app-' });
storage.setItem('token', 'xxx', 7 * 24 * 60 * 60 * 1000);
const token = storage.getItem('token');

其他工具

函式	說明
cloneDeep()	深拷貝（lodash.clonedeep）
get() / set()	物件路徑讀寫（es-toolkit）
isEqual()	深比較（es-toolkit）
cn()	合併 CSS 類名（clsx + tailwind）
openWindow()	安全開啟新視窗
generateTree()	陣列轉樹狀結構