fs.writeFile ב-Node.js: כתיבה, הוספה ויצירת קבצים

fs.writeFile(path, data, callback) כותב מחרוזת או Buffer לקובץ. אם הקובץ לא קיים, Node יוצר אותו; אם הוא קיים, התוכן הישן מוחלף. fs.writeFileSync(path, data) עושה את אותו הדבר ומחכה עד שהכתיבה מסתיימת, ו-fs.appendFile מוסיף לסוף הקובץ במקום להחליף אותו.

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

הוא מדפיס saved ואז את הטקסט שקרא בחזרה; ה-callback מקבל רק שגיאה (או null), אף פעם לא את הנתונים. העבירו 42 במקום המחרוזת והקריאה תזרוק TypeError: הנתונים חייבים להיות מחרוזת או Buffer.

writeFile, ‏writeFileSync ו-fs/promises

שלוש הצורות מקבלות את אותם ארגומנטים, וההבדל הוא איך מחכים לתוצאה.

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 בסקריפטים ובקוד עלייה, ובגרסת ה-promise בשרתים, שבהם כתיבה סינכרונית חוסמת כל בקשה אחרת עד שהדיסק מסיים. הדף על fs/promises מראה את שאר ה-API של ה-promises.

הוספה לקובץ עם appendFile

writeFile מחליף את כל הקובץ. כדי להוסיף שורה ללוג, השתמשו ב-appendFile, שגם יוצר את הקובץ בפעם הראשונה.

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

הקריאה הראשונה מדפיסה "second\n", כי ה-writeFileSync השני החליף את first, והשנייה מדפיסה "second\nthird\nfourth\n" (‏JSON.stringify הופך את תווי השורה החדשה לגלויים). הוסיפו את ה-\n בעצמכם: אף אחת מהפונקציות לא מוסיפה אותו.

לא לדרוס: האפשרות flag

הארגומנט השלישי יכול להיות אובייקט אפשרויות. ה-flag שלו קובע מה קורה לקובץ קיים. 'wx' פירושו "כתוב, אבל היכשל אם הקובץ כבר קיים", וזו הדרך הבטוחה ליצור קובץ פעם אחת בלבד.

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

הקריאה השנייה נכשלת עם EEXIST, ולכן הקובץ עדיין מכיל abc123. שנו את שם הקובץ בקריאה השנייה ל-id2.txt, ושתי הקריאות ידפיסו created.

הדגלים שתפגשו הכי הרבה: 'w' (ברירת המחדל, החלפה), 'a' (הוספה), 'wx' (יצירה בלבד) ו-'ax' (הוספה, אבל רק לקובץ חדש).

בדיקה עם fs.existsSync ואחריה כתיבה משאירה פער: תהליך אחר יכול ליצור את הקובץ בין הבדיקה לכתיבה. 'wx' עושה את שניהם בצעד אחד.

כתיבת JSON לקובץ

writeFile לא מקבל אובייקטים. הפכו אותם לטקסט עם JSON.stringify; הארגומנט השלישי, 2, מזיח את הפלט כך שהקובץ קריא.

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

הקובץ מחזיק את האובייקט על פני כמה שורות מוזחות, ופענוח שלו בחזרה נותן אובייקט שווה, ולכן השורה האחרונה מדפיסה 2. העבירו את האובייקט בלי JSON.stringify והקריאה תזרוק TypeError.

יצירת התיקייה קודם עם mkdir

writeFile יוצר קבצים, לא תיקיות. כתיבה ל-reports/2026/june.txt כש-reports לא קיימת נכשלת עם ENOENT. צרו את הנתיב קודם עם mkdir ו-{ recursive: true }, שיוצר כל תיקייה חסרה ולא עושה כלום אם הן כבר קיימות.

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

הכתיבה הראשונה נכשלת עם ENOENT; אחרי mkdir, אותה כתיבה מצליחה ו-readdir מציג [ 'june.txt' ]. בקוד אמיתי בנו את הנתיבים האלה עם path.join כדי שיעבדו גם ב-Windows.

טעויות נפוצות

להניח שהקובץ נכתב מיד אחרי הקריאה. fs.writeFile חוזר לפני שהנתונים בדיסק. קראו את הקובץ או התחילו את הצעד הבא בתוך ה-callback, או עשו await לגרסת ה-promise.

לאבד נתונים בכתיבה בתוך לולאה. קריאה ל-writeFile פעם אחת לכל פריט מחליפה את הקובץ בכל פעם, ומשאירה רק את הפריט האחרון. השתמשו ב-appendFile, או בנו את כל המחרוזת וכתבו אותה פעם אחת.

לכתוב [object Object]. העברת אובייקט דרך String() או דרך template literal כותבת [object Object]. השתמשו ב-JSON.stringify.