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

Browser compatibility

BCD tables only load in the browser

See also