CSV используется как формат обмена табличными данными и поддерживается табличными редакторами, базами данных и инструментами анализа. Этот конвертер помогает быстро перевести табличный текст из CSV в JSON и обратно в CSV без сторонних библиотек и без отправки данных на сервер.
Основной сценарий страницы - CSV to JSON: CSV с заголовками превращается в массив объектов, а CSV без заголовков - в массив массивов. Обратный сценарий JSON to CSV поддерживается для массивов объектов и массивов массивов.
Какие данные можно конвертировать
- CSV с запятой, точкой с запятой, табуляцией или вертикальной чертой в роли разделителя.
- CSV с первой строкой заголовков, если нужен JSON-массив объектов.
- CSV без заголовков, если нужен JSON-массив массивов.
- JSON-массив объектов, когда ключи объектов должны стать колонками CSV.
- JSON-массив массивов, когда строки уже представлены как наборы ячеек.
Как формируется JSON из CSV
Если CSV содержит заголовки колонок, первая строка становится списком ключей, а остальные строки превращаются в объекты. Например, строки с колонками name и age дают массив объектов с этими ключами. Пустые ячейки остаются пустыми строками, а недостающие значения дополняются пустой строкой для соответствующей колонки.
Если заголовков нет, каждая строка CSV становится отдельным массивом. Такой формат удобен, когда исходная таблица не имеет стабильных названий колонок или когда нужно сохранить позиционную структуру данных.
Как формируется CSV из JSON
Для JSON-массива объектов конвертер собирает список колонок по ключам объектов и добавляет строку заголовков. Значения записываются в соответствующие колонки; если у отдельного объекта нет ключа, ячейка остается пустой.
Для JSON-массива массивов каждая вложенная строка становится строкой CSV. Заголовки в этом режиме не добавляются автоматически, потому что структура уже задана позициями элементов.
Разделители, кавычки и ошибки
В режиме CSV в JSON можно оставить автоопределение разделителя или выбрать запятую, точку с запятой, табуляцию либо вертикальную черту. В режиме JSON в CSV выбранный разделитель используется для итогового CSV; авто-режим дает обычную запятую.
Поля CSV в двойных кавычках разбираются как одно значение, даже если внутри есть разделитель или перенос строки. Двойная кавычка внутри значения должна быть экранирована второй двойной кавычкой. Если в CSV есть незакрытая кавычка или кавычка внутри неэкранированного поля, инструмент показывает ошибку вместо сомнительного результата.
Ограничения
- Значения из CSV попадают в JSON как строки; автоматическое определение чисел, дат и логических значений не выполняется.
- Для JSON в CSV поддерживаются только массив объектов или массив массивов.
- Вложенные объекты и массивы внутри ячеек CSV записываются как JSON-строка внутри поля.
- Смешанный JSON-массив, где одни элементы являются объектами, а другие массивами или примитивами, не подходит для CSV-вывода.
- Страница работает с текстом в поле ввода, а не с загрузкой файлов.
Примеры
CSV с заголовками name, age и city превращается в JSON-массив объектов с теми же ключами. Строка Alice, 30, Moscow становится объектом с полями name, age и city; строка Bob, 28, Berlin становится вторым объектом.
Для обратного направления JSON-массив объектов с ключами name и age превращается в CSV с первой строкой заголовков name, age, а следующие строки содержат значения Alice, 30 и Bob, 28.