return

ما زال العمل جارٍ على هذه الترجمة.

ال return ينهي البيان تنفيذ الوظيفة ويحدد قيمة ليتم ارجاعها الى دالة الاستدعاء

بناء الجملة

return [expression]; 
expression
التعبير المراد استرجاع قيمتة. اذا تم حذفه, فسيتم ارجاع undefined بدلاً من ذالك

الوصف

عند استخدام عبارة return في جسم الدالة,يتم ايقاف تنفيذ الوظيفة.اذا تم تحديد ذالك,يتم ارجاع قيمة معينة الى دالة الاستدعاء.على سبيل المثال,تعرض الدالة التالية مربع سعتها , x,حيث x هي رقم.

function square(x) {
   return x * x;
}
var demo = square(3);
// demo will equal 9

اذا تم حذف القيمة,يتم ارجاع undefined بدلاُ من ذالك

تعطل عبارات الارجاع التالية تنفيذ الوظيفة

return;
return true;
return false;
return x;
return x + y / 3;

الادراج التلقائي للفاصلة المنقوطة (Semicolon)

تتاثر عبارة الارجاع بادراج الفاصلة المنقوطة تلقائياُُ (ASI) .

لا يُسمح بفاصل سطر بين الكلمة الاساسية return  و التعبير

return
a + b;

is transformed by ASI into:

return; 
a + b;

The console will warn "unreachable code after return statement".

Starting with Firefox 40, a warning is shown in the console if unreachable code is found after a return statement.

To avoid this problem (to prevent ASI), you could use parentheses:

return (
  a + b
);

Examples

Interrupt a function

A function immediately stops at the point where return is called.

function counter() {
  for (var count = 1; ; count++) {  // infinite loop
    console.log(count + 'A'); // until 5
      if (count === 5) {          
        return;
      }
      console.log(count + 'B');  // until 4
    }
  console.log(count + 'C');  // never appears
}

counter();

// Output:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Returning a function

See also the article about Closures.

function magic() {
  return function calc(x) { return x * 42; };
}

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

Specifications

Specification
ECMAScript (ECMA-262)
The definition of 'Return statement' in that specification.

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
returnChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 3Opera Full support 3Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

See also