Accueil › Node.js › Écritures atomiques et fichiers temporaires
Écritures atomiques et fichiers temporaires
Fichiers et cheminsdebutant
Écrire directement sur un fichier existant le détruit avant de le remplacer.
await writeFile("config.json", JSON.stringify(config));
L'ouverture tronque. Entre la troncature et la fin de l'écriture, le fichier est vide ou incomplet. Un plantage à cet instant, et l'ancien contenu est perdu sans que le nouveau soit arrivé.
Le motif : temporaire, puis renommage
import { writeFile, rename, rm } from "node:fs/promises";
import { randomUUID } from "node:crypto";
async function ecrireAtomique(cible, contenu) {
const temporaire = `${cible}.${process.pid}.${randomUUID()}.tmp`;
try {
await writeFile(temporaire, contenu, "utf8");
await rename(temporaire, cible);
} catch (err) {
await rm(temporaire, { force: true });
throw err;
}
}
Un lecteur concurrent voit soit l'ancien contenu complet, soit le nouveau. Jamais un état intermédiaire.
Le temporaire vit à côté de la cible
Le renommage n'est atomique que sur le même système de fichiers. Depuis
/tmp, qui est souvent un disque distinct, il échoue avec EXDEV.
// ⛔ EXDEV probable
await rename("/tmp/config.tmp", "/srv/app/config.json");
Un nom unique, pas un nom fixe
config.json.tmp est partagé par tous les processus qui écrivent ce fichier.
Deux écritures simultanées se marchent dessus. L'identifiant du processus et un
suffixe aléatoire règlent la question.
Pour un espace de travail jetable
import { mkdtemp } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
const dossier = await mkdtemp(path.join(os.tmpdir(), "export-"));
mkdtemp crée le répertoire et garantit l'unicité de son nom.
Les termes à connaître
- Troncature
L'ouverture en écriture vide le fichier avant d'écrire. Un plantage entre les deux laisse un fichier de zéro octet, et l'ancien contenu est déjà perdu.
- Écriture atomique
Le motif temporaire puis renommage — le lecteur voit soit l'ancien contenu complet, soit le nouveau, jamais un état intermédiaire.
- Renommage
renameremplace la destination en une seule opération. Atomique uniquement sur le même système de fichiers ; sinon il échoue avecEXDEV.- EXDEV
« cross-device link » — tentative de renommage entre deux systèmes de fichiers. D'où la règle : le temporaire vit dans le répertoire de la cible, pas dans
/tmp.- Synchronisation
fileHandle.sync()force l'écriture du cache du système vers le disque. Sans elle, une coupure d'alimentation peut perdre des données déjà « écrites ».- Nom unique
Deux processus qui écrivent le même fichier ne doivent pas partager le même temporaire. L'identifiant du processus et un suffixe aléatoire suffisent.
- mkdtemp
Crée un répertoire temporaire au nom unique. La seule façon correcte d'obtenir un espace de travail jetable, par opposition à un nom deviné dans
os.tmpdir().
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.