re:re:actable
Урок 032 минуты чтения

Как читать и писать JSON-файлы в Node.js?

На этой странице
Кратко

JSON-файл в Node.js обычно читают как строку через fs/promises, затем преобразуют в объект через JSON.parse. Для записи объект превращают в строку через JSON.stringify.

Вопрос

Как прочитать и записать JSON-файл в Node.js и какие ошибки при этом обрабатывать?

Чтение JSON

import { readFile } from 'node:fs/promises';
 
const raw = await readFile('users.json', 'utf8');
const users = JSON.parse(raw);
 
console.log(users);

Важно указывать 'utf8', иначе вернется Buffer.

Запись JSON

import { writeFile } from 'node:fs/promises';
 
const user = {
  id: 1,
  name: 'Анна',
};
 
await writeFile('user.json', JSON.stringify(user, null, 2), 'utf8');

Аргументы null, 2 делают JSON читаемым:

{
  "id": 1,
  "name": "Анна"
}

Обработка ошибок

Ошибки могут возникнуть при чтении файла, отсутствии прав или невалидном JSON.

try {
  const raw = await readFile('settings.json', 'utf8');
  const settings = JSON.parse(raw);
  console.log(settings);
} catch (error) {
  console.error('Не удалось прочитать настройки:', error.message);
}

Почему не всегда стоит использовать import?

В ESM можно импортировать JSON с import attributes, но для конфигов, которые могут меняться во время работы приложения, чтение через fs часто понятнее. Импорт модулей кэшируется, а readFile каждый раз читает актуальное содержимое файла.

Что важно помнить

  • JSON.parse бросает SyntaxError на некорректном JSON — оборачивайте в try/catch.
  • Для читаемого файла используйте JSON.stringify(data, null, 2).
  • Безопасная запись: сначала во временный файл, затем rename — файл не повредится при сбое.
  • В ESM JSON можно импортировать с атрибутом: import data from './data.json' with { type: 'json' }.

Мини-шпаргалка

  • Чтение: readFile + JSON.parse.
  • Запись: JSON.stringify + writeFile.
  • Для красивого файла используй JSON.stringify(data, null, 2).
  • Оборачивай чтение и парсинг в try/catch.
  • Не используй JSON-файлы как базу данных для конкурентных записей.

Документация

Node.js: fs.readFile, Node.js: Import attributes.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам