1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
---
title: ()Array.prototype.join
slug: Web/JavaScript/Reference/Global_Objects/Array/join
tags:
- Prototype
- جافاسكربت
- دالة
- دمج Array
- دمج المصفوفات
- مرجع
translation_of: Web/JavaScript/Reference/Global_Objects/Array/join
---
<div>{{JSRef}}</div>
<p dir="rtl">دالة <code><strong>()join </strong></code>تقوم بدمج جميع عناصر المصفوفة في نص واحد.</p>
<pre class="brush: js">var a = ['Wind', 'Rain', 'Fire'];
a.join(); // 'Wind,Rain,Fire'
a.join('-'); // 'Wind-Rain-Fire'</pre>
<h2 dir="rtl" id="صيغة_الكتابة">صيغة الكتابة</h2>
<pre class="syntaxbox" dir="rtl"><code><var>str</var> = <var>arr</var>.join([<var>separator</var> = ','])</code></pre>
<h3 id="المعاملات">المعاملات</h3>
<dl>
<dt><code>separator</code></dt>
<dd dir="rtl">اختياري. يحدد النص الذي سيقوم بفصل عناصر المصفوفة عن بعضهم البعض. الـ <strong>separator</strong> سيتحول إلى جزء من النص الناتج. إذا لم يتم تمريره، سيتم الفصل بين عناصر المصفوفة بالـ comma. إذا كان الـ<strong>separator</strong> عبارة عن نص فارغ، سيتم ضم عناصر المصفوفة دون أي فاصل</dd>
</dl>
<h3 dir="rtl" id="القيمة_العائدة">القيمة العائدة</h3>
<p dir="rtl">عناصر المصفوفة مضمومين في هيئة نص.</p>
<h2 dir="rtl" id="الوصف">الوصف</h2>
<p dir="rtl">تقوم بدمج عناصر المصفوفة في هيئة نص، إذا كان أحد هذه العناصر قيمة فارغة أو غير معرف سيتم تحويله إلى نص فارغ.</p>
<h2 dir="rtl" id="أمثلة">أمثلة</h2>
<h3 dir="rtl" id="ضم_عناصر_المصفوفة_بأربعة_طرق_مختلفة">ضم عناصر المصفوفة بأربعة طرق مختلفة</h3>
<p dir="rtl">المثال التالي يقوم بإنشاء مصفوفة a ، بها ثلاثة عناصر، ثم يقوم بضم هذه العناصر الثلاثة، ثم يقوم بضم هذه العناصر الثلاثة إلى نص واحد بأربعة طرق: استخدام الـ separator الإفتراضي، ثم باستخدام الـ comma والمسافة، ثم باستخدام علامة الجمع وأخيرا باستخدام نص فارغ.</p>
<pre class="brush: js">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' تسند
</pre>
<h2 dir="rtl" id="المواصفات">المواصفات</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">الصفة</th>
<th dir="rtl" scope="col">الحالة</th>
<th scope="col">تعليق</th>
</tr>
<tr>
<td>{{SpecName('ES1')}}</td>
<td>{{Spec2('ES1')}}</td>
<td>Initial definition. Implemented in JavaScript 1.1.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-15.4.4.5', 'Array.prototype.join')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-array.prototype.join', 'Array.prototype.join')}}</td>
<td>{{Spec2('ES6')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-array.prototype.join', 'Array.prototype.join')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 dir="rtl" id="التكامل_مع_المتصفحات">التكامل مع المتصفحات</h2>
<div>{{CompatibilityTable}}</div>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatChrome("1.0")}}</td>
<td>{{CompatGeckoDesktop("1.7")}}</td>
<td>{{CompatIE("5.5")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Android</th>
<th>Chrome for Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<h2 dir="rtl" id="إقرأ_أيضا">إقرأ أيضا</h2>
<ul>
<li>{{jsxref("String.prototype.split()")}}</li>
<li>{{jsxref("Array.prototype.toString()")}}</li>
<li>{{jsxref("TypedArray.prototype.join()")}}</li>
</ul>
|
