دالة ()join تقوم بدمج جميع عناصر المصفوفة في نص واحد.

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

صيغة الكتابة

str = arr.join([separator = ','])

المعاملات

separator
اختياري. يحدد النص الذي سيقوم بفصل عناصر المصفوفة عن بعضهم البعض. الـ separator سيتحول إلى جزء من النص الناتج. إذا لم يتم تمريره، سيتم الفصل بين عناصر المصفوفة بالـ comma. إذا كان الـseparator عبارة عن نص فارغ، سيتم ضم عناصر المصفوفة دون أي فاصل

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

عناصر المصفوفة مضمومين في هيئة نص.

الوصف

تقوم بدمج عناصر المصفوفة في هيئة نص، إذا كان أحد هذه العناصر قيمة فارغة أو غير معرف سيتم تحويله إلى نص فارغ.

أمثلة

ضم عناصر المصفوفة بأربعة طرق مختلفة

المثال التالي يقوم بإنشاء مصفوفة a ، بها ثلاثة عناصر، ثم يقوم بضم هذه العناصر الثلاثة، ثم يقوم بضم هذه العناصر الثلاثة إلى نص واحد بأربعة طرق: استخدام الـ separator الإفتراضي، ثم باستخدام الـ comma والمسافة، ثم باستخدام علامة الجمع وأخيرا باستخدام نص فارغ.

var a = ['Wind', 'Rain', 'Fire'];
var myVar1 = a.join();      // myVar1 إلى 'Wind,Rain,Fire' تسند
var myVar2 = a.join(', ');  // myVar2 إلى 'Wind, Rain, Fire' تسند
var myVar3 = a.join(' + '); // myVar3 إلى 'Wind + Rain + Fire' تسند
var myVar4 = a.join('');    // myVar4 إلى 'WindRainFire' تسند

المواصفات

الصفة الحالة تعليق
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Draft  

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 1.0 (1.7 or earlier) 5.5 (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

إقرأ أيضا

Document Tags and Contributors

المساهمون في هذه الصفحة: Abu3safeer, DevOsamaMohamed
آخر مَن حدّثها: Abu3safeer,