Formations — 1 037 leçons en français

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é par path.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.url en 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.

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.