()Array.prototype.join

This translation is incomplete. Please help translate this article from English.

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

صيغة الكتابة

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 2017 Draft (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Draft  

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

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

 Contributors to this page: DevOsamaMohamed
 Last updated by: DevOsamaMohamed,