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
- Une route que tout le monde ne visite pas.
- Une bibliothèque lourde utilisée dans un seul écran — éditeur de code, graphiques, moteur de rendu.
- 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.
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.