跳到主要内容
api工厂
JavaScript

Map.getOrInsert / getOrInsertComputed:告别 has+get+set 三段式

api工厂资讯栏目 约 6 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:Map.prototype.getOrInsert 与 getOrInsertComputed(Upsert 提案)已走到 Stage 4 并纳入 ES2026,随 V8 14.6 落地:Node.js 26 默认可用,Chrome / Edge 145(2026 年 2 月)起支持。「查不到就插默认值」这个最高频的 Map 操作,从此告别 has + get + set 三段式。本文讲清两个方法的语义差异、惰性求值的价值、WeakMap 支持与旧环境降级写法。

三段式的痛:每个前端都写过

词频统计、分组聚合、缓存初始化,都绕不开同一个模式:

js
const counts = new Map();
for (const word of words) {
  if (!counts.has(word)) counts.set(word, 0);
  counts.set(word, counts.get(word) + 1);
}

三行代码里藏着两次甚至三次哈希查找,还有「默认值被提前构造」的浪费:如果默认值是 new Array() 或一次昂贵计算,哪怕键已存在也会白白执行。社区为此发明过各种 getOrDefault 工具函数,现在标准答案来了。

getOrInsert:存在即返回,不存在即插入

js
const m = new Map();
m.getOrInsert('k', 42); // 键不存在:插入 42 并返回 42
m.getOrInsert('k', 999); // 键已存在:返回 42,不覆盖

语义要点:第二参数是「值」,无论键是否存在都会被求值;已存在时绝不覆盖,这与「upsert 会更新」的直觉不同,它只做 insert-if-absent。词频统计可以简化成:

js
for (const word of words) {
  counts.set(word, counts.getOrInsert(word, 0) + 1);
}

getOrInsertComputed:默认值惰性计算

第二参数换成回调,只有键不存在时才执行,这是两个方法最关键的区别:

js
const cache = new Map();
function getConfig(userId) {
  return cache.getOrInsertComputed(userId, () => {
    return buildExpensiveConfig(userId); // 命中缓存时不会执行
  });
}

分组场景同样优雅,默认数组只在首次遇到该键时创建:

js
const groups = new Map();
for (const order of orders) {
  groups.getOrInsertComputed(order.status, () => []).push(order);
}

注意规范约束:回调执行期间不应修改同一个 Map 的结构,否则行为未定义;回调抛错时不会插入任何键。这两点在封装通用工具时要写进注释。

WeakMap 也获得了同款能力

WeakMap.prototype.getOrInsert / getOrInsertComputed 同步落地,典型用途是给 DOM 节点或外部对象挂元数据而不阻止垃圾回收:

js
const meta = new WeakMap();
function track(el) {
  return meta.getOrInsertComputed(el, () => ({ clicks: 0 }));
}

以前这段逻辑要写 if (!meta.has(el)),现在一行表达完整语义。

落地现状与降级方案

截至 2026 年 11 月:提案 Stage 4,进入 ES2026;Node.js 26(V8 14.6)默认可用,Node 24/22 没有;Edge 145 发布说明明确列出这两个方法,Chrome 同代跟进;Firefox 与 Safari 的支持进度以官方为准。需要覆盖旧环境时,一个十行的降级函数就够用:

js
function getOrInsertComputed(map, key, callback) {
  if (map.has(key)) return map.get(key);
  const value = callback(key);
  map.set(key, value);
  return value;
}

也可以直接用 core-js 等 polyfill 库的 upsert 实现。建议业务代码统一走封装函数,环境原生支持后再无缝切换。

实战:给接口缓存加一层 upsert

调接口做本地缓存是 upsert 的最佳落点。以 api工厂(https://www.it120.cc/)为例,它的 JSON 存储与商品接口返回结构稳定,很适合按 key 缓存。用 apifm-wxapi 拉取分类数据时,可以这样避免重复请求:

js
import WXAPI from 'apifm-wxapi';
WXAPI.init('your-subdomain');

const categoryCache = new Map();
async function categories(pid) {
  return getOrInsertComputed(categoryCache, pid, async () => {
    const res = await WXAPI.goodsCategory(pid);
    if (res.code !== 0) throw new Error(res.msg);
    return res.data;
  });
}

这里缓存的是 Promise 本身,并发调用同一 key 也只会发一次请求,这是 upsert 语义带来的额外红利。SDK 方法均返回 Promise、code==0 表示成功,接口清单见 SDK 文档(https://www.it120.cc/sdk/index.html)。

小结

getOrInsert 解决「默认值便宜」的场景,getOrInsertComputed 解决「默认值昂贵或异步」的场景,WeakMap 版本补齐对象元数据管理。语义上记住两点:不覆盖已有值、回调只在缺失时执行。新环境直接用,旧环境封装降级,三段式可以正式退休了。

文章标签

JavaScriptMapUpsertES2026缓存

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。