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
awaitet rend la main pendant l'attente.- Variante synchrone
Les fonctions suffixées
Syncbloquent 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é
codede 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 avecEEXISTsi 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.
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.