"moduleResolution"

L’algorithme par lequel le compilateur retrouve les fichiers désignés dans les imports.

Sur cette page

Exemple

#
JSON
{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "Bundler"
  }
}

Définition et utilisation

#

L’option moduleResolution détermine comment le compilateur transforme une chaîne d’import, par exemple "react" ou "./utils", en un fichier précis contenant du code et des types.

Bundler imite le comportement d’outils comme Vite ou webpack : il permet d’omettre les extensions de fichiers et comprend le champ exports des paquets. NodeNext reproduit les règles exactes de Node.js, où l’extension est obligatoire dans un import de module ES.

L’ancienne valeur Node (aussi appelée node10) ne prend pas en charge le champ exports et n’est plus recommandée dans les nouveaux projets.

Syntaxe

#
Syntaxe
"moduleResolution": "Bundler"

Plus d’exemples

#
Un import avec extension en NodeNext
TypeScript
// moduleResolution: "NodeNext", fichier ES
import { add } from './math.js'
// En NodeNext, vous indiquez l’extension .js, même si le fichier source est math.ts.

Bonnes pratiques

#
  • Dans les applications avec bundler, utilisez Bundler, et dans le code pour Node.js, NodeNext.
  • Si l’import d’un paquet « n’a soudain plus de types », vérifiez que moduleResolution comprend le champ exports de ce paquet.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.