Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Chargement des modules et découpage du code

Les modules forment un graphe de dépendances. Un import statique déclare une dépendance, tandis que `import()` permet au code de demander un module à l’exécution. Le découpage du code en éléments chargés séparément dépend de l’environnement et des outils, et pas seulement de la syntaxe JavaScript.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

// module.mjs
export const name = value;

// main.mjs
import { name } from "./module.mjs";

async function main() {
  const namespace = await import("./module.mjs");
}
main().catch(console.error);

Le chargement des modules consiste à obtenir un module et ses dépendances, à relier les imports aux exports, puis à exécuter le code. Les déclarations statiques import se trouvent au niveau supérieur du module ; elles identifient les dépendances avant l’exécution du corps du module. Les noms importés sont des liaisons vivantes vers les exports, et non des copies de leurs valeurs.

L’import dynamique import(specifier) est une expression également disponible dans les scripts ordinaires et à l’intérieur de conditions ou de fonctions. Il renvoie une Promise. Si le module est chargé, lié et exécuté avec succès, la valeur de la promesse tenue est en général l’objet d’espace de noms du module, qui contient ses exports. Toutefois, si le module exporte une valeur appelable sous le nom then, le mécanisme de résolution de la promesse l’appelle avec les fonctions de résolution et de rejet. L’issue de la promesse dépend alors de cet appel : sa valeur n’est pas nécessairement l’objet espace de noms. Gérez le rejet avec try/catch autour de await ou avec .catch(). Son argument peut être calculé à l’exécution.

Le découpage du code consiste à préparer des parties d’une application pouvant être chargées séparément. import() fournit un point de chargement à la demande, mais ECMAScript n’impose ni fichiers de sortie séparés ni requêtes réseau. La résolution des spécificateurs et la récupération des modules dépendent de l’hôte ; le découpage des fichiers de sortie dépend des outils. Importer de nouveau le même module résolu ne réexécute pas son code. En l’absence d’export appelable nommé then, les deux imports dynamiques réussis fournissent le même objet espace de noms.

Les modules statiques ont été introduits dans ES2015, et import() dans ES2020. Il ne s’agit pas d’un tableau de compatibilité des navigateurs : la spécification du langage ne garantit pas la prise en charge dans un navigateur donné, et Node 24 ne prouve pas la prise en charge des Web APIs. Dans l’exemple, main.mjs est le point d’entrée et les deux appels à import() ciblent le même module local, math.mjs. Seul ce module est chargé dynamiquement. L’exemple n’illustre pas le découpage du code par un bundler.

Exemples

// math.mjs
export const double = value => value * 2;

// main.mjs
async function main() {
  const first = await import("./math.mjs");
  const second = await import("./math.mjs");
  console.log(first.double(21));
  console.log(first === second);
}
main().catch(console.error);

Résultat

42
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources