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

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

Източници