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
- ECMAScript 2024 §15.2 — Function Definitions
- ECMAScript 2024 §10.2.11 — FunctionDeclarationInstantiation
- ECMAScript 2024 §16.1.7 — GlobalDeclarationInstantiation
- ECMAScript 2024 §16.2.1.6.4 — InitializeEnvironment
- ECMAScript 2024 §14.2.3 — BlockDeclarationInstantiation
- ECMAScript 2024 Annex B.3.2 — Block-Level Function Declarations Web Legacy Compatibility Semantics
- HTML Standard — The script element
- MDN — function declaration
- MDN — function expression
- MDN — Hoisting