结论先行:Map.prototype.getOrInsert 与 getOrInsertComputed(Upsert 提案)已走到 Stage 4 并纳入 ES2026,随 V8 14.6 落地:Node.js 26 默认可用,Chrome / Edge 145(2026 年 2 月)起支持。「查不到就插默认值」这个最高频的 Map 操作,从此告别 has + get + set 三段式。本文讲清两个方法的语义差异、惰性求值的价值、WeakMap 支持与旧环境降级写法。
三段式的痛:每个前端都写过
词频统计、分组聚合、缓存初始化,都绕不开同一个模式:
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:存在即返回,不存在即插入
const m = new Map();
m.getOrInsert('k', 42); // 键不存在:插入 42 并返回 42
m.getOrInsert('k', 999); // 键已存在:返回 42,不覆盖语义要点:第二参数是「值」,无论键是否存在都会被求值;已存在时绝不覆盖,这与「upsert 会更新」的直觉不同,它只做 insert-if-absent。词频统计可以简化成:
for (const word of words) {
counts.set(word, counts.getOrInsert(word, 0) + 1);
}getOrInsertComputed:默认值惰性计算
第二参数换成回调,只有键不存在时才执行,这是两个方法最关键的区别:
const cache = new Map();
function getConfig(userId) {
return cache.getOrInsertComputed(userId, () => {
return buildExpensiveConfig(userId); // 命中缓存时不会执行
});
}分组场景同样优雅,默认数组只在首次遇到该键时创建:
const groups = new Map();
for (const order of orders) {
groups.getOrInsertComputed(order.status, () => []).push(order);
}注意规范约束:回调执行期间不应修改同一个 Map 的结构,否则行为未定义;回调抛错时不会插入任何键。这两点在封装通用工具时要写进注释。
WeakMap 也获得了同款能力
WeakMap.prototype.getOrInsert / getOrInsertComputed 同步落地,典型用途是给 DOM 节点或外部对象挂元数据而不阻止垃圾回收:
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 的支持进度以官方为准。需要覆盖旧环境时,一个十行的降级函数就够用:
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 拉取分类数据时,可以这样避免重复请求:
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 版本补齐对象元数据管理。语义上记住两点:不覆盖已有值、回调只在缺失时执行。新环境直接用,旧环境封装降级,三段式可以正式退休了。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。