CKTIS / JavaScript
Elevación de las declaraciones de función en JavaScript
Una función declarada con `function` se puede llamar antes de su declaración en el código fuente. Una expresión de función usada como inicializador no deja la función disponible del mismo modo.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
function name() {
// Function body
}La elevación de las declaraciones de función, o hoisting, significa que JavaScript inicializa la vinculación del nombre con el objeto función antes de ejecutar las instrucciones del ámbito correspondiente. Si el nombre se resuelve a esa vinculación, la llamada puede aparecer antes de la declaración. El código fuente no se mueve y el cuerpo de la función solo se ejecuta al llamarla.
Una declaración situada directamente en el cuerpo de una función se prepara con cada llamada a la función que la contiene. En el nivel superior de un script clásico, si la instanciación de las declaraciones globales tiene éxito, la vinculación de la función corresponde a una propiedad del objeto global, normalmente accesible a través de globalThis. Si el objeto global ya tiene una propiedad propia con el mismo nombre que no es configurable ni permite escritura, la instanciación puede lanzar TypeError antes de que se ejecute ninguna instrucción del script. En un módulo, la vinculación se inicializa durante el enlazado, queda en el ámbito del módulo y no crea una propiedad en globalThis. La elevación no hace que una declaración de un script posterior esté disponible antes de que se procese ese script.
En modo estricto, también en los módulos, una declaración dentro de un bloque se inicializa al entrar en él. Dentro del bloque se puede llamar a la función antes de declararla, pero la vinculación no es visible fuera. En código no estricto, las reglas adicionales de compatibilidad web del anexo B pueden añadir una vinculación en un ámbito exterior. Estas reglas son obligatorias en los navegadores web y opcionales en otros entornos anfitriones. No dependas de esa vinculación en código portable.
Una expresión de función o una función flecha solo crea la función al evaluarse la expresión. En var fromVar = function () {}, la nueva vinculación local empieza con el valor undefined, por lo que intentar llamarla antes de tiempo lanza TypeError. Con let o const, la vinculación permanece en la zona muerta temporal (TDZ) hasta que se inicializa, así que leerla o intentar llamarla antes de tiempo lanza ReferenceError.
Ejemplos
(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
Ejecuta todo el fragmento de una vez. `declared()` y `blockOnly()` funcionan antes de sus declaraciones en sus respectivos ámbitos. Se capturan ambos errores para que el ejemplo pueda terminar.
Lecciones relacionadas
- JavaScript · Lección 5 · Avanzado · Versión: 4
- JavaScript · Lección 8 · Avanzado · Versión: 4
- JavaScript · Lección 16 · Avanzado · Versión: 4
Fuentes
- 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