readoutCache.js 2.0 KB

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