عرض مصدر JavaScript/Symbol/isConcatSpreadable

<noinclude>{{DISPLAYTITLE:<code>Symbol.isConcatSpreadable</code>}}</noinclude>
الرمز المعروف <code>Symbol.isConcatSpreadable</code> يُستخدَم لضبط إمكانية تسطيح (flatten) أحد الكائنات إلى عناصر مصفوفة باستخدام الدالة <code>[[JavaScript/Array/concat|Array.prototype.concat()‎]]</code>.
{| class="wikitable"
! colspan="2" |سمات الخاصية Symbol.isConcatSpreadable
|-
|قابلة للكتابة
|لا
|-
|قابلة للإحصاء
|لا
|-
|قابلة للضبط
|لا
|}

== الوصف ==
الرمز ‎<code>@@isConcatSpreadable</code> (أي <code>Symbol.isConcatSpreadable</code>) يمكن تعريفه كخاصية تابعة مباشرةً للكائن أو كخاصية موروثة، ويحمل قيمةً منطقيةً؛ ويمكنه التحكم بسلوك المصفوفات أو الكائنات الشبيهة بالمصفوفات:
* لكائنات المصفوفات، السلوك الافتراضي هو نشر (spread، أو تسطيح flatten) العناصر؛ ويمكن أن يُستخدَم الرمز <code>Symbol.isConcatSpreadable</code> لتفادي تسطيح المصفوفة.
* للكائنات الشبيهة بالمصفوفات، السلوك الافتراضي هو عدم نشر (spread، أو تسطيح flatten) العناصر؛ ويمكن أن يُستخدَم الرمز <code>Symbol.isConcatSpreadable</code> لإجبار تسطيح الكائن.

== أمثلة ==

=== المصفوفات ===
افتراضيًا، تنشر (أو تُسطِّح) الدالة <code>[[JavaScript/Array/concat|Array.prototype.concat()]]</code>‎ المصفوفات إلى نتائجها:<syntaxhighlight lang="javascript">
var alpha = ['a', 'b', 'c'], 
    numeric = [1, 2, 3]; 

var alphaNumeric = alpha.concat(numeric); 

console.log(alphaNumeric); // ['a', 'b', 'c', 1, 2, 3]

</syntaxhighlight>أما عند ضبط الرمز Symbol.isConcatSpreadable إلى false، فمكننا تعطيل السلوك الافتراضي:<syntaxhighlight lang="javascript">
var alpha = ['a', 'b', 'c'], 
    numeric = [1, 2, 3]; 

numeric[Symbol.isConcatSpreadable] = false;
var alphaNumeric = alpha.concat(numeric); 

console.log(alphaNumeric); // ['a', 'b', 'c', [1, 2, 3] ]

</syntaxhighlight>

=== الكائنات الشبيهة بالمصفوفات ===
أما للكائنات الشبيهة بالمصفوفات، فالسلوك الافتراضي هو عدم نشرها، ويجب ضبط الخاصية <code>Symbol.isConcatSpreadable</code> إلى <code>true</code> للحصول على مصفوفة مسطحة:<syntaxhighlight lang="javascript">
var x = [1, 2, 3];

var fakeArray = { 
  [Symbol.isConcatSpreadable]: true, 
  length: 2, 
  0: 'hello', 
  1: 'world' 
}

x.concat(fakeArray); // [1, 2, 3, "hello", "world"]

</syntaxhighlight>ملاحظة: الخاصية <code>length</code> تُستخدَم للتحكم بعدد خاصيات الكائن التي ستُضاف؛ فالخاصية <code>length: 2</code> تعني أنَّ هنالك خاصيتان ستُضافان إلى الكائن.
== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|48
|48
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-symbol.isconcatspreadable ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-symbol.isconcatspreadable ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Symbol|{{SUBPAGENAME}}]]