Node.js Dosya Yazma: fs.writeFile, appendFile ve Oluşturma

fs.writeFile(path, data, callback) bir dosyaya bir string ya da Buffer yazar. Dosya yoksa Node onu oluşturur; varsa eski içerik değiştirilir. fs.writeFileSync(path, data) aynısını yapar ve yazma bitene kadar bekler, fs.appendFile ise dosyayı değiştirmek yerine sonuna ekler.

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'));
});

Önce saved, sonra geri okuduğu metni yazdırır; callback yalnızca bir hata (ya da null) alır, asla veriyi almaz. String yerine 42 verirsen çağrı bir TypeError fırlatır: veri bir string ya da bir Buffer olmalı.

writeFile, writeFileSync ve fs/promises

Üç biçim de aynı argümanları alır ve sonucu nasıl beklediğin konusunda farklıdır.

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

writeFileSync fonksiyonunu script'lerde ve açılış kodunda, promise sürümünü ise senkron yazmanın disk işini bitirene kadar diğer bütün istekleri blokladığı sunucularda kullan. Promise API'sinin geri kalanını fs/promises sayfası gösteriyor.

appendFile ile dosyaya ekleme

writeFile bütün dosyayı değiştirir. Bir log'a satır eklemek için, dosyayı ilk seferde de oluşturan appendFile kullan.

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')));

İlk okuma "second\n" yazdırır, çünkü ikinci writeFileSync first değerinin yerine geçti; ikincisi ise "second\nthird\nfourth\n" yazdırır (JSON.stringify yeni satırları görünür yapar). \n karakterini kendin ekle: iki fonksiyon da eklemez.

Üzerine yazma: flag seçeneği

Üçüncü argüman bir seçenek nesnesi olabilir. Onun flag değeri, var olan bir dosyaya ne olacağına karar verir. 'wx', "yaz, ama dosya zaten varsa başarısız ol" demektir ve bir dosyayı yalnızca bir kez oluşturmanın güvenli yoludur.

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'));

İkinci çağrı EEXIST ile başarısız olur, bu yüzden dosya hâlâ abc123 tutar. İkinci çağrının dosya adını id2.txt yap, iki çağrı da created yazdırır.

En sık karşılaşacağın flag'ler: 'w' (varsayılan, değiştir), 'a' (ekle), 'wx' (yalnızca oluştur) ve 'ax' (ekle, ama yalnızca yeni bir dosyaya).

Önce fs.existsSync ile kontrol edip sonra yazmanın bir açığı var: başka bir süreç kontrol ile yazma arasında dosyayı oluşturabilir. 'wx' ikisini tek adımda yapar.

Dosyaya JSON yazma

writeFile nesne kabul etmez. Onları JSON.stringify ile metne çevir; üçüncü argüman olan 2, dosya okunabilir olsun diye çıktıyı girintiler.

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);

Dosya, nesneyi girintili birkaç satıra yayılmış olarak tutar ve onu geri parse etmek eşit bir nesne verir, bu yüzden son satır 2 yazdırır. Nesneyi JSON.stringify olmadan verirsen çağrı bir TypeError fırlatır.

Önce mkdir ile klasörü oluştur

writeFile klasör değil, dosya oluşturur. reports yokken reports/2026/june.txt dosyasına yazmak ENOENT ile başarısız olur. Önce path'i mkdir ve { recursive: true } ile oluştur; bu, eksik her klasörü oluşturur ve klasörler zaten varsa hiçbir şey yapmaz.

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

İlk yazma ENOENT ile başarısız olur; mkdir sonrasında aynı yazma başarılı olur ve readdir, [ 'june.txt' ] listeler. Gerçek kodda bu path'leri Windows'ta da çalışsınlar diye path.join ile oluştur.

Sık yapılan hatalar

Dosyanın çağrıdan hemen sonra yazıldığını sanmak. fs.writeFile, veri diske yazılmadan döner. Dosyayı oku ya da sonraki adımı callback'in içinde başlat, veya promise sürümünü await et.

Bir döngüde yazarak veri kaybetmek. Her öğe için bir kez writeFile çağırmak dosyayı her seferinde değiştirir ve yalnızca son öğeyi bırakır. appendFile kullan ya da bütün string'i oluşturup bir kez yaz.

[object Object] yazmak. Bir nesneyi String() ya da bir template literal içinden geçirmek [object Object] yazar. JSON.stringify kullan.