Baseline Widely available
The return
statement ends function execution and specifies a value to be returned to the function caller.
function getRectArea(width, height) {
if (width > 0 && height > 0) {
return width * height;
}
return 0;
}
console.log(getRectArea(3, 4));
// Expected output: 12
console.log(getRectArea(-3, 4));
// Expected output: 0
Syntax
return;
return expression;
expression
Optional
The expression whose value is to be returned. If omitted, undefined
is returned.
The return
statement can only be used within function bodies. When a return
statement is used in a function body, the execution of the function is stopped. The return
statement has different effects when placed in different functions:
next()
method returns { done: true, value: returnedValue }
.next()
method returns a promise fulfilled with { done: true, value: returnedValue }
.If a return
statement is executed within a try
block, its finally
block, if present, is first executed, before the value is actually returned.
The syntax forbids line terminators between the return
keyword and the expression to be returned.
The code above is transformed by automatic semicolon insertion (ASI) into:
This makes the function return undefined
and the a + b
expression is never evaluated. This may generate a warning in the console.
To avoid this problem (to prevent ASI), you could use parentheses:
Examples Interrupt a functionA function immediately stops at the point where return
is called.
function counter() {
// Infinite loop
for (let count = 1; ; count++) {
console.log(`${count}A`); // Until 5
if (count === 5) {
return;
}
console.log(`${count}B`); // Until 4
}
console.log(`${count}C`); // Never appears
}
counter();
// Logs:
// 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;
};
}
const answer = magic();
answer(1337); // 56154
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4