浅念
93 lines
2.7 KiB
TypeScript
93 lines
2.7 KiB
TypeScript
/**
|
||
* 用户同步页轮询逻辑（纯函数/可注入依赖，vitest 用 fake timers 覆盖）
|
||
*
|
||
* - waitSyncTerminal：手动补拉 202 受理后等待批次离开 running（间隔轮询 +
|
||
* 超时上限；终态即 resolve，避免页面无限转圈）
|
||
* - createAutoRefresh：页面打开期间的定时状态刷新（10s）；立即执行一次 +
|
||
* 间隔触发 + 重入保护（慢响应不堆叠）+ 幂等 start/stop（组件
|
||
* onUnmounted 清理，防路由离开后仍在请求）
|
||
*/
|
||
|
||
export interface WaitSyncOptions {
|
||
/** 轮询间隔（默认 1.5s：批次通常秒级完成） */
|
||
intervalMs?: number
|
||
/** 总超时（默认 45s：超过视为异常，交调用方展示错误） */
|
||
timeoutMs?: number
|
||
}
|
||
|
||
const DEFAULT_INTERVAL_MS = 1500
|
||
const DEFAULT_TIMEOUT_MS = 45_000
|
||
|
||
function delay(ms: number): Promise<void> {
|
||
return new Promise((resolve) => setTimeout(resolve, ms))
|
||
}
|
||
|
||
/**
|
||
* 轮询同步状态直到批次离开 running（首次查询即终态则立刻 resolve）。
|
||
* 超时 reject（Error.message = 'timeout'）；fetchStatus 的网络错误向上抛。
|
||
*/
|
||
export function waitSyncTerminal(
|
||
fetchStatus: () => Promise<Api.UserSync.Status>,
|
||
options: WaitSyncOptions = {}
|
||
): Promise<Api.UserSync.Status> {
|
||
const intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS
|
||
const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS
|
||
const deadline = Date.now() + timeoutMs
|
||
return (async function poll(): Promise<Api.UserSync.Status> {
|
||
const status = await fetchStatus()
|
||
if (status.state !== 'running') return status
|
||
if (Date.now() >= deadline) {
|
||
throw new Error('timeout')
|
||
}
|
||
await delay(intervalMs)
|
||
return poll()
|
||
})()
|
||
}
|
||
|
||
export interface AutoRefreshHandle {
|
||
/** 开始（立即执行一次 + 间隔触发；重复调用幂等） */
|
||
start: () => void
|
||
/** 停止并清理定时器（重复调用幂等） */
|
||
stop: () => void
|
||
/** 是否在刷新周期内 */
|
||
isRunning: () => boolean
|
||
}
|
||
|
||
/**
|
||
* 周期刷新：start 立即触发一次；执行中的回调未完成时不堆叠下一次。
|
||
* 返回的 handle 由组件持有，onUnmounted 时 stop()。
|
||
*/
|
||
export function createAutoRefresh(
|
||
fn: () => void | Promise<unknown>,
|
||
intervalMs = 10_000
|
||
): AutoRefreshHandle {
|
||
let timer: ReturnType<typeof setInterval> | null = null
|
||
let inFlight = false
|
||
|
||
async function run(): Promise<void> {
|
||
if (inFlight) return
|
||
inFlight = true
|
||
try {
|
||
await fn()
|
||
} finally {
|
||
inFlight = false
|
||
}
|
||
}
|
||
|
||
return {
|
||
start() {
|
||
if (timer !== null) return
|
||
void run()
|
||
timer = setInterval(() => void run(), intervalMs)
|
||
},
|
||
stop() {
|
||
if (timer === null) return
|
||
clearInterval(timer)
|
||
timer = null
|
||
},
|
||
isRunning() {
|
||
return timer !== null
|
||
}
|
||
}
|
||
}
|