Array.prototype.shift()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث
الدالة Array.prototype.shift()‎ تحذف أوّل عنصر من المصفوفة وتُعيد قيمته، وهذه الدالة تُغيّر عدد عناصر (length) المصفوفة.
var a = [1, 2, 3];
var b = a.shift();

console.log(a); // [2, 3]
console.log(b); // 1

البنية العامة

arr.shift()

القيمة المعادة

القيمة المحذوفة من المصفوفة، أو القيمة undefined إذا كانت المصفوفة فارغة.

الوصف

الدالة shift تحذف آخر عنصر من المصفوفة وتُعيد تلك القيمة إلى التعبير البرمجي الذي استدعاها؛ وإذا اُستدعيت الدالة shift على مصفوفة فارغة فستُعيد القيمة undefined.

أمثلة

المثال الآتي يُنشِئ مصفوفةً باسم myFish تحتوي على أربعة عناصر، ثم نحذف أوّل عنصر منها:
var myFish = ['angel', 'clown', 'mandarin', 'surgeon'];

console.log('myFish before:', JSON.stringify(myFish));
// myFish: ['angel', 'clown', 'mandarin', 'surgeon']

var shifted = myFish.shift(); 

console.log('myFish after:', myFish); 
// myFish: ['clown', 'mandarin', 'surgeon']

console.log('Removed this element:', shifted); 
// Removed this element: angel

استخدام الدالة shift()‎ في حلقة while

الدالة shift()‎ تُستخدَم عادةً في الشرط التابع لحلقة التكرار while، ففي المثال الآتي سنحصل على كل عنصر من عناصر المصفوفة حتى تصبح فارغةً:
var names = ["Ahmad", "Mostafa", "Reem", "Hussam" ,"Raghad"];

while( (i = names.shift()) !== undefined ) {
    console.log(i);
}
// Ahmad, Mostafa, Reem, Hussam, Raghad

دعم المتصفحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم نعم نعم نعم نعم

مصادر ومواصفات