عرض مصدر JavaScript/return

<noinclude>{{DISPLAYTITLE:<code>return</code> في JavaScript}}</noinclude>
التعبير البرمجي <code>return</code> يؤدي إلى إنهاء تنفيذ الدالة ويُحدِّد قيمةً لتُعيدها الدالة إلى التعبير الذي استدعاها.
==البنية العامة==
<syntaxhighlight lang="javascript">
return [[expression]]; 
</syntaxhighlight>
=== <code>expression</code> ===
التعبير البرمجي الذي ستُعاد قيمته، وإذا لم يُحدَّد فستُعاد القيمة <code>[[JavaScript/undefined|undefined]]</code>.

== الوصف ==
عندما يُستخدَم التعبير البرمجي <code>return</code> في جسم الدالة، فسيتوقف تنفيذ الدالة؛ وستُعاد القيمة المعطية (إن وجِدَت) إلى التعبير الذي استدعى الدالة. فعلى سبيل المثال، ستعيد الدالة الآتية مربّع الوسيط <code>x</code>، على أن يكون الوسيط <code>x</code> رقميًا: <syntaxhighlight lang="javascript">
function square(x) {
   return x * x;
}
var demo = square(3);
// قيمة المتغير هي 9
</syntaxhighlight>تذكَّر أنَّ القيمة اختيارية، وإذا لم تُحدَّد فستُعاد القيمة <code>[[JavaScript/undefined|undefined]]</code>؛ لاحظ أنَّ جميع التعابير البرمجية الآتية ستوقف تنفيذ الدالة:<syntaxhighlight lang="javascript">
return;
return true;
return false;
return x;
return x + y / 3;
</syntaxhighlight>

=== الإضافة التلقائية للفاصلة المنقوطة ===
لاحظ أنَّ التعبير <code>return</code> يتأثر <nowiki/>[[JavaScript/Lexical Grammar|بالإضافة التلقائية للفواصل المنقوطة]] (ASI)، لذا لا يجوز وضع سطر فارغ بين الكلمة المحجوزة <code>return</code> والتعبير. إذ إنَّ ما يلي:<syntaxhighlight lang="javascript">
return
a + b;
</syntaxhighlight>سيُفسَّر كما يلي بسبب الإضافة التلقائية للفواصل المنقوطة:<syntaxhighlight lang="javascript">
return; 
a + b;
</syntaxhighlight>وسيظهر لك التحذير «unreachable code after return statement» في بعض المتصفحات.

== أمثلة ==

=== مقاطعة تنفيذ الدالة ===
سيتوقف تنفيذ الدالة مباشرةً عند استدعاء التعبير <code>return</code>:<syntaxhighlight lang="javascript">
function counter() {
  for (var count = 1; ; count++) {  // حلقة تكرار لا نهائية
    console.log(count + 'A'); // حتى التكرار 5
      if (count === 5) {          
        return;
      }
      console.log(count + 'B');  // حتى 4
    }
  console.log(count + 'C');  // لن تحدث أبدًا
}

counter();

// الناتج
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

</syntaxhighlight>

=== إعادة دالة من دالة أخرى ===
تسمى هذه التقنية بالتعابير المغلقة [[JavaScript/Closures|closures]]:<syntaxhighlight lang="javascript">
function magic(x) {
  return function calc(x) { return x * 42; };
}

var answer = magic();
answer(1337); // 56154

</syntaxhighlight>

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

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-return-statement ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-return-statement ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-12.9 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Statement]]