JSON ukládá pojmenované hodnoty a seznamy. Vložte ho do vstupního pole a zvolte, co s ním chcete udělat. Režim „Formátovat“ přidá přehledné odsazení. Ostatní režimy slouží k prohlížení, úpravám nebo převodu dat. Výstup je oddělený od vstupu. Vstup se změní, až když výslovně použijete opravu nebo upravíte hodnotu v režimu „Strom“.
Naformátování JSON
Zvolte „Formátovat“.
Do pole „Vstupní JSON“ vložte následující ukázku.
Naformátovaný výsledek se zobrazí vedle vstupu, na menší obrazovce pod ním.
Zvolte odsazení a výstup zkopírujte nebo stáhněte.
{"name":"Alex","items":["Tea","Coffee"],"active":true}
Volba „Automatické formátování“ je ve výchozím stavu zapnutá, takže výsledek se mění při psaní. Pokud ji vypnete, po úpravě stiskněte hlavní tlačítko pro zpracování. Na telefonu najdete nastavení pod „Nastavení formátování“ a další akce pod „Další“.
Akce „Načíst soubor“ přijímá textové soubory JSON, TXT nebo JS. V běžných režimech musí být jejich obsah platný JSON. Tlačítko „Ukázka“ otevře nabídku ukázek. Akce „Načíst soubor“ a „Ukázka“ si před nahrazením stávajícího obsahu vyžádají potvrzení. „Vložit“ vstup nahradí rovnou.
Odsazení a úpravy dat
| Volba | Co dělá |
|---|---|
| Odsazení | V režimech s odsazením můžete zvolit dvě mezery, čtyři mezery, tabulátor nebo „Bez odsazení“. |
| Seřadit klíče | Seřadí klíče objektů abecedně, včetně vnořených objektů. |
| Zachovat pořadí | Ponechá řazení vypnuté. Nelze ji zapnout současně s volbou „Seřadit klíče“. |
| Odstranit null | Z naformátovaného výstupu odstraní vlastnosti a prvky polí s hodnotou null, i ve vnořených datech. |
| Únikové sekvence Unicode | V naformátovaném JSON zapíše znaky mimo ASCII jako escape sekvence. |
| Společné posouvání | Při posouvání jednoho editoru posouvá i druhý. |
V některých režimech nejsou všechny volby dostupné. Pro uvedené úpravy použijte „Formátovat“ nebo „Opravit“. Režim „Bez odsazení“ odstraní odsazení, zatímco převody do jiných formátů mají vlastní pravidla výstupu.
Volba „Odstranit null“ mění data, včetně pozic prvků v polích. Řazení a zpracování JSON mohou změnit také pořadí klíčů. U opakovaných klíčů se zachová poslední hodnota a velmi velká čísla mohou ztratit přesnost. Pokud záleží na každé číslici dlouhého identifikátoru, zapište ho už ve zdroji jako řetězec v uvozovkách.
Oprava chybné syntaxe
Běžné režimy neplatný JSON ohlásí, samy ho neopravují. Opravu spustíte přepnutím do režimu „Opravit“ nebo tlačítkem „Opravit“ vedle chyby.
Režim „Opravit“ si poradí s běžnými problémy, jako jsou jednoduché uvozovky, čárka za poslední položkou, komentáře nebo klíče bez uvozovek. Než zvolíte „Použít jako vstup“, výsledek zkontrolujte. Platný JSON ještě neznamená, že oprava zachovala autorův záměr.
Pokud se oprava nepodaří, podle chybové zprávy zkontrolujte zdroj. Chybějící hodnotu opravte podle skutečných dat, ne odhadem.
Prohlížení a úpravy stromu
Režim „Strom“ zobrazí vnořené objekty a seznamy jako rozbalovací řádky. Jednotlivé větve otevřete šipkami. Tlačítka „Rozbalit vše“ a „Sbalit vše“ ovládají celý strom.
V hlavním stromu můžete kliknutím upravit hodnotu nebo klíč objektu. Enter nebo kliknutí mimo pole změnu uloží, Escape ji zruší. Klíč nelze přejmenovat na název, který už ve stejném objektu existuje.
Upravená hodnota, například 42, true, false nebo null, získá odpovídající typ JSON. Jiný text se uloží jako řetězec. Pokud upravujete identifikátor, který vypadá jako číslo, zkontrolujte výsledný typ.
Úprava ve stromu změní i vstupní JSON. Strom na celé obrazovce slouží pouze k prohlížení. Jeho tlačítko „Kopírovat“ kopíruje zobrazený text stromu. Pokud potřebujete soubor JSON, použijte běžný výstup JSON.
Porovnání dvou dokumentů
Zvolte „Porovnat“ a do každého panelu vložte jeden dokument JSON. Nástroj porovná jejich řádky a shrne přidané, odstraněné a změněné hodnoty. Oba vstupy musí být platný JSON.
Mezi zvýrazněnými rozdíly se pohybujte tlačítky pro předchozí a další změnu. Odsazení obou dokumentů může porovnání zpřehlednit. Pole se porovnávají podle pozic, takže přesunutí jednoho prvku se může zobrazit jako několik změn.
Režim „Porovnat“ má dva vlastní vstupy a samostatné celoobrazovkové zobrazení. Akce „Načíst soubor“, „Vložit“, „Ukázka“ a „Vymazat“ se vztahují k panelu, u kterého je použijete.
Vyhledání hodnoty pomocí JSONPath
JSONPath je stručná cesta k hodnotě uvnitř JSON. Zvolte JSONPath, napište dotaz a stiskněte „Spustit“. Dotaz začíná znakem $, který označuje celý dokument.
{"items":[{"name":"Tea","price":12},{"name":"Coffee","price":25}]}
| Dotaz | Výsledek v této ukázce |
|---|---|
| $.items[0].name | Tea. Index 0 označuje první prvek. |
| $.items[*].name | Názvy obou položek. |
| $..price | Všechny hodnoty s klíčem price pod kořenem dokumentu. |
| $.items[?(@.price > 20)].name | Coffee. |
| $.missing | Prázdný výsledek: []. |
Zdejší implementace podporuje klíče, indexy, zástupné znaky, rekurzivní vyhledávání, řezy polí směrem dopředu, výběr několika indexů a jednoduché porovnávací filtry. Nepodporuje všechny výrazy, které mohou umět jiné implementace JSONPath. Při jedné shodě vrátí samotnou hodnotu, při více shodách seznam a bez shody [].
Převod do CSV, XML nebo YAML
Zvolte „Převést“ a vyberte výstupní formát. Tlačítko „Kopírovat“ vloží výstup do schránky. Akce „Stáhnout“ připraví soubor s odpovídající příponou.
| Formát | Jak se změní struktura |
|---|---|
| CSV | U seznamu objektů se názvy sloupců převezmou z prvního objektu. Vlastnosti, které se objeví až v dalších objektech, se vynechají. Vnořené objekty a pole zůstanou v buňkách jako text JSON. |
| XML | Přidá kořenový element, z klíčů objektů vytvoří názvy elementů a pro prvky polí elementy opakuje. Nepodporované znaky v názvech nahradí. |
| YAML | Zapíše načtená data JSON ve formátu YAML. |
Jeden objekt se v CSV převede na sloupce key a value. Tyto převody jsou jednosměrným výstupem ze vstupního JSON. CSV, XML ani YAML nelze v tomto nástroji načíst zpět do JSON.
Akce „Stáhnout“ použije zvolený výstupní formát v hlavním i celoobrazovkovém zobrazení.
Změna názvů klíčů
Režim „Upravit klíče“ nabízí volbu „Původní“ a styly camelCase, snake_case, kebab-case a UPPER_CASE. Mění klíče objektů i ve vnořených datech. Běžné textové hodnoty ponechá beze změny.
Dva různé klíče mohou po přejmenování získat stejný název. Například first_name a first-name se mohou oba změnit na firstName. Nástroj na kolizi upozorní, ale ve výstupu zůstane jen jedna z původních hodnot. Před uložením zkontrolujte upozornění i zdroj.
Kontrola schématu a generování typů
Režim „Ověřit“ ověří, zda je vstup platný JSON. Do druhého panelu přidejte schéma JSON, pokud chcete kontrolovat i typy hodnot, povinné vlastnosti nebo povolené hodnoty. Chyby ukazují na příslušné místo v datech.
Akce „Vygenerovat z JSON“ vyplní druhý panel výchozím schématem draft-07 odvozeným z aktuální ukázky. Než ho použijete jako specifikaci, projděte ho. Jedna ukázka nemůže popsat všechny hodnoty, které vaše aplikace dovoluje.
Režim TypeScript vygeneruje ze vstupu rozhraní, počínaje RootObject. Výsledek zkopírujte nebo stáhněte jako soubor TS. Odvozené typy popisují dodanou ukázku. Pro volitelné vlastnosti nebo hodnoty, které v ní nejsou, je může být potřeba upravit.
Ovládání klávesnicí
| Akce | Klávesy |
|---|---|
| Vložit tabulátor do vstupu JSON nebo editoru porovnáníV těchto editorech klávesa Tab vloží tabulátor místo přesunu na další ovládací prvek. | Tab |
| Potvrdit úpravu v hlavním stromuNejprve klikněte na klíč nebo hodnotu. | Enter |
| Zrušit úpravu ve stromu | Escape |
| Zavřít nabídku ukázek nebo celoobrazovkové zobrazeníOtevřená nabídka ukázek se zavře dřív než zobrazení pod ní. | Escape |
| Vybrat celý text v aktivním editoru |
MacCommand + A
Windows / LinuxCtrl + A
|
| Vložit text do aktivního editoru |
MacCommand + V
Windows / LinuxCtrl + V
|
Kontrola a uchování výsledku
Neplatný vstup vymaže běžný výstup a zobrazí chybu. Řetězce a názvy vlastností v JSON patří do dvojitých uvozovek. Za poslední položkou nesmí být čárka. Režim „Opravit“ pomůže se syntaxí, ale neověří správnost samotných dat.
Akce „Vymazat“ si před smazáním vyplněného vstupu vyžádá potvrzení. Po obnovení stránky se JSON ani výstup neobnoví. Nejdřív je proto zkopírujte nebo stáhněte. Zvolený režim a statistiky používání mohou v tomto zařízení zůstat uložené.
Zpracování probíhá v prohlížeči. Nástroj nestahuje data z adresy API vložené jako text. Pokud chcete zpracovat odpověď API, zkopírujte její obsah nebo načtěte uložený soubor JSON.