Что делает инструмент
Kогда из API возвращается JSON, а вам нужно открыть результат в Excel или импортировать в 1С / Google Sheets — нужна конвертация в CSV. Этот инструмент берёт JSON-массив объектов, превращает ключи в заголовки колонок, значения — в строки CSV. Через PapaParse, в браузере, без отправки на сервер.
Когда нужно
- Экспорт из API в Excel. Получили JSON через REST → нужно отчитаться в Excel.
- 1С импорт. Принимает CSV (часто с разделителем ;).
- Импорт в Google Sheets. File → Import → CSV.
- Подготовка датасета. JSON-данные → CSV → загрузка в Pandas / R / Power BI.
- Маркетплейсы. Wildberries требует CSV с определённым форматом для импорта товаров.
- Бухгалтерия. Выгрузка платежей из API банка → CSV → 1С.
Особенности и ограничения
- Только массив объектов. JSON должен быть
[{...}, {...}]. Если у вас один объект — оберните в массив:[obj]. - Вложенные объекты — flatten. CSV — плоская структура. Вложенные объекты сериализуются как «[object Object]». Перед конвертацией flatten вручную или через JS-библиотеку.
- Массивы внутри значений.
{tags: ["a","b"]}станет"a,b"или простоa,b(зависит от quoting). Для сохранения структуры — отдельные колонки tag1, tag2 или JSON-строка. - Кодировка. Файл скачивается в UTF-8 без BOM. Если Excel в русской локали показывает кракозябры, конвертируйте в Windows-1251 через инструменты типа iconv (в командной строке) или используйте LibreOffice.
- Точка/запятая в числах. JSON:
3.14. В CSV для Excel в русской локали может потребоваться3,14. Замена через regex после генерации CSV:output.replace(/(\d)\.(\d)/g, '$1,$2').
- PapaParse — Powerful CSV parser/unparser. Matt Holt. github.com/mholt/PapaParse. 2024.
- RFC 4180 — CSV format specification. IETF. rfc-editor.org/rfc/rfc4180. 2005.
