Node.js fs.writeFile: Dateien schreiben, anhängen, anlegen

fs.writeFile(path, data, callback) schreibt einen String oder Buffer in eine Datei. Existiert die Datei nicht, legt Node sie an; existiert sie, wird der alte Inhalt ersetzt. fs.writeFileSync(path, data) macht dasselbe und wartet, bis das Schreiben fertig ist, und fs.appendFile hängt ans Ende der Datei an, statt sie zu ersetzen.

const fs = require('fs');

fs.writeFile('hello.txt', 'Hello, file', (err) => {
    if (err) {
        console.error('Write failed:', err.message);
        return;
    }
    console.log('saved');
    console.log(fs.readFileSync('hello.txt', 'utf8'));
});

Es gibt saved aus und dann den Text, den es zurückgelesen hat; der Callback bekommt nur einen Fehler (oder null), nie die Daten. Übergib 42 statt des Strings, und der Aufruf wirft einen TypeError: Die Daten müssen ein String oder ein Buffer sein.

writeFile, writeFileSync und fs/promises

Die drei Formen nehmen dieselben Argumente und unterscheiden sich darin, wie du auf das Ergebnis wartest.

const fs = require('fs');
const fsp = require('fs/promises');

fs.writeFileSync('a.txt', 'one');            // blocks, throws on error

fs.writeFile('b.txt', 'two', (err) => {});   // callback with err

await fsp.writeFile('c.txt', 'three');       // promise, use in async code

Nimm writeFileSync in Skripten und im Startcode und die Promise-Variante in Servern, wo ein synchrones Schreiben jede andere Anfrage blockiert, bis die Festplatte fertig ist. Die Seite zu fs/promises zeigt den Rest der Promise-API.

Mit appendFile an eine Datei anhängen

writeFile ersetzt die ganze Datei. Um eine Zeile an ein Log anzuhängen, nimm appendFile, das die Datei beim ersten Mal auch anlegt.

const fs = require('fs');

fs.writeFileSync('log.txt', 'first\n');
fs.writeFileSync('log.txt', 'second\n');
console.log(JSON.stringify(fs.readFileSync('log.txt', 'utf8')));

fs.appendFileSync('log.txt', 'third\n');
fs.appendFileSync('log.txt', 'fourth\n');
console.log(JSON.stringify(fs.readFileSync('log.txt', 'utf8')));

Das erste Lesen gibt "second\n" aus, weil das zweite writeFileSync first ersetzt hat, und das zweite gibt "second\nthird\nfourth\n" aus (JSON.stringify macht die Zeilenumbrüche sichtbar). Füg das \n selbst hinzu: Keine der beiden Funktionen tut das.

Nicht überschreiben: die Option flag

Das dritte Argument kann ein Options-Objekt sein. Sein flag legt fest, was mit einer vorhandenen Datei passiert. 'wx' bedeutet "schreiben, aber fehlschlagen, wenn die Datei schon existiert", das ist der sichere Weg, eine Datei nur einmal anzulegen.

const fs = require('fs');

function createOnce(file, text) {
    try {
        fs.writeFileSync(file, text, { flag: 'wx' });
        console.log('created', file);
    } catch (err) {
        if (err.code === 'EEXIST') {
            console.log(file, 'already exists, left alone');
        } else {
            throw err;
        }
    }
}

createOnce('id.txt', 'abc123');
createOnce('id.txt', 'zzz999');
console.log(fs.readFileSync('id.txt', 'utf8'));

Der zweite Aufruf schlägt mit EEXIST fehl, die Datei enthält also weiterhin abc123. Ändere den Dateinamen im zweiten Aufruf in id2.txt, und beide Aufrufe geben created aus.

Die Flags, denen du am häufigsten begegnest: 'w' (Standard, ersetzen), 'a' (anhängen), 'wx' (nur anlegen) und 'ax' (anhängen, aber nur an eine neue Datei).

Erst mit fs.existsSync zu prüfen und dann zu schreiben, hat eine Lücke: Ein anderer Prozess kann die Datei zwischen Prüfung und Schreiben anlegen. 'wx' erledigt beides in einem Schritt.

JSON in eine Datei schreiben

writeFile nimmt keine Objekte an. Mach sie mit JSON.stringify zu Text; das dritte Argument, 2, rückt die Ausgabe ein, damit die Datei lesbar ist.

const fs = require('fs');

const settings = { theme: 'dark', fontSize: 14, plugins: ['git', 'lint'] };

fs.writeFileSync('settings.json', JSON.stringify(settings, null, 2));

console.log(fs.readFileSync('settings.json', 'utf8'));

const loaded = JSON.parse(fs.readFileSync('settings.json', 'utf8'));
console.log(loaded.plugins.length);

Die Datei enthält das Objekt über mehrere eingerückte Zeilen, und das Zurückparsen ergibt ein gleiches Objekt, deshalb gibt die letzte Zeile 2 aus. Übergib das Objekt ohne JSON.stringify, und der Aufruf wirft einen TypeError.

Zuerst den Ordner mit mkdir anlegen

writeFile legt Dateien an, keine Ordner. Schreiben nach reports/2026/june.txt, wenn reports nicht existiert, schlägt mit ENOENT fehl. Leg den Pfad zuerst mit mkdir und { recursive: true } an, das jeden fehlenden Ordner anlegt und nichts tut, wenn sie schon existieren.

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

async function main() {
    try {
        await fs.writeFile('reports/2026/june.txt', 'sales: 12');
    } catch (err) {
        console.log('first try:', err.code);
    }

    await fs.mkdir('reports/2026', { recursive: true });
    await fs.writeFile('reports/2026/june.txt', 'sales: 12');

    console.log(await fs.readdir('reports/2026'));
}
main();

Das erste Schreiben schlägt mit ENOENT fehl; nach mkdir gelingt dasselbe Schreiben, und readdir listet [ 'june.txt' ]. Bau diese Pfade in echtem Code mit path.join, damit sie auch unter Windows funktionieren.

Häufige Fehler

Annehmen, dass die Datei direkt nach dem Aufruf geschrieben ist. fs.writeFile kehrt zurück, bevor die Daten auf der Festplatte sind. Lies die Datei oder starte den nächsten Schritt im Callback, oder warte mit await auf die Promise-Variante.

Daten verlieren, weil in einer Schleife geschrieben wird. writeFile einmal pro Element aufzurufen, ersetzt die Datei jedes Mal, übrig bleibt nur das letzte Element. Nimm appendFile oder bau den ganzen String und schreib ihn einmal.

[object Object] schreiben. Ein Objekt, das durch String() oder ein Template Literal geht, wird als [object Object] geschrieben. Nimm JSON.stringify.