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

CKTIS / JavaScript

IIFE — expressão de função invocada imediatamente

Uma IIFE cria uma função e chama-a de imediato. Executa código no seu próprio âmbito de função, aceita argumentos e devolve um resultado sem uma declaração de função separada.

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

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

IIFE significa Immediately Invoked Function Expression: uma expressão de função chamada logo após a criação da função. É um padrão sintático, não uma palavra-chave. «Imediatamente» significa quando a execução chega a essa expressão.

Em (function () {})(), os parênteses à volta de function () {} criam um contexto de expressão, em vez de uma declaração. Os () finais chamam a função; sem eles, obténs a própria função. A função pode ter um nome, por isso uma IIFE não tem de ser anónima.

Os parâmetros e as variáveis declarados dentro da função, incluindo com var, permanecem no seu âmbito. No entanto, isto não é uma fronteira de segurança: a função pode aceder às variáveis externas disponíveis. return determina o resultado da chamada; se não for devolvido nenhum valor, o resultado é undefined.

Quando uma IIFE autónoma começa por ( depois de outra expressão, um ; inicial impede que as duas instruções se juntem acidentalmente. O exemplo usa a sintaxe clássica de funções, sem funções de seta. A IIFE em si não precisa de nenhuma API do ambiente de execução, mas o exemplo apresenta o resultado com console.log, disponibilizado por esse ambiente. Num navegador, este método faz parte de uma API Web; no Node.js, pertence à consola do Node.js.

Exemplos

var result = (function (start) {
  var offset = 2;
  return start + offset;
})(40);
console.log(result);

Resultado

42

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