/** * 任务队列在工具页之间的共享纯逻辑(2026-09 全维度审查 G3)。 * * 7 个工具页(query-asin / withdraw / price-track / product-risk / patrol-delete / shop-match / * shop-data-crawl)各有一份逐字重复的「任务开始时间 localStorage 持久化 + 记录缺失错误判定」实现。 * 这里先收敛**无副作用、无页面状态依赖**的部分:序列化/反序列化校验、开始时间表增删、 * 记录缺失错误判定。队列 worker 的状态机(谁在跑、防抖、轮询句柄)仍留在各页, * 那部分抽取需要真机走一遍队列流程,另行处理。 */ /** 反序列化:只保留正整数 taskId 与非空字符串时间戳,形状不符的条目丢弃。 */ export function parseTaskStartTimes(raw: string | null | undefined): Record { if (!raw) { return {} } let parsed: unknown try { parsed = JSON.parse(raw) } catch { return {} } const next: Record = {} for (const [taskId, value] of Object.entries((parsed || {}) as Record)) { const numericTaskId = Number(taskId) if (!Number.isFinite(numericTaskId) || numericTaskId <= 0) continue if (typeof value !== 'string' || !value.trim()) continue next[numericTaskId] = value } return next } /** 写入/覆盖某个任务的开始时间(返回新对象,不修改入参)。 */ export function upsertTaskStartTime( current: Record | null | undefined, taskId: number, startedAt: string, ): Record { if (!Number.isFinite(taskId) || taskId <= 0) { return { ...(current || {}) } } return { ...(current || {}), [taskId]: startedAt } } /** 移除某个任务的开始时间(不存在时返回原对象的浅拷贝)。 */ export function removeTaskStartTime( current: Record | null | undefined, taskId?: number | null, ): Record { const base = { ...(current || {}) } if (!taskId || !(taskId in base)) { return base } delete base[taskId] return base } /** * 后端「记录不存在」类错误的判定:历史/任务已被删除时,各页据此清理本地缓存并停止轮询。 * 匹配口径与各页原实现一致(含中文关键词与 HTTP 404 / not found)。 */ export function isRecordMissingError(error: unknown): boolean { const message = error instanceof Error ? error.message : String(error || '') return /记录不存在|任务不存在|不存在|已删除|not\s*found|404/i.test(message) }