Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes