return - JavaScript _ MDN

Prévia do material em texto

return
A declaração return finaliza a execução de uma função e especifica os valores que
devem ser retonados para onde a função foi chamada.
Sintaxe
return [[expression]];
A expressão cujo valor será retornado. Se omitido, undefined é retornado.
Descrição
Quando uma declaração return é usada em um corpo de função, a execução dessa
função é parada. Se especificado, um dado valor é retornado à quem chamou a função. Se
a expressão for omitida, undefined será retornado. Todas as declarações return a seguir
param a execução da função:
Inserção Automática de Ponto-e-Vírgula
This page was translated from English by the community. Learn more and join the
MDN Web Docs community.
expression
JS
return;
return true;
return false;
return x;
return x + y / 3;
https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Translated_content#active_locales
https://developer.mozilla.org/en-US/docs/MDN/Community/Contributing/Translated_content#active_locales
https://developer.mozilla.org/pt-BR/
A declaração return é afetada pela inserção automática de ponto e vírgula (ASI). Nenhum
terminador de linha é permitido entre a palavra-chave return e a expressão.
é transformado pelo ASI em:
return;
a + b;
O console irá alertar "unreachable code after return statement" (código inacessível após a
declaração return).
Exemplos
return
A função a seguir retorna o quadro do seu argumento, x , quando x é um número.
Interrompendo uma função
Uma função para imediatamente no ponto em que return é chamado.
JS
return
a + b;
Nota: A partir do Gecko 40, um alerta é mostrado no console se um código
inacessível é encontrado após uma declaração return .
JS
function square(x) {
 return x * x;
}
JS
function counter() {
 for (var count = 1; ; count++) {
https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Lexical_grammar#automatic_semicolon_insertion
Retornando uma função
Veja também o artigo sobre Closures.
Especificações
 // loop infinito
 console.log(count + "A"); // até 5
 if (count === 5) {
 return;
 }
 console.log(count + "B"); // até 4
 }
 console.log(count + "C"); // nunca aparece
}
counter();
// Saída:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A
JS
function magic(x) {
 return function calc(x) {
 return x * 42;
 };
}
var answer = magic();
answer(1337); // 56154
https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Closures
Specification
ECMAScript Language Specification
# sec-return-statement
Compatibilidade com navegadores
Report problems with this compatibility data on GitHub
return
Chrome 1 Edge 12 Firefox 1 Opera 3 Safari 1 Chrome
Android
18
Tip: you can click/tap on a cell for more information.
Full support
Veja também
Funções (en-US)
Closures
Help improve MDN
Was this page helpful to you?
Learn how to contribute.
C
h
ro
m
e
E
d
g
e
Fi
re
fo
x
O
p
er
a
S
af
ar
i
C
h
ro
m
e 
A
n
d
ro
id
Yes No
https://tc39.es/ecma262/multipage/ecmascript-language-statements-and-declarations.html#sec-return-statement
https://tc39.es/ecma262/multipage/ecmascript-language-statements-and-declarations.html#sec-return-statement
https://github.com/mdn/browser-compat-data/issues/new?mdn-url=https%3A%2F%2Fdeveloper.mozilla.org%2Fpt-BR%2Fdocs%2FWeb%2FJavaScript%2FReference%2FStatements%2Freturn&metadata=%3C%21--+Do+not+make+changes+below+this+line+--%3E%0A%3Cdetails%3E%0A%3Csummary%3EMDN+page+report+details%3C%2Fsummary%3E%0A%0A*+Query%3A+%60javascript.statements.return%60%0A*+Report+started%3A+2024-03-13T18%3A49%3A05.851Z%0A%0A%3C%2Fdetails%3E&title=javascript.statements.return+-+%3CSUMMARIZE+THE+PROBLEM%3E&template=data-problem.yml
https://github.com/mdn/browser-compat-data/issues/new?mdn-url=https%3A%2F%2Fdeveloper.mozilla.org%2Fpt-BR%2Fdocs%2FWeb%2FJavaScript%2FReference%2FStatements%2Freturn&metadata=%3C%21--+Do+not+make+changes+below+this+line+--%3E%0A%3Cdetails%3E%0A%3Csummary%3EMDN+page+report+details%3C%2Fsummary%3E%0A%0A*+Query%3A+%60javascript.statements.return%60%0A*+Report+started%3A+2024-03-13T18%3A49%3A05.851Z%0A%0A%3C%2Fdetails%3E&title=javascript.statements.return+-+%3CSUMMARIZE+THE+PROBLEM%3E&template=data-problem.yml
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions
https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Closures
https://github.com/mdn/content/blob/main/CONTRIBUTING.md
This page was last modified on 8 de nov. de 2023 by MDN contributors.
https://developer.mozilla.org/pt-BR/docs/Web/JavaScript/Reference/Statements/return/contributors.txt