Le module FileSystem (fs) est un module central de Node.js, offrant des fonctionnalités puissantes pour interagir avec les fichiers de manière programmatique. Ce module est utile pour diverses tâches, notamment la gestion des configurations, l'organisation des données et la lecture ou l'écriture du contenu des fichiers.

Lecture de fichiers avec fs.readFile

La méthode fs.readFile retourne une promesse qui se résout avec le contenu du fichier. Elle permet une lecture asynchrone des fichiers, ce qui la rend adaptée à la lecture de fichiers texte et binaires.

fs.readFile(path, options)

• path - le chemin du fichier à lire ;
• options - un objet optionnel spécifiant des options telles que l'encodage.

Imaginez la création d'une plateforme de blog dynamique. Ici, la méthode fs.readFile intervient pour récupérer rapidement le contenu d'un article à partir d'un fichier.

Exemple de code : Lecture de contenu

const fs = require('fs').promises;

fs.readFile('blog-post.txt', 'utf-8')
  .then(content => {
    console.log('Current content:', content);
  })
  .catch(err => {
    console.error('Error reading file:', err);
  });

Explication étape par étape

Écriture de fichiers avec fs.writeFile

La méthode fs.writeFile retourne une promesse qui se résout lorsque le fichier a été écrit. Elle est utilisée pour écrire de manière asynchrone des données dans un fichier, qu'il soit nouveau ou existant. Elle offre des options pour spécifier les données, l'encodage et les permissions du fichier.

fs.writeFile(file, data, options)

• file - le chemin du fichier dans lequel écrire ;
• data - les données à écrire, qui peuvent être une chaîne de caractères ou un buffer ;
• options - un objet optionnel permettant de spécifier des options telles que l'encodage et le mode du fichier.

Supposons que nous devions enregistrer un nouvel utilisateur dans le fichier user-db.json. Ici, la méthode fs.writeFile garantit que nos informations trouvent leur place.

Exemple de code : Écriture de données utilisateur

const fs = require("fs").promises;

const newUser = {
  id: 1,
  username: "Nero",
  email: "arman@example.com",
};

const fileName = "user-db.json";

fs.writeFile(fileName, JSON.stringify(newUser), "utf-8")
  .then(() => {
    console.log("User information saved successfully.");
  })
  .catch((err) => {
    console.error("Error writing file:", err);
  });

Explication étape par étape

Extension avec fs.appendFile

La méthode fs.appendFile retourne une promesse qui se résout lorsque les données ont été ajoutées au fichier. Elle est utilisée pour ajouter de manière asynchrone des données à un fichier existant, tout en préservant son contenu antérieur.

fs.appendFile(file, data, options)

• file - le chemin du fichier auquel les données seront ajoutées ;
• data - les données à ajouter, qui peuvent être une chaîne de caractères ou un buffer ;
• options - un objet optionnel permettant de spécifier des options telles que l'encodage et le mode du fichier.

Imaginez une application de messagerie animée enregistrant les conversations. Au fur et à mesure que de nouveaux messages arrivent, la méthode fs.appendFile ajoute ces messages au journal de discussion tout en préservant les interactions précédentes.

Exemple de code : Ajout de messages de discussion

const fs = require("fs").promises;

const newMessage = "User2: Hello, how are you?";

fs.appendFile("chat.txt", newMessage + "\n")
  .then(() => {
    console.log("Message added to chat log.");
  })
  .catch((err) => {
    console.error("Error appending message:", err);
  });

Explication étape par étape

Remarque

• fs.writeFile est utilisé pour remplacer complètement le contenu d’un fichier ou créer un nouveau fichier ;
• fs.appendFile est utilisé pour ajouter de nouvelles données à la fin d’un fichier existant sans écraser le contenu déjà présent.