L'écosystème Node.js met à disposition des modules intégrés puissants pour interagir avec le système de fichiers. Parmi eux, les modules fs (File System) et path sont fondamentaux pour la gestion des opérations liées aux fichiers et aux structures de répertoire.

Le module fs pour les opérations sur les fichiers

Le module fs offre une interface synchrone et asynchrone pour une variété de tâches liées aux fichiers, telles que la lecture, l'écriture, la copie, la suppression et le renommage. Pour l'utiliser, il faut d'abord l'importer :

const fs = require('fs');

Voici quelques fonctions courantes du module fs :

1. fs.stat() et fs.statSync() : Obtenir des informations sur un fichier ou un répertoire Ces méthodes retournent un objet Stats contenant des informations sur le fichier, notamment s'il s'agit d'un fichier (isFile()) ou d'un répertoire (isDirectory()).

fs.stat('./mon_repertoire', (err, stats) => {
  if (err) {
    console.error('Erreur lors de la récupération des stats:', err);
    return;
  }
  console.log(`Est un fichier : ${stats.isFile()}`);
  console.log(`Est un répertoire : ${stats.isDirectory()}`);
});

2. fs.mkdir() et fs.mkdirSync() : Créer un répertoire Permet de créer un nouveau répertoire.

fs.mkdir('./nouveau_dossier', (err) => {
  if (err) {
    console.error("Échec de la création du répertoire:", err);
    return;
  }
  console.log("Répertoire créé avec succès.");
});

3. fs.writeFile() et fs.writeFileSync() : Écrire dans un fichier Cette fonction crée un fichier s'il n'existe pas, ou écrase son contenu s'il existe. Elle prend en paramètres le chemin du fichier, les données à écrire et une fonctoin de rappel.

fs.writeFile('./mon_fichier.txt', 'Contenu initial.', (err) => {
  if (err) {
    console.error("Erreur lors de l'écriture du fichier:", err);
    return;
  }
  console.log("Écriture réussie.");
});

4. fs.appendFile() et fs.appendFileSync() : Ajouter du contenu à un fichier Similaire à writeFile, mais ajoute les données à la fin du fichier existant.

fs.appendFile('./mon_fichier.txt', '\nAjout de texte.', (err) => {
  if (err) {
    console.error("Erreur lors de l'ajout au fichier:", err);
    return;
  }
  console.log("Ajout réussi.");
});

5. fs.readFile() et fs.readFileSync() : Lire le contenu d'un fichier Lit le contenu d'un fichier. Les données sont renvoyées sous forme de buffer par défaut.

fs.readFile('./mon_fichier.txt', (err, data) => {
  if (err) {
    console.error("Erreur lors de la lecture du fichier:", err);
    return;
  }
  console.log("Contenu brut (buffer) :", data);
  console.log("Contenu (string) :", data.toString('utf8'));
});

6. fs.readdir() et fs.readdirSync() : Lire le contenu d'un répertoire Liste les fichiers et sous-répertoires d'un répertoire donné.
7. fs.rename() et fs.renameSync() : Renommer ou déplacer un fichier/répertoire Permet de modifier le nom d'un fichier ou répertoire, ou de le déplacer vers un nouvel emplacement.

fs.rename('./mon_fichier.txt', './nouveau_nom.txt', (err) => {
  if (err) {
    console.error("Échec du renommage:", err);
    return;
  }
  console.log("Renommage réussi.");
});

8. fs.rmdir() et fs.rmdirSync() : Supprimer un répertoire Supprime un répertoire vide. Pour supprimer un répertoire non vide, fs.rm() (disponible dans les versions récentes de Node.js) ou des modules tiers peuvent être nécessaires.
9. fs.unlink() et fs.unlinkSync() : Supprimer un fichier Supprime un fichier.
10. fs.createReadStream() et fs.createWriteStream() : Lecture et écriture via des flux (Streams) Ces méthodes sont idéales pour manipuler de grands fichiers, car elles traitent les données par morceaux (chunks) plutôt que de charger l'intégralité du fichier en mémoire.

Le module path pour la manipulation des chemins

Le module path fournit des utilitaires pour travailler avec les chemins de fichiers de manière indépendante de la plateforme. Il gère les différences entre les systèmes d'exploitation (comme le séparateur de répertoire : / sur Unix/macOS, \ sur Windows).

const path = require('path');

Fonctions clés du module path :