База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.toSpliced: променено копие без мутация

toSpliced връща нов масив след премахване и вмъкване на избрани позиции, без да променя получателя.

Версия: ECMAScript 2023; example target: Node.js 24.22.2

Синтаксис

array.toSpliced(start, skipCount?, ...items)

array.toSpliced(start, skipCount?, ...items) е копиращият вариант на splice(): създава нов обикновен Array, пропуска избран диапазон, вмъква items и оставя array непроменен. Отрицателен start брои от края; позиция след дължината означава края. При зададен start пропуснат skipCount премахва опашката, изрично undefined означава нула, а другите стойности се ограничават до наличния диапазон.

Резултатът е цялото променено копие, не масив с премахнатите елементи. То е плитко, винаги плътно и игнорира Symbol.species: дупките стават собствени свойства със стойност undefined. Без аргументи се получава плътно копие.

Методът от ECMAScript 2023 е общ за array-like стойности. Получател null или undefined хвърля TypeError; прекалено голяма изчислена дължина дава TypeError или RangeError, а грешките от преобразуване, getter и proxy trap се разпространяват.

Примери

const source = ["build", "test", "deploy"];
const changed = source.toSpliced(1, 1, "lint", "test");
console.log(changed.join(","));
console.log(source.join(","));
console.log(source.toSpliced(-1).join(","));
console.log(source.toSpliced(1, undefined, "docs").join(","));

const dense = [1, , 3].toSpliced(1, 0, 2);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, 3 in dense);
console.log(dense[0], dense[1], String(dense[2]), dense[3]);

Резултат

build,lint,test,deploy
build,test,deploy
build,test
build,docs,test,deploy
4 true true true true
1 2 undefined 3

Източници