عرض مصدر JavaScript/label

<noinclude>{{DISPLAYTITLE:اللافتات <code>label</code> في JavaScript}}</noinclude>
التعبير البرمجي <code>label</code> يمكن أن يُستخدَم مع التعبير البرمجي <code>[[JavaScript/break|break]]</code> أو <code>[[JavaScript/continue|continue]]</code>، وهو يوضع قبل التعابير البرمجية لإضافة لافتة (مُعرِّف) لها يمكن الإشارة إليها.

لاحظ أنَّ من غير الشائع استخدام حلقات تكرار مع لافتات (labels)، وتُستخدَم عادةً الدوال بدلًا القيام بقفزات بين حلقات التكرار.
==البنية العامة==
<syntaxhighlight lang="javascript">
label :
   statement
</syntaxhighlight>

=== <code>label</code> ===
لافتة للتعبير البرمجي، ويمكن أن تكون أيّ مُعرِّف في JavaScript صالح (وليس كلمةً محجوزةً).

=== <code>statement</code> ===
التعابير البرمجية التي ستُضاف اللافتة إليها، ويمكن استخدام التعبير البرمجي <code>[[JavaScript/break|break]]</code> مع أيّ تعبير برمجي له لافتة، أما التعبير <code>[[JavaScript/continue|continue]]</code> فيمكن أن يُستخدَم مع أيّة حلقات تكرار لها لافتة.

== الوصف ==
يمكنك استخدام لافتة (label) لإضافة مُعرِّف إلى حلقة تكرار، ثم استخدام التعبير <code>[[JavaScript/break|break]]</code> أو <code>[[JavaScript/continue|continue]]</code> للإشارة إلى أنَّ إيقاف تنفيذ حلقة التكرار أو إكمال تنفيذها مع التكرار التالي.

لاحظ أنَّ JavaScript '''لا''' تملك التعبير البرمجي <code>goto</code>، ولا يمكنك استخدام اللافتات إلا مع التعبير <code>[[JavaScript/break|break]]</code> أو <code>[[JavaScript/continue|continue]]</code>.

في [[JavaScript/Strict Mode|نمط strict]] لن تتمكن من استخدام السلسلة النصية <code>"let"</code> كلافتة، فسترمي الخطأ <code>[[JavaScript/SyntaxError|SyntaxError]]</code> (لأنَّ <code>let</code> هو مُعرِّف محجوز في JavaScript).

== أمثلة ==

=== استخدام حلقة <code>[[JavaScript/for|for]]</code> لها لافتة مع <code>[[JavaScript/continue|continue]]</code> ===
لاحظ كيف عرّفنا لافتةً لحلقة التكرار الأولى (<code>loop1</code>) وحلقة التكرار الثانية (<code>loop2</code>)، وكيف استخدمنا التعبير البرمجي <code>[[JavaScript/continue|continue]]</code> داخل حلقة التكرار الثانية للانتقال إلى حلقة التكرار الأولى مباشرةً. 

انتبه إلى عدم وجود الناتج <code>i = 1, j = 1</code> ولا <code>i = 1, j = 2</code>:<syntaxhighlight lang="javascript">
var i, j;

loop1:
for (i = 0; i < 3; i++) {      // "loop1"
   loop2:
   for (j = 0; j < 3; j++) {   // "loop2"
      if (i === 1 && j === 1) {
         continue loop1;
      }
      console.log('i = ' + i + ', j = ' + j);
   }
}

//  الناتج
//   "i = 0, j = 0"
//   "i = 0, j = 1"
//   "i = 0, j = 2"
//   "i = 1, j = 0"
//   "i = 2, j = 0"
//   "i = 2, j = 1"
//   "i = 2, j = 2"
</syntaxhighlight>المثال الآتي فيه مصفوفةُ عناصر ومصفوفة اختبارات، وسنحصي عدد العناصر التي تجاوزت جميع الاختبارات:<syntaxhighlight lang="javascript">
var itemsPassed = 0;
var i, j;

top:
for (i = 0; i < items.length; i++) {
  for (j = 0; j < tests.length; j++) {
    if (!tests[j].pass(items[i])) {
      continue top;
    }
  }

  itemsPassed++;
}

</syntaxhighlight>

=== استخدام حلقة <code>[[JavaScript/for|for]]</code> لها لافتة مع <code>[[JavaScript/break|break]]</code> ===
لاحظ الاختلافات بين المثال الآتي والمثال في القسم السابق (الذي استعملنا فيه التعبير <code>[[JavaScript/continue|continue]]</code>):<syntaxhighlight lang="javascript">
var i, j;

loop1:
for (i = 0; i < 3; i++) {      // "loop1"
   loop2:
   for (j = 0; j < 3; j++) {   // "loop2"
      if (i === 1 && j === 1) {
         break loop1;
      }
      console.log('i = ' + i + ', j = ' + j);
   }
}

//  الناتج
//   "i = 0, j = 0"
//   "i = 0, j = 1"
//   "i = 0, j = 2"
//   "i = 1, j = 0"
</syntaxhighlight>

=== استخدام [[JavaScript/block|قسم كتلي]] له لافتة مع <code>[[JavaScript/break|break]]</code> ===
يمكنك استخدام اللافتات مع الأقسام الكتلية البسيطة، لكن لا يُسمَح إلا باستخدام التعبير <code>[[JavaScript/break|break]]</code> معها:<syntaxhighlight lang="javascript">
foo: {
  console.log('face');
  break foo;
  console.log('this will not be executed');
}
console.log('swap');

// "face"
// "swap
</syntaxhighlight>

=== استخدام لافتات عند التصريح عن الدوال ===
بدءًا من ECMAScript 2015، يمكن استخدام لافتات عند [[JavaScript/function|التصريح عن الدوال]] (function declarations) وذلك في نمط non-strict:<syntaxhighlight lang="javascript">
L: function F() {}

</syntaxhighlight>لكن ذلك سيرمي الخطأ <code>[[JavaScript/SyntaxError|SyntaxError]]</code> في [[JavaScript/Strict Mode|نمط strict]]:<syntaxhighlight lang="javascript">
'use strict';
L: function F() {}
// SyntaxError: functions cannot be labelled

</syntaxhighlight>يجدر بالذكر أنَّ الدوال المولِّدة (generator functions) لا يمكن إضافة لافتات إليها في كلا النمطين:<syntaxhighlight lang="javascript">
L: function* F() {}
// SyntaxError: generator functions cannot be labelled

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-labelled-statements ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-labelled-statements ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-12.12 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf ECMAScript 3rd Edition]. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Statement]]