CKTIS / JavaScript
return — terminar uma função e devolver um valor
A instrução return termina a execução de uma função e pode enviar um resultado para o local que a chamou. Aprende sobre return sem expressão, saídas antecipadas e o problema da mudança de linha.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
return;
return expression;return é uma palavra-chave reservada. Numa função normal, return expression; avalia a expressão e devolve o seu valor ao local que chamou a função. return; devolve undefined; obtém-se o mesmo resultado ao chegar ao fim de uma função normal sem return. A instrução não é permitida no nível superior de um script padrão ou de um módulo.
Usa um return antecipado para sair de uma função depois de verificar uma condição. Sai de toda a função atual, não apenas de um ciclo que a envolva. No exemplo, doublePositive(0) sai antes da multiplicação, enquanto doublePositive(3) devolve 6.
Não coloques uma mudança de linha entre return e a expressão devolvida. A inserção automática de ponto e vírgula pode terminar a instrução como return;. Para uma expressão em várias linhas, começa, por exemplo, com return ( e continua nas linhas seguintes.
Um bloco finally é executado antes de um retorno pendente ser concluído. O seu próprio return ou throw pode substituir esse resultado, por isso evita essas substituições. return é sintaxe ECMAScript, não uma Web API; o exemplo não requer APIs do navegador.
Exemplos
function doublePositive(value) {
if (value <= 0) return;
return value * 2;
}
console.log(doublePositive(3));
console.log(doublePositive(0));Resultado
6 undefined
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.