JavaScript splice 的省略参数：没有写删除数量，与写 undefined 为什么结果不同
维护一段数组编辑工具时，直接写 items.splice(1) 能删除后面的所有元素，套一层函数后却可能什么都没删。即使包装函数中的 count 值是 undefined，也不等于调用时根本没有第二个参数。splice 明确区分参数有没有出现，所以包装层改变参数个数就可能改变行为。
下面在 Node.js v24.19.0 上验证。保存为 demo.mjs，运行 node demo.mjs。每次 check 都重新创建数组，避免前一次原地修改影响下一次比较。输出同时记录删除返回值与修改后的数组，不能只看其中一份。
AI模型生成概念示意：剪刀从一列方块中取走尾部，与保留原列的另一种路径并列；方块只表示数组位置，图形不是执行结果截图。
完整实验
function check(label, ...args) {
const items = ['a', 'b', 'c', 'd'];
const removed = items.splice(...args);
console.log(label, JSON.stringify({ removed, remaining: items }));
}
check('no-arguments');
check('only-start', 1);
check('explicit-undefined', 1, undefined);
check('insert-only', 1, undefined, 'X');
check('replace-tail', 1, Infinity, 'X');
function badWrapper(items, start, count) {
return items.splice(start, count);
}
function preservingWrapper(items, ...args) {
return items.splice(...args);
}
const first = ['a', 'b', 'c'];
const second = ['a', 'b', 'c'];
console.log('bad-wrapper', JSON.stringify(badWrapper(first, 1)));
console.log('preserving-wrapper', JSON.stringify(preservingWrapper(second, 1)));本地实际输出
no-arguments {"removed":[],"remaining":["a","b","c","d"]}
only-start {"removed":["b","c","d"],"remaining":["a"]}
explicit-undefined {"removed":[],"remaining":["a","b","c","d"]}
insert-only {"removed":[],"remaining":["a","X","b","c","d"]}
replace-tail {"removed":["b","c","d"],"remaining":["a","X"]}
bad-wrapper []
preserving-wrapper ["b","c"]no-arguments 完全不提供参数，删除结果为空。only-start 提供了起点 1，却省略 deleteCount，因此删除范围延伸到数组末尾。explicit-undefined 则确实传了第二个参数；undefined 经数量转换后相当于零，于是四个元素全部留下。
insert-only 在起点处插入 X，但仍没有删除旧元素。若目的是把起点后的整个尾部替换为 X，可显式用 Infinity 作为删除数量。splice 会把它限制到数组剩余长度，所以 replace-tail 留下 a、X，并返回旧的 b、c、d。
两个包装函数才是实际排错重点。badWrapper(first, 1) 虽然只收到了两个实参，内部仍调用 items.splice(start, count)，使第二个 splice 参数明确存在。preservingWrapper 用剩余参数收集调用者实际提供的项目，再展开传入，保住了省略状态，因此能删除 b、c。
边界与使用约定
如果包装器本来就要重新定义规则，也可以要求删除数量必须是非负整数，不提供就报错。关键是把接口约定写清楚，不让形参默认值无意中改写底层规则。剩余参数适合忠实转发；参数校验适合提供更窄、更明确的业务接口。
splice 会修改原数组，返回的是被删掉的元素。写成 items = items.splice(...) 会把保留部分换成删除部分。希望保留原数组时，可先复制再修改；使用支持 toSpliced 的运行时也应重新核对其返回含义，而不是只替换方法名字。
本例只验证普通可写的稠密数组。冻结数组、只读属性、代理和稀疏数组还有各自的行为，不能据此把所有修改看成事务。对真正的业务编辑，可先拿一份小数组验证省略数量、零数量、删除到尾部、只插入四种意图，再接到界面操作上。
参考资料
官方资料核验日期：2026-10-02。
