---
title: Array.prototype.splice()
slug: Web/JavaScript/Reference/Global_Objects/Array/splice
tags:
  - Dokumentacja_JavaScript
  - Dokumentacje
  - JavaScript
  - Wszystkie_kategorie
translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice
original_slug: Web/JavaScript/Referencje/Obiekty/Array/splice
---
<div>{{JSRef}}</div>

<h2 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h2>

<p>Zmienia zawartość tablicy, dodając nowe elementy podczas usuwania starych elementów.</p>

<h2 id="Sk.C5.82adnia" name="Sk.C5.82adnia">Składnia</h2>

<pre class="syntaxbox"><code><var>array</var>.splice(<var>start</var>, <var>deleteCount</var>[, <var>item1</var>[, <var>item2</var>[, ...]]])
</code></pre>

<h3 id="Parametry" name="Parametry">Parametry</h3>

<dl>
 <dt><code>start</code></dt>
 <dd>Indeks od którego rozpoczynamy modyfikację tablicy.</dd>
</dl>

<dl>
 <dt><code>deleteCount</code></dt>
 <dd>Liczba całkowita określająca liczbę starych elementów tablicy do usunięcia. Jeżeli <font face="Consolas, Monaco, Andale Mono, monospace">deleteCount</font> wynosi 0, nic nie zostanie usunięte. W tym przypadku należy podać co najmniej jeden nowy element. W przypadku gdy parametr <font face="Consolas, Monaco, Andale Mono, monospace">deleteCount</font> nie został podany (druga forma składni podana powyżej, która jest rozszerzeniem SpiderMonkey), wszystkie elementy o indeksach wyższych <code>lub równych index</code> są usuwane.</dd>
</dl>

<dl>
 <dt><code>itemN</code></dt>
 <dd>Elementy dodawane do tablicy. Jeżeli nie określimy żadnych elementów, <code>splice</code> usunie tylko podaną liczbę elementów.</dd>
</dl>

<h2 id="Opis" name="Opis">Opis</h2>

<p>Jeżeli podamy różną liczbę wstawianych elementów od liczby usuwanych elementów, tablica będzie posiadała inną długość po wywołaniu metody <code>splice</code>.</p>

<p>Metoda <code>splice</code> zwraca tablicę zawierającą usunięte elementy. Jeżeli usunięty został tylko jeden element, zwracana jest tablica jednoelementowa.</p>

<h2 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h2>

<h3 id="Przyk.C5.82ad:_Zastosowanie_splice" name="Przyk.C5.82ad:_Zastosowanie_splice">Przykład: Zastosowanie <code>splice</code></h3>

<p>Następujący skrypt ilustruje użycie splice:</p>

<pre class="brush: js">myFish = ["anioł", "klaun", "mandarynka", "jesiotr"];
console.log("myFish: " + myFish);

removed = myFish.splice(2, 0, "bęben");
console.log("Po dodaniu 1: " + myFish);
console.log("Usunięty jest: " + removed);

removed = myFish.splice(3, 1)
console.log("Po usunięciu 1: " + myFish);
console.log("Usunięty jest: " + removed);

removed = myFish.splice(2, 1, "trąba")
console.log("Po zastąpieniu 1: " + myFish);
console.log("Usunięty jest: " + removed);

removed = myFish.splice(0, 2, "papuga", "zawilec", "niebieski")
console.log("Po zastąpieniu 2: " + myFish);
console.log("Usunięty jest: " + removed);
</pre>

<p>Ten skrypt wyświetli:</p>

<pre>myFish: ["anioł", "klaun", "mandarynka", "jesiotr"]

Po dodaniu 1: ["anioł", "klaun", "bęben", "mandarynka", "jesiotr"]
Usunięty jest: undefined

Po usunięciu 1: ["anioł", "klaun", "bęben, "jesiotr"]
Usunięty jest: mandarynka

Po zastąpieniu 1: ["anioł", "klaun", "trąba", "jesiotr"]
Usunięty jest: bęben

Po zastąpieniu 2: ["papuga", "zawilec", "niebieski", "trąba", "jesiotr"]
Usunięty jest: ["anioł", "klaun"]
</pre>