Array.prototype.splice()

splice() metodu; bir Dizi'nin içeriklerini, diziye ait öğeleri kaldırarak veya yeni öğeler ekleyerek ve/veya mevcut öğeleri silerek değiştirir.

Syntax

array.splice(başlangıç[, silinecekAdet[, item1[, item2[, ...]]]])

Parametreler

başlangıç

Dizi'yi değiştirmek için başlanılacak indeks (0 kökenli indeks). Dizi'nin uzunluğundan daha büyük ise, başlangıç indeksi Dizi'nin uzunluğuna ayarlanacak. Negatif ise, Dizi'nin sonundaki öğeler toplamından başlayacak (-1 kökenli indeks) ve eğer kesin değer Dizi'nin uzunluğundan büyük ise, başlangıç değeri 0 olacak.

silinecekAdet Optional

Eski Dizi'nden silinecek öğelerin sayısını belirten bir tamsayı.

silinecekAdet belirlenmemiş ise, veya değeri dizi.uzunluk - başlangıç 'tan büyük ise (daha sade bir tanımı,  başlangıç başlayarak, Dizi'nde kalmış öğelerin toplam sayısından fazla ise), start sayısından Dizi'nin sonuna kadar yer alan bütün öğeler silinecek.

silinecekAdet 0 veya negatif ise, hiçbir öğe silinmeyecek. Bu durumda, en az yeni bir öğe tanımlamalısın (aşağı bkz.).

item1, item2, ... Optional

Dizi'ne eklenecek olan öğeler, başlangıç indeksinden başlayarak. hiçbir öğe tanımlamaz isen, splice() sadece Dizi'den öğeleri kaldıracak.

Geri dönüş değeri

Silinen öğeleri barındıran bir Dizi. Sadece bir öğe silinmiş ise, tek öğeli bir Dizi geri dönülecek. Hiçbir öğe silinmemiş ise, boş bir Dizi dönecek.

Açıklama

Sileceğin öğe sayısından farklı bir sayıda öğe tanımlıyorsan, çağrının sonunda Dizi farklı bir uzunluğa sahip olacak.

Örnekler

2 indeksinden önce 0 öğe sil, ve "drum" öğesini ekle

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
var removed = myFish.splice(2, 0, 'drum');

// myFish dizi öğeleri ["angel", "clown", "drum", "mandarin", "sturgeon"] 
// silinen [], hiçbir öğe silinmedi

3 indeksinden 1 öğe sil

var myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon'];
var removed = myFish.splice(3, 1);

// silinen ["mandarin"]
// myFish Dizi'si ["angel", "clown", "drum", "sturgeon"] 

2 indeksinden 1 öğe sil, ve "trumpet" öğesini ekle

var myFish = ['angel', 'clown', 'drum', 'sturgeon'];
var silinen = myFish.splice(2, 1, 'trumpet');

// myFish is ["angel", "clown", "trumpet", "sturgeon"]
// silinen ["drum"]

0 indeksinden başlayarak 2 öğe sil, "parrot", "anemone" ve "blue" öğelerini ekle

var myFish = ['angel', 'clown', 'trumpet', 'sturgeon'];
var silinen = myFish.splice(0, 2, 'parrot', 'anemone', 'blue');

// myFish is ["parrot", "anemone", "blue", "trumpet", "sturgeon"] 
// silinen ["angel", "clown"]

2 indeksinden 2 öğe sil

var myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon'];
var silinen = myFish.splice(myFish.length - 3, 2);

// myFish is ["parrot", "anemone", "sturgeon"] 
// silinen ["blue", "trumpet"]

-2 indeksinden 1 öğe sil

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
var silinen = myFish.splice(-2, 1);

// myFish ["angel", "clown", "sturgeon"] 
// silinen ["mandarin"]

2 indeksinden sonra bütün öğeleri sil (2 indeksi de dahil)

var myFish = ['angel', 'clown', 'mandarin', 'sturgeon'];
var silinen = myFish.splice(2);

// myFish ["angel", "clown"] 
// silinen ["mandarin", "sturgeon"]

Özellikler

Tarayıcı Uyumluluğu

Bkz.

• push() / pop() — add/remove elements from the end of the array
• unshift() / shift() — add/remove elements from the beginning of the array
• concat() — returns a new array comprised of this array joined with other array(s) and/or value(s)