Уплощение JSON

Что делает уплощение JSON?

Уплощение JSON преобразует вложенные объекты и массивы в плоскую структуру, где каждый конечный лист становится отдельной записью. Например, для объекта {"user":{"name":"Ada"},"rows":[3,5]} с разделителем точка получаются пути user.name, rows.0 и rows.1.

Параметры и ограничения

Максимальная глубина вложенности — 200 уровней, максимальное количество листьев — 100000. Вставляемый текст ограничен 16 МиБ, файл обрабатывается в памяти браузера с общими лимитами 64 МиБ на один файл и 128 МиБ суммарно. Невалидный JSON отклоняется.

Особенности вывода

Пустые объекты и массивы не создают строк. Примитивные значения, включая null, сохраняются. Если исходный ключ уже содержит выбранный разделитель, возможна коллизия с вложенным путём; более поздний лист перезаписывает более ранний с тем же путём.

Формат CSV

CSV всегда использует заголовок path,value, запятую в качестве разделителя и экранирование полей двойными кавычками. Разделитель не меняется в зависимости от локали.

Часто задаваемые вопросы

Что произойдёт, если ключ содержит точку?

Если исходный ключ уже содержит выбранный разделитель (например, точка), он может конфликтовать с вложенным путём. В этом случае более поздний лист с тем же путём перезапишет более ранний.

Как обрабатываются массивы?

Позиции массива становятся числовыми компонентами пути, например rows.0 для первого элемента.

Можно ли изменить разделитель в CSV?

Нет, CSV всегда использует запятую в качестве разделителя и не переключается на другие разделители для локали.

Проверочный список

• Проверьте, что JSON корректен.
• Убедитесь, что глубина вложенности не превышает 200.
• Проверьте, что количество листьев не превышает 100000.
• Помните, что пустые объекты и массивы не создают строк.
• Учитывайте возможные коллизии ключей с разделителем.