Запись в файл в Node.js: fs.writeFile и appendFile

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 в скриптах и коде запуска, а версию на промисах на серверах, где синхронная запись блокирует все остальные запросы, пока диск не закончит. Остальной API на промисах показан на странице про fs/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.

Потеря данных при записи в цикле. Вызов writeFile для каждого элемента каждый раз заменяет файл, и в нём остаётся только последний элемент. Используйте appendFile или соберите всю строку и запишите её один раз.

Запись [object Object]. Если пропустить объект через String() или шаблонную строку, запишется [object Object]. Используйте JSON.stringify.