CKTIS / JavaScript
Remontée des déclarations de fonction en JavaScript
Une fonction déclarée avec `function` peut être appelée avant sa déclaration dans le code source. Une expression de fonction utilisée comme initialiseur ne rend pas la fonction disponible de la même façon.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
function name() {
// Function body
}La remontée des déclarations de fonction, ou hoisting, signifie que JavaScript initialise la liaison du nom avec l’objet fonction avant d’exécuter les instructions de la portée concernée. Si le nom désigne cette liaison, l’appel peut précéder la déclaration. Le code source n’est pas déplacé et le corps de la fonction ne s’exécute qu’à l’appel.
Une déclaration placée directement dans un corps de fonction est traitée à chaque appel de la fonction englobante. Au niveau supérieur d’un script classique, si l’instanciation des déclarations globales réussit, la liaison de la fonction correspond à une propriété de l’objet global, généralement accessible via globalThis. Si l’objet global possède déjà une propriété propre de même nom, à la fois non configurable et non modifiable, l’instanciation peut déclencher une TypeError avant l’exécution de la moindre instruction du script. Dans un module, la liaison est initialisée lors de l’édition des liens, reste dans la portée du module et ne crée aucune propriété de globalThis. La remontée ne rend pas disponible une déclaration d’un script ultérieur avant que celui-ci soit traité.
En mode strict, y compris dans les modules, une déclaration à l’intérieur d’un bloc est initialisée à l’entrée dans le bloc. On peut appeler la fonction avant sa déclaration dans ce bloc, mais la liaison n’est pas visible à l’extérieur. En mode non strict, les règles distinctes de compatibilité web de l’annexe B peuvent ajouter une liaison dans une portée englobante. Ces règles sont obligatoires dans les navigateurs web et facultatives dans les autres environnements hôtes. Ne comptez pas sur cette liaison dans du code portable.
Une expression de fonction ou une fonction fléchée ne crée l’objet fonction qu’à l’évaluation de l’expression. Dans var fromVar = function () {}, la nouvelle liaison locale vaut d’abord undefined : une tentative d’appel anticipé déclenche une TypeError. Avec let ou const, la liaison reste dans la zone morte temporelle (TDZ) jusqu’à son initialisation : une lecture ou une tentative d’appel anticipée déclenche une ReferenceError.
Exemples
(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"; }
}
})();Résultat
declared TypeError ReferenceError block
Exécutez tout l’extrait en une fois. Les appels `declared()` et `blockOnly()` fonctionnent avant leurs déclarations dans leurs portées respectives. Les deux erreurs sont interceptées pour que l’exemple s’exécute jusqu’au bout.
Leçons associées
- JavaScript · Leçon 5 · Avancé · Version : 4
- JavaScript · Leçon 8 · Avancé · Version : 4
- JavaScript · Leçon 16 · Avancé · Version : 4
Sources
- 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