Парсер JSON

JSON (JavaScript Object Notation) — стандартный формат обмена данными для веб-API и файлов конфигурации. Этот инструмент разбирает, валидирует и форматирует JSON с интерактивным древовидным видом для исследования вложенных структур. Конвертация между JSON и другими форматами, такими как YAML или TOML.

Спецификации

• RFC 8259 - The JSON Data Interchange Format
• ECMA-404 - The JSON Data Interchange Syntax
• JSON.org

Типичные сценарии использования

• Форматирование минифицированных ответов API для отладки
• Валидация файлов конфигурации JSON перед развёртыванием
• Конвертация ответов API в YAML для документации
• Исследование глубоко вложенных структур данных из NoSQL-баз данных
• Подготовка JSON-данных для инструментов тестирования API, таких как Postman или curl

Возможности

• Валидация синтаксиса JSON с понятными сообщениями об ошибках и номерами строк
• Форматирование с отступом в 2 пробела
• Минификация JSON для компактного хранения или передачи
• Конвертация в форматы YAML, TOML или XML
• Интерактивный древовидный вид со сворачиваемыми узлами
• Копирование отдельных значений или поддеревьев

Примеры

{
  "users": [
    {
      "id": 1,
      "name": "Alice",
      "email": "alice@example.com"
    },
    {
      "id": 2,
      "name": "Bob",
      "email": "bob@example.com"
    }
  ],
  "total": 2
}

{
  "database": {
    "host": "localhost",
    "port": 5432,
    "name": "myapp"
  },
  "cache": {
    "enabled": true,
    "ttl": 3600
  }
}

Советы

• Ключи JSON должны быть строками в двойных кавычках. Одинарные кавычки недопустимы.
• Висящие запятые после последнего элемента не допускаются в стандартном JSON.
• Для JSON с комментариями используйте парсер JSONC.

Описание Парсер JSON

JSON (JavaScript Object Notation) — универсальный формат обмена данными современного веба. Определённый в RFC 8259 и ECMA-404, JSON представляет структурированные данные с помощью шести типов: строки, числа, логические значения, null, массивы и объекты. Его простота и прямое отображение на структуры данных практически в каждом языке программирования сделали его форматом по умолчанию для REST API, файлов конфигурации, документных баз данных и межсервисной коммуникации.

Синтаксис JSON является строгим подмножеством нотации объектных литералов JavaScript, но с важными ограничениями: ключи должны быть строками в двойных кавычках, висящие запятые не допускаются, а комментарии не поддерживаются. Эти ограничения обеспечивают однозначный разбор во всех реализациях. Валидный JSON-документ должен иметь объект или массив в качестве корневого элемента (хотя RFC 8259 технически допускает любое значение JSON на верхнем уровне, большинство API ожидают объект или массив).

В веб-разработке JSON — стандартный формат запросов и ответов для REST и GraphQL API. Браузеры предоставляют нативные методы JSON.parse() и JSON.stringify(), а Fetch API включает удобный метод .json(). Серверные фреймворки на Node.js, Python (Flask, Django), Go и других языках включают встроенную сериализацию JSON. Документные базы данных, такие как MongoDB, CouchDB и DynamoDB, хранят данные нативно в JSON или JSON-подобных форматах (BSON для MongoDB).

Ограничения JSON породили несколько расширений и альтернатив: JSONC добавляет комментарии для файлов конфигурации, JSON5 смягчает правила синтаксиса, JSON Lines (JSONL/NDJSON) использует один JSON-объект на строку для потоковой передачи, а JSON Schema предоставляет словарь для валидации структуры JSON-документов. Для двоичной эффективности форматы BSON, MessagePack и CBOR предлагают компактную JSON-совместимую сериализацию. Несмотря на эти альтернативы, простой JSON остаётся доминирующим форматом благодаря универсальной поддержке инструментов и человекочитаемости.

JSON намеренно не поддерживает комментарии. Дуглас Крокфорд, популяризировавший формат, исключил их для простоты и предотвращения их неправильного использования в качестве директив разбора (как это произошло в XML). Для файлов конфигурации, где необходима встроенная документация, JSONC (JSON with Comments) нативно поддерживается такими инструментами, как VS Code, TypeScript и ESLint. YAML и TOML также являются хорошими альтернативами, когда файлы конфигурации выигрывают от комментариев, многострочных строк или чётких заголовков секций.

Несмотря на происхождение из JavaScript, JSON не является тем же, что объектный литерал JavaScript. JSON обеспечивает строгие правила синтаксиса: все ключи должны быть в двойных кавычках, допускаются только строки в двойных кавычках, висящие запятые запрещены, а значения вроде undefined и функций не могут быть представлены. JSON.parse() конвертирует строку JSON в объект JavaScript, а JSON.stringify() сериализует объект обратно в строку JSON. Не все объекты JavaScript могут пройти «круговой рейс» через JSON — те, что содержат функции, undefined, Infinity или циклические ссылки, потеряют данные или вызовут ошибки при сериализации.

Для JSON-файлов размером более нескольких мегабайт загрузка всего документа в память сразу может вызвать проблемы с производительностью. Потоковые парсеры — библиотеки в стиле SAX, такие как clarinet и oboe.js для JavaScript или ijson для Python, — обрабатывают документ инкрементально без буферизации всей структуры. Формат JSON Lines (JSONL), где каждая строка — отдельный JSON-объект, идеален для больших наборов данных, так как записи могут обрабатываться по одной. API, возвращающие большие ответы, должны реализовывать пагинацию для контроля размера отдельных ответов. При выборе между JSON и другими форматами JSON — самый безопасный выбор по умолчанию для коммуникации API и обмена данными, поскольку каждый язык и инструмент поддерживает его без дополнительных зависимостей. YAML превосходен для конфигурации, редактируемой людьми, такой как манифесты Kubernetes и CI/CD-конвейеры. TOML лучше всего подходит для конфигурации приложений, выигрывающей от явных заголовков секций и простых пар ключ-значение, таких как Cargo.toml и pyproject.toml.