Zdarma převodník

YAML na Převaděč JSON

Rychlý a bezpečný převod YAML na JSON. Ideální pro konfigurační soubory a analýzu dat.

Nebo

O tomto nástroji

YAML a JSON jsou úzce příbuzné formáty — JSON je technicky striktní podmnožina YAML 1.2 — a převod mezi nimi je obvykle jednoduchý. YAML přidává funkce přátelské k lidem, které JSON postrádají: komentáře, víceřádkové řetězce bez escapování, odkazy na kotvy a aliasy, flexibilnější citace a strukturu založenou na odsazení, která se podobá přirozenému rozvržení dokumentu. Díky tomu je YAML oblíbenou volbou pro konfigurační soubory (manifesty Kubernetes, pracovní postupy GitHub Actions, Docker Compose), zatímco JSON dominuje užitečným zatížením API.

Převod YAML na JSON obvykle znamená vzdát se funkcí YAML, které jsou přívětivé pro člověka, výměnou za formát, který stroje snadněji analyzují a to je lingua franca HTTP API. Komentáře jsou vynechány (JSON žádné nemá). Odkazy na kotvy se rozloží na jejich referenční hodnoty. Víceřádkové řetězce se sbalí na standardní řetězce JSON s vloženými novými řádky.

Tento převodník analyzuje YAML pomocí js-yaml, nejrozšířenější knihovny YAML v JavaScriptu. Výstup je generován pomocí JSON.stringify s volitelným odsazením. Konverze zpracovává veškerou standardní syntaxi YAML 1.2 včetně stylu toku, stylu bloku, skalárů, sekvencí, mapování, kotev, aliasů a standardních typů značek.

Proč převést YAML na JSON

Většina rozhraní API a mnoho programovacích prostředí očekává JSON. Konfigurační soubory napsané v YAML je třeba při integraci s kódem nebo službami, které přijímají pouze JSON, převést na JSON. Nástroje pro JSON jsou také hojnější: jq, JSON Path, JSON Schema a široký ekosystém validátorů a transformátorů všechny přebírají vstup JSON.

JSON je také jednoznačný v tom, jak YAML není. Flexibilita YAML vytváří při analýze překvapení – řetězce jako 'ne' analyzují jako boolean false v YAML 1.1, řetězce verzí analyzují jako plovoucí, chyby odsazení vytvářející tiché strukturální změny. Převod do JSON zmrazí data do méně nejednoznačné podoby.

Jak používat

Vložte YAML a získejte JSON.

  1. Přidejte svůj YAML: Vložte text YAML do vstupní oblasti nebo přetáhněte soubor .yml/.yaml. js-yaml přijímá plnou syntaxi YAML 1.2.
  2. Převést: js-yaml analyzuje YAML do JavaScriptového objektu a JSON.stringify jej serializuje s dvoumístným odsazením. Komentáře jsou odstraněny, kotvy jsou vyřešeny a speciální typy YAML (časová razítka, binární data) jsou převedeny na reprezentace kompatibilní s JSON.
  3. Zkontrolujte výsledek: Ujistěte se, že struktura JSON odpovídá tomu, co jste očekávali. Porovnejte se zdrojovým YAML, abyste našli místa, kde volné psaní YAML vytvořilo neočekávané hodnoty JSON.
  4. Stáhnout nebo zkopírovat: Uložit jako .json nebo zkopírovat do schránky. Výstup je platný JSON, který lze použít libovolným analyzátorem JSON.

Běžné případy použití

Technické detaily

js-yaml implementuje YAML 1.2 s volitelnou podporou pro zvláštnosti YAML 1.1 (problém 'ne'-as-false, osmičková čísla bez předpony 0o). Analyzátor vytváří strom objektů JavaScript pomocí nativních typů: čísla, řetězce, booleovské hodnoty, null, pole a prosté objekty.

JSON.stringify serializuje strom objektů na JSON. Volitelné odsazení vytváří pěkně vytištěný výstup; bez něj je výsledkem kompaktní jednořádkový JSON. Speciální hodnoty (NaN, Infinity, undefined) nejsou platné JSON; převodník je vynutí, pokud jsou přítomny.

Okrajové případy: Časová razítka YAML se stanou řetězci ISO-8601 v JSON. Binární data YAML (zakódovaná v base64) se stanou řetězcem. Kotvy a aliasy jsou v JSON přeloženy do duplicitních hodnot, protože JSON nemá žádnou referenční syntaxi.

Nejlepší postupy

Často kladené dotazy

Změní převod YAML na JSON obsah?
Obsah je zachován co nejpřesněji. Některé funkce specifické pro formát však nemusí mít přímé ekvivalenty, takže mohou nastat drobné rozdíly ve formátování.
Proč převádět data do formátu JSON?
JSON je standardní datový formát pro webová rozhraní API a aplikace JavaScript. Je čitelný pro člověka, široce podporovaný programovacími jazyky a má jednodušší syntaxi než XML.
Zvládá převodník vnořené nebo složité struktury YAML?
Ano. Nástroj správně analyzuje vnořené objekty, pole a všechny standardní datové typy YAML, přičemž ve výstupu JSON zachová úplnou datovou strukturu.
Je tato konverze bezpečná a soukromá?
Ano. Veškeré zpracování probíhá lokálně ve vašem prohlížeči. Vaše data nikdy neopustí vaše zařízení – žádné nahrávání na server, žádné cloudové zpracování, žádný sběr dat.
Bude moje zpáteční cesta YAML čistá?
Strukturálně ano, pokud znovu pošlete JSON zpět do YAML. Komentáře a struktura kotvy jsou ztraceny; surové hodnoty jsou zachovány.
Jsou moje data nahrána na server?
Ne. js-yaml běží ve vašem prohlížeči.
Jaká je maximální velikost?
Až 50 MB. js-yaml zpracovává typické konfigurační soubory okamžitě; Analýza velmi velkého YAML může trvat znatelně dlouho.
Podporuje multi-dokument YAML?
YAML podporuje více dokumentů v jednom souboru oddělených ---. Převaděč standardně zpracovává první dokument; pro zpracování více dokumentů nejprve rozdělte YAML.