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

CKTIS / JavaScript

Sintaxe de uma expressão de função invocada imediatamente (IIFE)

Uma IIFE cria e invoca uma função numa só expressão. Os parênteses de agrupamento não fazem a chamada; é a lista de argumentos que se segue que invoca a função.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

(function (parameter) { /* body */ })(argument);
(function localName(parameter) { /* body */ })(argument);

Em (function (parameter) { /* body */ })(argument), os parênteses à volta de function … { … } agrupam a expressão de função e o (argument) final invoca a função resultante. Usa () para não passar argumentos. O agrupamento, por si só, não executa o corpo. A chamada ocorre sempre que a expressão é avaliada.

Uma instrução de expressão não pode começar por function. Sem agrupamento, function () {}(); nessa posição provoca um SyntaxError, pois a forma anónima não é uma declaração válida nesse contexto. Uma expressão de função pode ser anónima ou ter nome; na forma com nome, localName não cria uma associação no âmbito envolvente.

As declarações locais do corpo não ficam acessíveis pelo nome no código envolvente. No entanto, uma closure devolvida pode continuar a aceder-lhes depois da chamada. O valor devolvido com return é o resultado da chamada. Se uma função comum chegar ao fim sem return, o resultado é undefined.

Se uma IIFE autónoma começar uma linha com (, termina a instrução anterior com um ponto e vírgula ou inicia a IIFE com ;(. Uma quebra de linha, por si só, não garante a separação: o analisador pode interpretar ( como o início de uma lista de argumentos para chamar a expressão anterior.

Exemplos

const total = (function (price) {
  const fee = 2;
  return price + fee;
})(40);

console.log(total);

Resultado

42

O argumento `40` é passado ao parâmetro `price`. A variável `fee` permanece local e `total` recebe o valor devolvido `42`, não a função.

Lições relacionadas

  • JavaScript · Lição 30 · Avançado · Versão: 4

Fontes