Accueil › Node.js › Les chemins, et pourquoi on ne les concatène pas
Les chemins, et pourquoi on ne les concatène pas
Fichiers et cheminsdebutant
Un chemin ne se construit pas avec +.
import path from "node:path";
const fichier = path.join("donnees", "exports", "2026.csv");
// "donnees/exports/2026.csv" — ou "donnees\\exports\\2026.csv" sous Windows
path.join met le bon séparateur et normalise : les ., les .. et les
séparateurs en double disparaissent.
Ce que la concaténation casse
const base = "donnees/";
const nom = "/exports/2026.csv";
base + nom; // ⛔ "donnees//exports/2026.csv"
path.join(base, nom); // ✅ "donnees/exports/2026.csv"
Le double séparateur passe souvent inaperçu — le système le tolère — puis casse une comparaison de chaînes, une clé de cache ou une entrée de journal.
join assemble, resolve rend absolu
path.join("a", "b"); // "a/b" — relatif
path.resolve("a", "b"); // "/chemin/courant/a/b"
path.resolve("/srv/app", "/etc/x"); // "/etc/x" ⚠️ le second annule le premier
resolve lit les segments de droite à gauche et s'arrête au premier
segment absolu.
Le répertoire du fichier, pas celui du lancement
import path from "node:path";
const modeles = path.join(import.meta.dirname, "modeles");
import.meta.dirname est le répertoire du module en cours.
process.cwd() est celui depuis lequel le processus a été lancé — ce n'est pas
la même chose, et c'est la cause la plus fréquente d'un ENOENT qui
n'apparaît qu'en production.
Les termes à connaître
- path.join
Assemble des segments avec le séparateur du système et normalise le résultat — les
., les..et les séparateurs en double disparaissent.- path.resolve
Rend un chemin absolu, en partant de la droite et en remontant jusqu'au premier segment absolu, ou jusqu'au répertoire courant.
- Séparateur
/sous Linux et macOS,\sous Windows — exposé parpath.sep. Windows accepte aussi/, ce qui fait croire que le problème n'existe pas.- import.meta.dirname
Le répertoire du fichier de module en cours, en chemin absolu. Remplace la conversion manuelle de
import.meta.urlen chemin.- Répertoire courant
process.cwd()— le répertoire depuis lequel le processus a été lancé, pas celui du fichier. Il change selon la façon de démarrer l'application.- path.posix
La variante du module qui raisonne toujours en
/, quel que soit le système. Ce qu'on utilise pour les chemins d'URL, qui ne sont pas des chemins de fichier.- Normalisation
La réécriture d'un chemin sous sa forme canonique, purement textuelle : elle ne consulte pas le disque et ne suit aucun lien.
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.