Как форматировать JSON: полное руководство

JSON (JavaScript Object Notation) — самый популярный формат обмена данными в веб-разработке. Практически каждое API возвращает данные именно в этом формате. Но работать с неформатированным JSON — занятие не из приятных. Вставьте свой JSON в JSON-форматтер и убедитесь сами.

Зачем форматировать JSON?

Представьте, что вы получили ответ от API:

{
  "users": [
    {
      "id": 1,
      "name": "Иван",
      "email": "ivan@example.com",
      "roles": ["admin", "editor"]
    },
    {
      "id": 2,
      "name": "Мария",
      "email": "maria@example.com",
      "roles": ["viewer"]
    }
  ]
}

Попробуйте быстро найти email второго пользователя. Непросто, правда? А теперь тот же JSON, но отформатированный:

{
  "users": [
    {
      "id": 1,
      "name": "Иван",
      "email": "ivan@example.com",
      "roles": ["admin", "editor"]
    },
    {
      "id": 2,
      "name": "Мария",
      "email": "maria@example.com",
      "roles": ["viewer"]
    }
  ]
}

Разница очевидна. Форматирование помогает:

• Быстрее находить нужные данные — структура видна с первого взгляда
• Легче отлаживать ошибки — пропущенная запятая или скобка сразу бросается в глаза
• Удобнее сравнивать — при code review отформатированный JSON проще diff’ить

Типичные ошибки в JSON

Висящая запятая

{
  "name": "Иван",
  "age": 30 // Ошибка! Запятая после последнего элемента
}

В отличие от JavaScript, JSON не допускает trailing commas.

Одинарные кавычки

{
  "name": "Иван" // Ошибка! Только двойные кавычки
}

Комментарии

JSON не поддерживает комментарии. Если вам нужны комментарии — используйте JSONC или YAML.

Минификация JSON

Обратная операция — минификация — убирает все пробелы и переводы строк. Это полезно для:

• Экономии трафика — минифицированный JSON занимает меньше места
• API-запросов — тело запроса обычно отправляется минифицированным
• Хранения в базе данных — compact-формат экономит дисковое пространство

Валидация JSON

Перед использованием JSON стоит проверить его корректность. Невалидный JSON может привести к:

• Крашу парсера
• Некорректному отображению данных
• Сложным для отладки ошибкам

JSON-форматтер автоматически проверяет JSON и показывает точное место ошибки с номером строки и описанием проблемы.

Горячие клавиши для продуктивности

Если вы работаете с JSON ежедневно, запомните:

Действие	Результат
Вставить JSON	Автоформатирование
Ctrl+M	Минификация
Ctrl+F	Форматирование

Итого

Работа с JSON — повседневная задача для разработчика. Правильные инструменты экономят время и помогают избежать ошибок. Попробуйте JSON-форматтер — он работает прямо в браузере, без отправки данных на сервер. А если нужно сгенерировать TypeScript-типы из JSON — загляните в JSON to Types.