Formations — 1 037 leçons en français

Accueil › JavaScript › Découper son code en modules

Découper son code en modules

Modules et outillageavance

Un module est un fichier dont les déclarations ne fuient pas.

// tri.js
export function trierParNom(liste) { … }
export const SEPARATEUR = ";";

function interne() { … }        // invisible de l'extérieur
// app.js
import { trierParNom, SEPARATEUR } from "./tri.js";

Les trois formes d'import

import { a, b } from "./m.js";          // nommés
import { a as alias } from "./m.js";    // renommé
import * as tout from "./m.js";         // tout dans un objet
import defaut from "./m.js";            // l'export par défaut

Nommé plutôt que par défaut

// ❌ chaque fichier le nomme comme il veut
export default function () { … }

// ✅ un seul nom partout
export function trierParNom() { … }

Un export par défaut s'importe sous n'importe quel nom. Trois fichiers, trois noms pour la même fonction : la recherche globale ne trouve plus rien, et l'outillage ne peut rien renommer.

Un import est une liaison vivante

// compteur.js
export let n = 0;
export function incrementer() { n += 1; }

// app.js
import { n, incrementer } from "./compteur.js";
incrementer();
console.log(n);      // 1 — pas 0

L'import pointe vers la déclaration d'origine. Il est en revanche en lecture seule du côté de l'importateur : n = 5 lève une erreur.

Le mode strict est automatique

total = 5;      // ReferenceError dans un module

Dans un script classique, cette ligne créait une globale en silence. C'est l'une des raisons pour lesquelles tout code moderne est un module.

Les termes à connaître

Module

Un fichier dont les déclarations ne fuient pas : rien n'est visible de l'extérieur sauf ce qui est exporté explicitement.

Export nommé

export function f() {} — importé par son nom exact, entre accolades. La forme à préférer : elle se renomme mal par accident, et l'outillage la complète.

Export par défaut

export default … — un seul par fichier, importé sous n'importe quel nom. Pratique, et précisément pour ça source d'incohérence entre fichiers.

Liaison vivante

Un import n'est pas une copie : si le module exportateur réaffecte la valeur, l'importateur voit la nouvelle. C'est une référence, pas un instantané.

Mode strict

Automatique dans un module, sans l'écrire. D'où les erreurs qui apparaissent en passant d'un script à un module : une variable non déclarée lève au lieu de devenir globale.

Import circulaire

Deux modules qui s'importent l'un l'autre. Toléré, mais l'un des deux voit l'autre à moitié chargé — d'où des undefined au moment de l'import.

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.