Array.prototype.with() 是 TC39 Stage 4 提案但尚未纳入任何正式 ECMAScript 标准(含 ES2023),Chrome 122+ 开始实验性支持;它返回新数组实现不可变更新,非 ES2023 新增特性。

with() 方法不是 ES2023 的特性,也**不存在于任何正式 JavaScript 标准中**。JavaScript 中目前(截至 ECMAScript 2024)**没有名为 with() 的数组方法**,更不存在“ES2023 新增的 with() 实现不可变更新”的语法或 API。
你可能混淆了以下几种常见情况:
1. 误将 Array.prototype.with() 当作已发布特性
该方法确实在 TC39 提案「Change Array By Copy」 中被提出,并已进入 Stage 4(已完成),但它尚未被纳入任何正式发布的 ECMAScript 标准版本(包括 ES2023)。主流浏览器(Chrome、Firefox、Safari)在 2024 年中才开始陆续实现(如 Chrome 122+ 支持),且需启用实验性标志或等待稳定版全面落地。
✅ 正确名称是:Array.prototype.with(index, value)
✅ 行为:返回一个新数组,将指定索引处的元素替换为给定值,原数组不变(真正不可变式更新)。
✅ 示例:
const arr = [1, 2, 3, 4]; const newArr = arr.with(2, 99); // [1, 2, 99, 4] console.log(arr); // [1, 2, 3, 4] ← 原数组未变 console.log(newArr); // [1, 2, 99, 4] ← 新数组
2. 当前安全可用的不可变更新方式(兼容所有环境)
在 with() 尚未广泛支持时,推荐以下标准、可靠的方法:
-
使用扩展运算符 + 索引赋值(推荐):
[...arr.slice(0, i), newValue, ...arr.slice(i + 1)] -
使用
toSpliced()(ES2023 已正式支持):arr.toSpliced(i, 1, newValue)—— 删除 1 个元素并在原位插入新值,返回新数组。 -
使用
map()(语义清晰,适合条件更新):arr.map((v, idx) => idx === i ? newValue : v)
3. 注意避开真实存在的 with 语句(完全无关)
JavaScript 有一个早已废弃、严格模式下禁用的 with 语句(用于扩展作用域链),例如:
with ({ x: 1 }) { console.log(x); } // ❌ 不是数组方法,且不推荐使用
它与数组操作、不可变性、ES2023 完全无关,切勿混淆。
4. 如何检查你的环境是否支持 arr.with()
运行以下代码验证:
console.log(Array.prototype.with ? 'supported' : 'not supported');
// 或测试调用
try {
[1,2,3].with(0, 99);
console.log('✅ works');
} catch (e) {
console.log('❌ not available');
}

















