JavaScript/Array/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
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

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

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 3rd Edition.