عرض مصدر JavaScript/RegExp/@@split

<noinclude>{{DISPLAYTITLE:<code>RegExp.prototype.[@@split]()‎</code>}}</noinclude>
الدالة <code>RegExp.prototype.[@@split]()‎</code> تقسم كائن <code>[[JavaScript/String|String]]</code> إلى مصفوفة من السلاسل النصية بفصلها إلى سلاسل نصية فرعية.

== البنية العامة ==
<syntaxhighlight lang="javascript">
regexp[Symbol.split](str[, limit])

</syntaxhighlight>

=== <code>str</code> ===
السلسلة النصية التي نريد قسمها.

=== <code>limit</code> ===
عدد صحيح يضبط الحد الأقصى لعدد الأجزاء التي ستُقسَّم السلسلة النصية إليها. وعند تحديد قيمة لهذا الوسيط، فستُقسِّم هذه الدالة السلسلة النصية عند كل مُطابَقة للتعبير النمطي، لكنها ستتوقف عند بلوغ عدد عناصر المصفوفة القيمة المُحدَّدة بالوسيط <code>limit</code>. لاحظ أنَّ من الممكن أن تكون هنالك عناصر في المصفوفة عددها أقل من قيمة <code>limit</code>.

=== القيمة المعادة ===
مصفوفة من أقسام السلسلة النصية الأصل.

== الوصف ==
تُستدعى هذه الدالة داخليًا في الدالة <code>[[JavaScript/String/split|String.prototype.split()‎]]</code> وذلك إذا كان الوسيط <code>separator</code> هو كائن <code>[[JavaScript/RegExp|RegExp]]</code>. فمثلًا، كلا المثالين الآتيين له يُعيد النتيجة نفسها:<syntaxhighlight lang="javascript">
'a-b-c'.split(/-/);

/-/[Symbol.split]('a-b-c');

</syntaxhighlight>الغرض من وجود هذه الدالة هو السماح بإمكانية تخصيصها في الأصناف الفرعية المشتقة من <code>RegExp</code>.

إذا لم يكن الوسيط <code>separator</code> هو كائن من النوع <code>[[JavaScript/RegExp|RegExp]]</code>، فلن تستدعي الدالة <code>[[JavaScript/String/split|String.prototype.split()‎]]</code> هذه الدالة، ولن تُنِشئ كائن <code>[[JavaScript/RegExp|RegExp]]</code> من الأساس.

== أمثلة ==

=== استدعاء مباشر ===
ستُستخدَم هذه الدالة بنفس طريقة استخدام الدالة <code>[[JavaScript/String/split|String.prototype.split()‎]]</code>:<syntaxhighlight lang="javascript">
var re = /-/g;
var str = '2016-01-02';
var result = re[Symbol.split](str);
console.log(result);  // ["2016", "01", "02"]

</syntaxhighlight>
=== استخدام ‎<code>@@split</code> في الأصناف الفرعية ===
يمكن للأصناف الفرعية المشتقة من الصنف <code>[[JavaScript/RegExp|RegExp]]</code> إعادة تعريف الدالة <code>‎[@@split]()‎</code> لتغيير سلوكها الافتراضي:<syntaxhighlight lang="javascript">
class MyRegExp extends RegExp {
  [Symbol.split](str, limit) {
    var result = RegExp.prototype[Symbol.split].call(this, str, limit);
    return result.map(x => "(" + x + ")");
  }
}

var re = new MyRegExp('-');
var str = '2016-01-02';
var result = str.split(re); // String.prototype.split calls re[@@split].
console.log(result); // ["(2016)", "(01)", "(02)"]

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|49
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم Edge هذه الميزة.

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