--- title: Array.prototype.splice() slug: Web/JavaScript/Reference/Global_Objects/Array/splice tags: - Dizi - Referans - metod - prototip translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice ---
{{JSRef}}

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

{{EmbedInteractiveExample("pages/js/array-splice.html")}}

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_inline}}
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_inline}}
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

Özellik Durum Yorum
{{SpecName('ES3')}} {{Spec2('ES3')}} Initial definition. Implemented in JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.4.4.12', 'Array.prototype.splice')}} {{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-array.prototype.splice', 'Array.prototype.splice')}} {{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.prototype.splice', 'Array.prototype.splice')}} {{Spec2('ESDraft')}}

Tarayıcı Uyumluluğu

{{Compat("javascript.builtins.Array.splice")}}

Bkz.