Formations — 1 037 leçons en français

Accueil › JavaScript › Charger un module à la demande

Charger un module à la demande

Modules et outillageavance

import() est une fonction. Elle charge un module quand on l'appelle.

bouton.addEventListener("click", async () => {
  const { ouvrirEditeur } = await import("./editeur.js");
  ouvrirEditeur();
});

L'éditeur — et ses dépendances — n'est téléchargé qu'au premier clic. Si personne ne clique, il n'est jamais téléchargé.

Elle rend une promesse d'espace de noms

const m = await import("./m.js");
m.nomme;        // un export nommé
m.default;      // l'export par défaut
// la forme habituelle
const { default: Editeur, VERSION } = await import("./editeur.js");

Oublier default est l'erreur la plus fréquente : on obtient un objet là où on attendait une fonction.

Ce que ça change

Sans découpage :  bundle unique de 800 Ko
Avec découpage :  250 Ko au démarrage + 550 Ko à la demande

L'utilisateur qui ne va pas dans l'éditeur ne paie pas l'éditeur.

Les trois bons candidats

  1. Une route que tout le monde ne visite pas.
  2. Une bibliothèque lourde utilisée dans un seul écran — éditeur de code, graphiques, moteur de rendu.
  3. Une fonctionnalité conditionnelle : outils d'administration, mode avancé.

Les termes à connaître

import()

Une fonction qui charge un module et rend une promesse de son espace de noms. Utilisable n'importe où, y compris dans une condition.

Espace de noms

L'objet rendu par import(). Les exports nommés en sont les propriétés, et l'export par défaut s'y trouve sous la clé default.

Morceau

Le fichier séparé que le bundler produit pour chaque import(). Il n'est téléchargé que lorsque la ligne s'exécute.

Chargement différé

Reporter le téléchargement d'un module jusqu'au moment où il sert. Le premier levier de performance d'une application monopage.

Préchargement

Lancer le téléchargement avant d'en avoir besoin — au survol d'un lien, par exemple. On gagne la latence sans alourdir le démarrage.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.