import defer : le lazy-loading natif des modules JS arrive
Axel Grégoire
#javascript #tc39 #modules-es #nodejs #typescript #denoTu as déjà ajouté un import en haut d'un fichier pour une fonctionnalité utilisée seulement dans un cas sur cent ? Le module entier s'exécute quand même, à chaque démarrage, même si tu n'appelles jamais l'export en question. C'est le fonctionnement normal des modules ES : dès que le moteur rencontre un import, il charge et évalue tout le graphe de dépendances, immédiatement.
Une proposition TC39 baptisée import defer change cette règle : elle permet de séparer le chargement d'un module de son exécution. Elle vient de franchir des étapes concrètes cette année : Deno l'a livrée par défaut dans sa version 2.8 (22 mai 2026), TypeScript en comprend déjà la syntaxe depuis la 5.9 (1er août 2025), et Chrome la teste derrière un flag. Node.js, en revanche, n'a pour l'instant que des tests internes en cours d'intégration.
Voici ce que fait réellement import defer, où tu peux t'en servir aujourd'hui, et comment t'organiser en attendant que le reste de l'écosystème rattrape Deno.
Le problème : un import s'exécute toujours, même inutilisé
Prends une librairie de données de locale, un parseur PDF, ou un module qui n'a de sens que pour les comptes admin. Avec un import classique, tout le code de premier niveau de ce module tourne dès le chargement de ton fichier, qu'il serve ou non pendant cette exécution précise.
// fr-locale.js : construit une grosse table de données au chargement console.log("Construction de la table de locale FR..."); export const table = buildHugeLocaleTable(); // app.js import { table } from "./fr-locale.js"; // buildHugeLocaleTable() tourne ici, même si l'utilisateur // a choisi l'anglais et n'utilisera jamais "table" Le contournement habituel est l'import dynamique import(), qui retourne une promesse et permet de ne charger le module qu'au moment voulu. Le problème : il est asynchrone. Il force à restructurer du code par ailleurs synchrone autour d'un await, ou à jongler avec des promesses juste pour retarder un chargement.
La syntaxe : chargement immédiat, exécution différée
import defer propose un compromis : le module et ses dépendances sont résolus et chargés tout de suite (donc pas de surprise réseau ou de fichier manquant en cours d'exécution), mais le code de premier niveau ne s'exécute qu'au premier accès à une propriété de l'espace de noms importé.
import defer * as frLocale from "./fr-locale.js"; // Rien ne s'est encore exécuté ici, malgré l'import. function afficherEnFrancais() { // Le corps de fr-locale.js s'exécute maintenant, // au tout premier accès à une propriété. return frLocale.table.bienvenue; } Deux règles à retenir : seule la forme namespace est autorisée (import defer * as x from "..."), pas d'import nommé ni d'import par défaut. Et l'exécution reste synchrone : pas de promesse, pas d'await. C'est ce qui distingue vraiment import defer d'import() : le premier diffère une exécution synchrone déjà planifiée, le second charge un module de façon asynchrone à la demande.
Où ça fonctionne réellement, aujourd'hui
La proposition en est au stage 3 à TC39 : le design est stabilisé, mais elle n'a pas atteint le stage 4 et n'a pas été retenue pour l'instantané ES2026. Une inclusion dans une future édition annuelle (ES2027 au plus tôt) dépend de son passage en stage 4.
- Deno : support livré par défaut dans Deno 2.8, sorti le 22 mai 2026.
- TypeScript : depuis la version 5.9, le compilateur comprend et type-checke la syntaxe
import defer, à condition d'utiliser l'optionmoduleàpreserveouesnext. TypeScript ne la transpile pas vers autre chose : il faut un runtime qui la supporte nativement en sortie. - Chrome / V8 : implémentation présente mais derrière un flag expérimental, pas encore activée par défaut.
- Node.js : pas de support livré à ce jour. Des tests internes (smoke tests sur les modules synthétiques) sont en cours d'intégration dans le dépôt du projet, signe que le travail avance, mais rien d'utilisable en production sur Node 22, 24 ou 26.
Pourquoi ça compte de vérifier la version de Node
Si ton code tourne sur Node.js, retiens la situation à la rentrée 2026 : Node 26 est la version Current, Node 24 la LTS active jusqu'en 2028, Node 22 en maintenance. Aucune des trois ne supporte import defer nativement pour l'instant. Écrire cette syntaxe dans un projet Node aujourd'hui provoquera une erreur de parsing à l'exécution.
Ce délai n'a rien d'inhabituel : Node.js attend généralement qu'une proposition atteigne un support stable dans V8 avant de l'exposer, même sans flag expérimental, pour éviter d'introduire une syntaxe qui pourrait encore changer de forme avant le stage 4. Les tests de non-régression déjà présents dans le dépôt du projet indiquent que le travail a commencé, mais aucune date n'a été communiquée pour une sortie, même derrière un flag --experimental.
Que faire en attendant côté Node.js
Pour un projet qui tourne sur Node.js ou dans un navigateur sans le flag V8, la solution reste l'import dynamique classique, éventuellement caché derrière une fonction pour limiter la friction :
let _frLocale; async function getFrLocale() { if (!_frLocale) { _frLocale = await import("./fr-locale.js"); } return _frLocale; } // Utilisation const { table } = await getFrLocale(); Ce n'est pas exactement équivalent : tu payes la complexité de l'asynchrone, mais tu obtiens dès maintenant, sur toutes les plateformes actuelles, le même bénéfice de fond : ne pas exécuter un module tant qu'il ne sert pas. Si ton projet cible spécifiquement Deno, tu peux en revanche utiliser import defer sans détour dès Deno 2.8.
Comment se préparer sans se précipiter
Trois recommandations concrètes :
- Ne mets pas
import deferdans du code destiné à Node.js ou à un navigateur en production aujourd'hui : aucun des deux ne l'exécute nativement. - Si tu es sur Deno, ou si tu écris une librairie avec des exports lourds et rarement utilisés, teste la syntaxe dès maintenant : c'est l'environnement le plus mature pour l'instant.
- Si tu utilises TypeScript 5.9+, tu peux déjà écrire et type-checker du code avec
import deferen ciblantesnext, tout en gardant un import dynamique comme repli pour les runtimes qui ne le supportent pas encore — utile pour préparer une migration progressive sans bloquer sur le calendrier de Node.
Pour détecter le support au runtime sans faire planter un environnement qui ne le comprend pas, il faut s'appuyer sur un bundler qui sait transformer la syntaxe en repli, plutôt que sur une détection en JavaScript pur : import defer est une syntaxe, pas une API, donc un parseur qui ne la connaît pas refuse le fichier avant même l'exécution. C'est pour cette raison que webpack a ouvert une implémentation expérimentale de la proposition dans son bundler : en attendant un support natif généralisé, faire transiter ce code par un outil de build qui la comprend et la retranscrit reste la seule option pour un projet qui vise plusieurs runtimes à la fois.
La proposition suit un chemin classique : un moteur en tête (V8 pour l'instant, via Chrome), un runtime qui l'adopte en premier (Deno), un outillage qui la comprend en avance (TypeScript), et Node.js qui rattrape ensuite avec ses propres tests de non-régression avant de l'activer. Le rythme des dernières années sur des propositions comparables suggère que Node devrait suivre dans les prochains mois — mais tant que ce n'est pas livré, la fonction import() classique reste le seul choix fiable pour du code multiplateforme.
À lire aussi
JavaScript 3 novembre 2026 7 minIterator Helpers : chunks, includes et join passent Stage 4
TC39 a promu chunks, windows, includes et join au Stage 4 le 29 septembre 2026. Ce qui change pour les itérateurs JS, et comment t'y préparer.
Lire l'article →JavaScript 16 octobre 2026 6 minNode.js 26 devient LTS : Temporal par défaut, ce qui casse
Node.js 26 entre en LTS fin octobre 2026 avec Temporal activé par défaut et de nouvelles méthodes Map. Check-list des breaking changes avant de migrer.
Lire l'article →JavaScript 11 septembre 2026 7 minAdieu lodash et atob : 2 API JS natives à adopter maintenant
Iterator helpers et Uint8Array.toBase64() sont Baseline depuis 2025 : du JS chaîné et paresseux, du base64 fiable, sans dépendance externe à installer.
Lire l'article →