Из чего состоит структура JSON

Структура JSON: фундаментальные компоненты

JSON (JavaScript Object Notation) — это легкий текстовый формат для обмена данными, основанный на синтаксисе объектов JavaScript, но являющийся независимым от языка. Его структура состоит из пар "ключ-значение", организованных в иерархические коллекции. Основные строительные блоки JSON — это два типа структур: упорядоченные списки (массивы) и неупорядоченные коллекции (объекты). Значениями могут быть шесть простых типов данных.

Основные компоненты структуры JSON

1. Объекты (Objects)

    *   Оборачиваются в фигурные скобки `{}`.
    *   Содержат неупорядоченный набор пар **"ключ: значение"**.
    *   Ключ — это всегда строка (в двойных кавычках `""`).
    *   Пары разделяются запятыми.

```json
{
  "userId": 1,
  "name": "Иван Петров",
  "isActive": true
}
```

2. Массивы (Arrays)

    *   Оборачиваются в квадратные скобки `[]`.
    *   Представляют собой упорядоченную коллекцию значений.
    *   Элементы массива разделяются запятыми.
    *   Массив может содержать значения разных типов.

```json
["яблоко", "банан", "апельсин"]
```

Типы данных для значений

Значения в парах "ключ-значение" или элементах массива могут принадлежать к одному из шести примитивных типов:

• Строка (String): Последовательность символов Unicode в двойных кавычках. Например: "Hello, World!", "тест".
• Число (Number): Целое или дробное число (в нотации с точкой). Например: 42, -7, 3.1415. Не поддерживает NaN и Infinity.
• Логическое значение (Boolean): Либо true, либо false.
• null: Специальное ключевое слово, обозначающее пустое или отсутствующее значение.
• Объект (Object): Вложенная структура (значение ключа само может быть объектом).
• Массив (Array): Вложенная упорядоченная коллекция (значение ключа может быть массивом).

Пример комплексной структуры JSON

Вот пример, демонстрирующий комбинацию всех элементов:

{
  "project": "Портал электронных услуг",
  "version": 2.1,
  "isStable": false,
  "tags": ["frontend", "backend", "api"],
  "maintainer": null,
  "settings": {
    "timeout": 30,
    "retryOnFail": true
  },
  "testSuites": [
    {
      "id": "TS-001",
      "name": "Авторизация",
      "cases": ["VALID_LOGIN", "INVALID_PASSWORD"]
    },
    {
      "id": "TS-002",
      "name": "Платежи",
      "cases": ["MIN_AMOUNT", "MAX_AMOUNT"]
    }
  ]
}

Разбор структуры:

• "project" — ключ со строковым значением.
• "version" — ключ с числовым значением.
• "isStable" — ключ с логическим значением.
• "tags" — ключ, значением которого является массив строк.
• "maintainer" — ключ со значением null.
• "settings" — ключ, значением которого является объект, содержащий свои пары ключ-значение.
• "testSuites" — ключ, значением которого является массив объектов. Каждый объект в этом массиве также содержит ключ "cases", значением которого является вложенный массив.

Важность понимания структуры JSON для QA-инженера

• Валидация ответов API: Подавляющее большинство современных REST API используют JSON как формат передачи данных. QA-инженер должен уметь анализировать ответы сервера, проверять корректность структуры (соответствие схеме или контракту), типы данных и наличие обязательных полей.
• Написание тестовых данных: Тестовые сценарии (например, для нагрузки или негативного тестирования) часто представляются в виде JSON-файлов.
• Понимание логов и отчетов: Многие системы логирования и отчетности (Allure Report, инструменты мониторинга) генерируют данные в JSON-формате.
• Работа с конфигурациями: Конфигурационные файлы многих инструментов автоматизации (например, cypress.json, playwright.config.js) используют JSON или его надмножества.
• Создание и анализ JSON Schema: Для строгой валидации структуры JSON используются JSON Schema — сами описываемые в JSON формальном языке. Понимание базовой структуры JSON необходимо для работы со схемами.

Таким образом, знание структуры JSON — это не просто теория, а практический навык, критически важный для эффективной работы QA-инженера с API, тестовыми данными и инфраструктурой автоматизации.