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

CKTIS / JavaScript

Elevação de declarações de função em JavaScript

Uma função declarada com `function` pode ser chamada antes da declaração no código-fonte. Uma expressão de função usada como inicializador não disponibiliza a função da mesma forma.

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

Sintaxe

function name() {
  // Function body
}

A elevação de declarações de função, ou hoisting, significa que o JavaScript inicializa o vínculo do nome com o objeto função antes de executar as instruções do âmbito relevante. Se o nome corresponder a esse vínculo, a chamada pode aparecer antes da declaração. O código-fonte não é deslocado e o corpo da função só é executado quando esta é chamada.

Uma declaração diretamente no corpo de uma função é preparada a cada chamada da função que a contém. No nível superior de um script clássico, se a instanciação das declarações globais for bem-sucedida, o vínculo da função corresponde a uma propriedade do objeto global, normalmente acessível através de globalThis. Se o objeto global já tiver uma propriedade própria com o mesmo nome que não seja configurável nem permita escrita, a instanciação pode lançar um TypeError antes de ser executada qualquer instrução do script. Num módulo, o vínculo é inicializado durante a ligação, fica no âmbito do módulo e não cria uma propriedade em globalThis. A elevação não disponibiliza uma declaração de um script posterior antes de esse script ser processado.

Em modo estrito, incluindo em módulos, uma declaração dentro de um bloco é inicializada à entrada no bloco. Dentro desse bloco, é possível chamar a função antes da declaração, mas o vínculo não é visível no exterior. Em código não estrito, as regras adicionais de compatibilidade web do anexo B podem acrescentar um vínculo num âmbito exterior. Estas regras são obrigatórias nos navegadores web e opcionais noutros ambientes anfitriões. Não dependas desse vínculo em código portável.

Uma expressão de função ou função de seta só cria a função quando a expressão é avaliada. Em var fromVar = function () {}, o novo vínculo local tem inicialmente o valor undefined, pelo que uma tentativa de chamada antecipada lança TypeError. Com let ou const, o vínculo fica na zona morta temporal (TDZ) até ser inicializado, pelo que a leitura ou uma tentativa de chamada antecipada lança ReferenceError.

Exemplos

(function () {
  "use strict";

  console.log(declared());
  function declared() { return "declared"; }

  try {
    fromVar();
  } catch (error) {
    console.log(error.name);
  }
  var fromVar = function () {};

  try {
    fromConst();
  } catch (error) {
    console.log(error.name);
  }
  const fromConst = () => {};

  {
    console.log(blockOnly());
    function blockOnly() { return "block"; }
  }
})();

Resultado

declared
TypeError
ReferenceError
block

Executa o excerto inteiro de uma vez. `declared()` e `blockOnly()` funcionam antes das declarações nos respetivos âmbitos. Ambos os erros são intercetados para que o exemplo possa chegar ao fim.

Lições relacionadas

  • JavaScript · Lição 5 · Avançado · Versão: 4
  • JavaScript · Lição 8 · Avançado · Versão: 4
  • JavaScript · Lição 16 · Avançado · Versão: 4

Fontes