---
title: Array.prototype.unshift()
slug: Web/JavaScript/Reference/Global_Objects/Array/unshift
translation_of: Web/JavaScript/Reference/Global_Objects/Array/unshift
---
<div>{{JSRef}}</div>

<p><code><strong>unshift()</strong></code> metodu dizinin başına bir veya daha fazla element ekler ve yeni dizinin uzunluğunu size geri döndürür.</p>

<div>{{EmbedInteractiveExample("pages/js/array-unshift.html")}}</div>

<h2 id="Sözdizimi_Kuralları">Sözdizimi Kuralları</h2>

<pre class="syntaxbox"><em>dizi</em>.unshift(<var>element1</var>[, ...[, <var>elementN</var>]])</pre>

<h3 id="Parametreler">Parametreler</h3>

<dl>
 <dt><code>element<em>N</em></code></dt>
 <dd>Dizinin başına eklenecek değer.</dd>
</dl>

<h3 id="Döndürülen_değer">Döndürülen değer</h3>

<p>Üzerinde işlem yapılan dizinin yeni {{jsxref("Array.length", "length")}} değerini verir.</p>

<h2 id="Açıklama">Açıklama</h2>

<p><code>unshift</code><font><font>, girilen değerleri bir dizinin başına ekler.</font></font></p>

<p><code>unshift</code><font><font>kasıtlı olarak geneldir; </font><font>bu yöntem, benzer nesnelere </font></font>{{jsxref("Function.call", "called", "", 1)}} veya<font><font> </font></font>{{jsxref("Function.apply", "applied", "", 1)}} <font><font>olabilir. diziler. </font><font>Birbirini </font></font><code>length</code> <font><font>ardışık, sıfıra dayalı sayısal özellikler dizisinde sonuncuyu yansıtan </font><font>bir </font><font>özellik </font><font>içermeyen nesneler </font><font>, anlamlı şekilde davranamazlar.</font></font></p>

<p><font><font>Birden fazla eleman parametre olarak girildiğinde, elemanlar parametre sırasına göre dizinin başına yerleştirilmektedir. Parametreleri ayrı unshift metodlarıyla eklemek ve sadece bir unshift metodunda eklemek aynı sonucu vermez.</font></font></p>

<pre class="syntaxbox">let dizi = [4, 5, 6];
dizi.unshift(1, 2, 3);
console.log(dizi);
// [<strong>1, 2, 3</strong>, 4, 5, 6]

dizi = [4, 5, 6]; // dizi sıfırlanır.

dizi.unshift(1);
dizi.unshift(2);
dizi.unshift(3);

console.log(dizi);
// [<strong>3, 2, 1</strong>, 4, 5, 6]
</pre>

<h2 id="Örnekler">Örnekler</h2>

<pre class="brush: js">let dizi = [1, 2];

dizi.unshift(0); // dizinin uzunluğu 3 olur.
// dizi: [0, 1, 2]

dizi.unshift(-2, -1); // dizinin uzunluğu 5 olur.
// dizi: [-2, -1, 0, 1, 2]

dizi.unshift([-4, -3]); // dizinin uzunluğu 6 olur.
// dizi: [[-4, -3], -2, -1, 0, 1, 2]

dizi.unshift([-7, -6], [-5]); // dizinin uzunluğu 8 olur.
// dizi: [ [-7, -6], [-5], [-4, -3], -2, -1, 0, 1, 2 ]
</pre>

<h2 id="Özellikler">Özellikler</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Özellik</th>
   <th scope="col">Durum</th>
   <th scope="col">Açıklama</th>
  </tr>
  <tr>
   <td>{{SpecName('ES3')}}</td>
   <td>{{Spec2('ES3')}}</td>
   <td>Initial definition. Implemented in JavaScript 1.2.</td>
  </tr>
  <tr>
   <td>{{SpecName('ES5.1', '#sec-15.4.4.13', 'Array.prototype.unshift')}}</td>
   <td>{{Spec2('ES5.1')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('ES6', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}}</td>
   <td>{{Spec2('ES6')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="Tarayıcı_desteği">Tarayıcı desteği</h2>

<div>
<div class="hidden"><font>Bu sayfadaki uyumluluk tablosu yapılandırılmış verilerden üretilmiştir. </font><font>Verilere katkıda bulunmak istiyorsanız, lütfen</font><font><font> </font></font><a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> adresini ziyaret edin ve bize istek gönderin.</div>

<p>{{Compat("javascript.builtins.Array.unshift")}}</p>
</div>

<h2 id="Benzer_Makaleler">Benzer Makaleler</h2>

<ul>
 <li>{{jsxref("Array.prototype.push()")}}</li>
 <li>{{jsxref("Array.prototype.pop()")}}</li>
 <li>{{jsxref("Array.prototype.shift()")}}</li>
 <li>{{jsxref("Array.prototype.concat()")}}</li>
</ul>