Array.prototype.join()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

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

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