Accueil › TypeScript › La résolution des modules
La résolution des modules
Modules et déclarationsintermediaire
Écrire import { formater } from "./outils" ne désigne pas un fichier : cela
désigne une chaîne que quelqu'un devra transformer en fichier. TypeScript
fait ce travail pour vérifier les types ; l'exécution — Node, un empaqueteur,
le navigateur — le refait pour charger le code. Si les deux n'appliquent pas la
même règle, la compilation passe et l'exécution échoue.
Deux sortes de spécificateurs
import { formater } from "./outils"; // relatif : un fichier voisin
import express from "express"; // nu : un paquet dans node_modules
Un spécificateur relatif est résolu depuis le dossier du fichier importateur.
Un spécificateur nu est cherché dans node_modules, en remontant de dossier en
dossier jusqu'à la racine.
L'option qui décide
{ "compilerOptions": { "module": "nodenext", "moduleResolution": "nodenext" } }
| Valeur | Extension dans un import relatif | index implicite |
|---|---|---|
bundler |
optionnelle | oui |
node16 / nodenext |
obligatoire en ESM | non en ESM |
La règle qui surprend
// avec nodenext
import { formater } from "./outils"; // ❌ TS2835
import { formater } from "./outils.js"; // ✅ — l'extension du fichier PRODUIT
L'ESM de Node résout les chemins comme des URL : il ne tente ni .js ni
/index.js. TypeScript impose donc l'extension, et c'est celle de la sortie
qu'on écrit — ./outils.js depuis un fichier outils.ts.
Choisir
Code empaqueté par Vite, webpack ou esbuild → bundler. Code exécuté
directement par Node → nodenext. Le mauvais choix ne se voit pas à la
compilation.
Les termes à connaître
- Résolution de module
Le travail qui transforme la chaîne écrite dans un
importen un fichier précis sur le disque. TypeScript la simule pour trouver les types, l'exécution la refait pour trouver le code.- Spécificateur relatif
Un chemin commençant par
./ou../. Il désigne un fichier à côté de l'importateur, jamais un paquet.- Spécificateur nu
Un nom sans
./, commeexpressouzod. Il désigne un paquet, cherché dans lesnode_modulesen remontant les dossiers.- `moduleResolution`
L'option qui choisit l'algorithme de résolution. Les valeurs utiles aujourd'hui sont
bundler,node16etnodenext.- `exports` du package.json
Le champ qui déclare les points d'entrée publics d'un paquet, et peut servir des fichiers différents selon qu'on l'importe en ESM ou en CommonJS. Les algorithmes modernes le respectent ;
node10l'ignore.- `paths`
Une table d'alias, de
@/*verssrc/*par exemple. Elle n'existe que pour la vérification de types : l'outil d'exécution doit connaître le même alias, sinon l'import échoue à l'exécution.
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.