/** * 读数对象的**稳定引用**(票 98)。 * * ## 为什么需要 * * 外壳有一颗 500ms 的归位轮询,每轮把 `getAreaLimits()` / `getFogState()` 的返回值写进 ref。 * 这两个函数**每次都返回新对象** ⇒ ref 每 500ms 被写入一次 ⇒ 整个外壳 2Hz 重渲染。 * 模板很大(四模式面板 + 顶栏 + 地图叠层),而内容其实早就没变 —— 这是白烧帧预算。 * * 做法:按**值的序列化键**缓存。键没变就返回上一次那个对象(引用稳定 ⇒ Vue 的 ref 写入 * 因为 Object.is 相等而不触发重渲染);真的变了才造新对象。 * * ## 边界 * * 只适合**纯读数**:输出完全由当前状态决定、不含时间戳/随机量。 * 若读数里有 `Date.now()` 之类易变字段,键每次都会变 —— 缓存不帮忙,但也不会给出错值。 */ /** * 值的比较键:标量直接转字符串,对象走 JSON(字段顺序由产出方固定,稳定)。 * @param {*} value * @returns {string|null} 无法序列化时回 null(调用方据此退化为"总是重算") */ export function readoutKey(value) { if (value === null || typeof value !== 'object') return String(value) try { return JSON.stringify(value) } catch { return null } } /** * 把读数函数包成"值不变就返回同一对象"的版本。 * @param {() => any} produce 产出读数(必须是纯读数,见文件头) * @returns {() => any} */ export function createStableReadout(produce) { let lastKey = null let lastValue = null let primed = false return function stableReadout() { const nextValue = produce() const nextKey = readoutKey(nextValue) // 键拿不到(循环引用等)就老老实实交新对象,不猜。 if (primed && nextKey !== null && nextKey === lastKey) return lastValue lastKey = nextKey lastValue = nextValue primed = true return lastValue } }