`Array.prototype.join()‎`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

الدالة Array.prototype.join()‎ تضيف جميع عناصر المصفوفة إلى بعضها بعضًا لتُشكِّل سلسلةً نصيةً، وتُعيد هذه السلسلة النصية.

إذا كان عنصر المصفوفة هو null أو undefined، فسيحوّل إلى سلسلة نصية فارغة.

var elements = ['Fire', 'Wind', 'Rain'];

console.log(elements.join());    // Fire,Wind,Rain

console.log(elements.join(''));  // FireWindRain

console.log(elements.join('-')); // Fire-Wind-Rain

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

arr.join([separator])

`separator`

تحديد سلسلة نصية لتفصل بين عناصر المصفوفة، وسيحوّل الفاصل إلى سلسلة نصية إن كان ذلك ضروريًا. إذا لم تُحدَّد قيمة هذا الوسيط، فسيُفصَل بين السلاسل النصية بفاصلة عادية ,، وإذا كان الفاصل سلسلةً نصيةً فارغةً فستُضاف عناصر المصفوفة إلى بعضها بعضًا دون فاصل.

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

سلسلة نصية فيها جميع عناصر المصفوفة مفصولٌ بينها بقيمة الوسيط separator، وإذا كان طول المصفوفة arr.length هو 0 فستُعاد سلسلةٌ نصيةٌ فارغة.

أمثلة

جمع عناصر المصفوفة مع بعضها بعضًا بأربعة طرائق

المثال الآتي يُنشِئ مصفوفةً باسم a فيها ثلاثة عناصر، ثم يجمع عناصر تلك المصفوفة على شكل سلسلة نصية بأربعة طرائق: باستخدام الفاصل الافتراضي، ثم باستخدام فاصلة وفراغ، ثم بإشارة زائد، ثم بسلسلة نصية فارغة:

var a = ['Wind', 'Rain', 'Fire'];
a.join();      // 'Wind,Rain,Fire'
a.join(', ');  // 'Wind, Rain, Fire'
a.join(' + '); // 'Wind + Rain + Fire'
a.join('');    // 'WindRainFire'

إضافة عناصر كائن شبيه بالمصفوفات

المثال الآتي يُضيف عناصر كائن شبيه بالمصفوفات (وهو الكائن arguments) باستخدام الدالة Function.prototype.call على Array.prototype.join:

function f(a, b, c) {
  var s = Array.prototype.join.call(arguments);
  console.log(s); // '1,a,true'
}
f(1, 'a', true);

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

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

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

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