Formations — 1 037 leçons en français

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

rename remplace la destination en une seule opération. Atomique uniquement sur le même système de fichiers ; sinon il échoue avec EXDEV.

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().

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.