Formations — 1 037 leçons en français

Accueil › Node.js › Lire et écrire un fichier

Lire et écrire un fichier

Fichiers et cheminsdebutant

Les fichiers s'ouvrent avec node:fs/promises, et avec await.

import { readFile, writeFile } from "node:fs/promises";

const texte = await readFile("config.json", "utf8");
const config = JSON.parse(texte);

await writeFile("sortie.json", JSON.stringify(config, null, 2), "utf8");

Sans encodage, une lecture rend des octets — un Buffer, pas une chaîne. "utf8" n'est pas une option de confort, c'est ce qui décide du type du résultat.

L'écriture tronque

writeFile ouvre le fichier avec le drapeau "w" : il est vidé avant que le premier octet soit écrit. Pour ajouter à la fin, appendFile.

On n'interroge pas l'existence, on traite l'erreur

try {
  return JSON.parse(await readFile(chemin, "utf8"));
} catch (err) {
  if (err.code === "ENOENT") return null;   // pas de fichier : cas normal
  throw err;                                 // tout le reste : pas le nôtre
}

Tester l'existence puis ouvrir laisse un intervalle pendant lequel l'état peut changer. Et vous devrez écrire le catch de toute façon.

Les quatre codes à reconnaître

Code Ce qui s'est passé
ENOENT le fichier, ou un répertoire du chemin, n'existe pas
EACCES les droits refusent l'opération
EISDIR c'est un répertoire, pas un fichier
EEXIST le fichier existe déjà, et le drapeau l'interdisait

Les variantes synchrones

import { readFileSync } from "node:fs";

const cle = readFileSync("./cle.pem", "utf8");   // au démarrage : acceptable

readFileSync bloque le fil unique. Au démarrage, personne n'attend. Dans un gestionnaire de requête, tout le monde attend.

Les termes à connaître

node:fs/promises

La version à promesses du module de système de fichiers. C'est celle qu'on importe par défaut, parce qu'elle s'utilise avec await et rend la main pendant l'attente.

Variante synchrone

Les fonctions suffixées Sync bloquent le fil d'exécution jusqu'au bout de l'opération. Acceptables au démarrage du processus, jamais dans un gestionnaire de requête.

Tampon

Sans encodage, une lecture rend un Buffer — des octets bruts. Avec "utf8", elle rend une chaîne. Les deux ne se comparent pas et ne se concatènent pas de la même façon.

Code d'erreur

La propriété code de l'erreur levée : ENOENT, EACCES, EISDIR, EEXIST. C'est elle qu'on teste, jamais le message, qui dépend du système.

ENOENT

« Error NO ENTry » — le fichier ou un répertoire du chemin n'existe pas. L'erreur la plus fréquente, et presque toujours un chemin mal construit.

Drapeau d'ouverture

"w" tronque le fichier, "a" ajoute à la fin, "wx" échoue avec EEXIST si le fichier existe déjà. Le drapeau par défaut d'une écriture est "w".

Fenêtre de concurrence

L'intervalle entre un test d'existence et l'ouverture du fichier. Pendant cet intervalle, un autre processus peut créer ou supprimer le fichier — d'où la règle : on ouvre, puis on traite l'erreur.

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.