Formations — 1 037 leçons en français

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 import en 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 ./, comme express ou zod. Il désigne un paquet, cherché dans les node_modules en remontant les dossiers.

`moduleResolution`

L'option qui choisit l'algorithme de résolution. Les valeurs utiles aujourd'hui sont bundler, node16 et nodenext.

`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 ; node10 l'ignore.

`paths`

Une table d'alias, de @/* vers src/* 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.

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.