return

Sintaxe

return [[expression]];

expression

A expresso cujo valor ser retornado. Se omitido, undefined retornado.

Descrio

Quando uma declarao return usada em um corpo de funo, a execuo dessa funo parada. Se especificado, um dado valor retornado quem chamou a funo. Se a expresso for omitida, undefined ser retornado. Todas as declaraes return a seguir param a execuo da funo:

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

Insero Automtica de Ponto-e-Vrgula

A declarao return afetada pela insero automtica de ponto e vrgula (ASI). Nenhum terminador de linha permitido entre a palavra-chave return e a expresso.

return
a + b;

transformado pelo ASI em:

return;
a + b;

O console ir alertar "unreachable code after return statement" (cdigo inacessvel aps a declarao return).

Exemplos

return

A funo a seguir retorna o quadro do seu argumento, x, quando x um nmero.

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

Interrompendo uma funo

Uma funo para imediatamente no ponto em que return chamado.

function counter() {
  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
}

counter();

// Sada:
// 1A
// 1B
// 2A
// 2B
// 3A
// 3B
// 4A
// 4B
// 5A

Retornando uma funo

Veja tambm o artigo sobre Closures.

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

var answer = magic();
answer(1337); // 56154

Especificaes

Compatibilidade com navegadores

Veja tambm

• Funes
• Closures