
状态更新里只想替换数组的一项,直接写 items[index] = value 会改掉原数组。with() 给了一个不改源数组的写法:items.with(index, value) 返回替换后的新数组。
const colors = ['red', 'green', 'blue'];
const next = colors.with(-1, 'gold');
console.log(next); // ['red', 'green', 'gold']
console.log(colors); // ['red', 'green', 'blue']
新数组可以直接放进状态更新;旧数组仍可供撤销、对比或其他引用继续使用。
负数从尾部开始数
数组长度是 3 时,索引 -1 指向最后一项,-2 指向中间一项。它不是把负数变成属性名,也不会从头开始数。索引先按整数规则处理,1.9 会落到索引 1。
本机测试用三个颜色值做了替换。with(-1, 'gold') 改的是最后一项,with(1.9, 'lime') 改的是中间一项;原数组仍是 ['red', 'green', 'blue']。这也是它和直接赋值的差别:改出来的是新数组,旧状态还在。
source: ["red","green","blue"]
with(-1): ["red","green","gold"]
indexOf missing: -1 with(-1): ["red","green","gold"]
with(1.9): ["red","lime","blue"]
toSpliced insert: ["red","mint","green","blue"]
toSpliced remove: ["red","blue"]
with(3), with(-4): RangeError
unchanged source: ["red","green","blue"]
unchanged nested reference: true
sparse source has index 0: false
result has index 0: true
sparse value at index 0 is undefined: true
sparse result: [null,"middle",null]
越界时不会替你扩容
常见的下标赋值允许数组变长。对长度为 3 的数组写 items[3] = 'extra',数组会多出一项;with(3, 'extra') 则直接抛出 RangeError。负数也有边界,-4 已经越过开头,同样会报错。
这点和 slice() 的截取不同。slice() 可以把越界位置截到边缘,with() 的索引必须指向一个已有位置。代码如果把用户提供的索引直接传进来,先判断范围,或者明确让异常暴露出来,别默认它会帮忙扩数组。
还有个容易漏掉的组合:indexOf() 找不到内容会返回 -1,而 with(-1, value) 恰好表示最后一项。测试数组里找不到 purple,结果索引是 -1;把它不加判断地传给 with(),最后的 blue 就被换成了 gold。若业务含义是「找到了才替换」,先判断索引是否大于等于 0。负索引本身没错,错在把「没找到」的哨兵值当成了有效位置。
稀疏数组还有个不太显眼的变化:读取空洞会得到 undefined,而 with() 会把读到的值写进新数组相应位置。测试里,源数组的 0 号位不是数组属性,新数组的 0 号位却存在,值为 undefined。所以判断「有没有这个位置」时,不能只看读取结果;arr[i] === undefined 分不出空洞和显式的 undefined,还要用 i in arr。
日志里 JSON.stringify() 把数组中的 undefined 显示成 null,容易让人误会值被改成了 null。本机断言同时检查了 0 in filled 和 filled[0] === undefined:新数组确实有这个位置,值仍是 undefined。看序列化输出时,得把 JSON 的呈现规则和 JavaScript 数组本身分开。
with() 只替换已有位置。要插入或删除元素,可以看 toSpliced():本机测试插入 mint 得到 ['red', 'mint', 'green', 'blue'],删除中间项得到 ['red', 'blue'],原数组都保持不变。名字相近,做的事不同;把 with() 当成通用数组编辑器,最后还是要回头处理索引和长度。
新数组不等于深拷贝
with() 不会改动原数组,也会为替换后的结果创建新数组。不过,数组里没有被替换的对象仍然是同一份引用。测试里,copied[1] === objects[1] 仍为 true。只比较外层数组的身份,不能据此认为所有嵌套数据都隔离了。
如果数组元素是对象,替换其中一项之后再修改另一项的属性,原数组里对应的对象也会看到变化。需要完全隔离时,得按数据结构选择深拷贝或不可变更新方案,with() 本身只负责这一层替换。
数组很长、同时要替换很多项时,连续调用多次 with() 会造出多份中间数组。可以先算出所有新值,再用一次遍历生成结果。单点更新时,with() 能让新旧状态的边界一眼看明白;批量改动则别为了语法统一,平白增加复制次数。
我会把它用在「按位置替换、同时保留旧状态」的场景。若索引可能来自外部输入,越界异常是需要处理的边界,不是一个可以忽略的小细节。