CKTIS / JavaScript
Array.prototype.splice: премахване, замяна и вмъкване
splice променя масив на избрана позиция, измества опашката му и връща нов масив с премахнатите елементи.
Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2
Синтаксис
array.splice(start, deleteCount?, ...items)array.splice(start, deleteCount?, ...items) променя array на място и връща нов масив с премахнатите елементи. start се преобразува до цяло число: отрицателна стойност брои от края, а позиция след дължината означава края. Ако има start, но deleteCount е пропуснат, се премахва цялата опашка; изрично undefined означава нула. Другите стойности се ограничават между нула и броя оставащи елементи. items се вмъкват пред изместената опашка.
Дължината на резултата е броят премахнати позиции и съответните дупки остават дупки. Получателят може да нарасне, да се скъси или да запази дължината си; splice() без аргументи не премахва нищо. При подкласове на Array създаването на резултата зачита Symbol.species.
Методът е общ за променяеми array-like обекти: чете length, копира или изтрива индексирани свойства и записва новата дължина. Може да хвърли TypeError, ако записът, изтриването или length са забранени или новата дължина би надхвърлила 2^53 - 1; грешките от преобразуване, accessor, proxy trap и species конструктора се разпространяват.
Примери
const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));
const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));
const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));
const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));Резултат
test build,lint,test,deploy test,deploy build,lint 0 build,docs,lint 2 false true b c