| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 |
- /**
- * 读数对象的**稳定引用**(票 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
- }
- }
|