A declaração return finaliza a execução de uma função e específica os valores que devem ser retonarna para onde a função foi chamada.

Sintaxe

return [[expressão]]; 
expressão
A expressão cujo valor será retornado. Se omitido, será retornado undefined.

Descrição

Quando uma declaração return é usada no corpo da função, a execução de uma função é paurada. Se especificado, um dado valor é retornado para onde a função foi chamada. Se a expressão for omitida, será retornado undefined. As declarações return a seguir para a execução da função:

return;
return true;
return false;
return x;
return x + y / 3;

Inserção Automática de Ponto e Vírgula

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.

return
a + b;

o ASI transforma isso em:

return; 
a + b;

O controle irá alertar "unreachable code after return statement" (código não atingivel após a declaração return).

A partir do Gecko 40 (Firefox 40 / Thunderbird 40 / SeaMonkey 2.37), um alerta é mostrado no console se um código que não pode ser atingido for detectado após uma declaração return.

Exemplos

return

A função a seguir retorna o quadro do seu argumento, x, quando x é um número.

function square(x) {
   return x * x;
}

Interrompendo uma função

Uma função para imediatamente no ponto em que return é chamado.

function contador() {
  for (var count = 1; ; count++) {  // loop infinito
    console.log(count + 'A'); // até 5
      if (count === 5) {          
        return;
      }
      console.log(count + 'B');  // até 4
    }
  console.log(count + 'C');  // nunca aparece
}

contador();

// Saída:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Retornando uma função

Veja também o artigo sobre Closures.

function magica(x) {
  return function calc(x) { return x * 42; };
}

var resposta = magica();
resposta(1337); // 56154

Especificações

Especificação Situação Comentário
ECMAScript 1st Edition (ECMA-262) Padrão Definição inicial.
ECMAScript 5.1 (ECMA-262)
The definition of 'Return statement' in that specification.
Padrão  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Return statement' in that specification.
Padrão  
ECMAScript Latest Draft (ECMA-262)
The definition of 'Return statement' in that specification.
Padrão em tempo real  

Compatibilidade de navegadores

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: alefesouza
 Última atualização por: alefesouza,