YAML in JSON umwandeln: Regeln, Fehlerquellen, Prüfung

VeröffentlichtToolYAML-zu-JSON-Konverter

Inhalt
  1. Warum YAML-Konfigurationen im Code nicht funktionieren
  2. So gehen Sie vor: Umwandlungsregeln und Überprüfung
  3. Typische Stolperstellen
  4. Fazit
  5. Häufig gestellte Fragen

Konfigurationsdateien werden häufig in YAML geschrieben. Die Struktur ergibt sich allein aus der Einrückung, und Kommentare sind frei möglich – für Menschen ist YAML deshalb deutlich angenehmer zu lesen und zu bearbeiten. Doch sobald Sie die Werte in JavaScript-Code verwenden oder direkt in einen API-Request-Body einfügen wollen, merken Sie: YAML lässt sich dort nicht einfach so verwenden.

Zusammenfassung ① YAML lässt sich für Menschen gut lesen und schreiben, aber JavaScript-Objekte und API-Request-Bodys erwarten das JSON-Format ② Wenn Sie die Regeln kennen, mit denen sich eine einrückungsbasierte Struktur in eine Struktur mit geschweiften und eckigen Klammern überträgt, können Sie auch von Hand umwandeln ③ Bei tief verschachteltem YAML oder gemischten Listen passieren bei der manuellen Umwandlung oft Fehler, daher sollten Sie das Ergebnis immer visuell prüfen

Warum YAML-Konfigurationen im Code nicht funktionieren

YAML bildet Hierarchien über Einrückungen ab und schreibt den Wert hinter einen Doppelpunkt – das ist für Menschen gut lesbar. Auch Kommentare (#) sind jederzeit möglich, weshalb YAML als Format für Konfigurationsdateien weit verbreitet ist.

Das Problem: Stellen wie JSON.parse in JavaScript oder der Body einer fetch-Anfrage verstehen die YAML-Syntax nicht. Diese Funktionen interpretieren ausschließlich JSON-Syntax, also geschweifte Klammern, eckige Klammern und in doppelte Anführungszeichen gesetzte Schlüssel.

Wenn Sie also Werte aus einer Konfigurationsdatei unverändert in eine Test-Anfrage an eine API einfügen oder als Konstante in Frontend-Code übernehmen wollen, kommt es zu einem Syntaxfehler. Das YAML selbst ist syntaktisch einwandfrei, an einer Stelle, die JSON erwartet, führt es trotzdem zu einem Fehler.

So gehen Sie vor: Umwandlungsregeln und Überprüfung

Für die manuelle Umwandlung gelten drei Regeln. Erstens: key: value wird in doppelte Anführungszeichen gesetzt. Zweitens: Untergeordnete Einträge, die per Einrückung dargestellt sind, werden in geschweifte Klammern gefasst. Drittens: Listeneinträge mit vorangestelltem Strich werden zu einem Array in eckigen Klammern.

YAML-SchreibweiseJSON-Schreibweise
host: localhostSchlüssel und Wert in doppelten Anführungszeichen
Untergeordnete Einträge per EinrückungIn geschweifte Klammern fassen
Listeneintrag am ZeilenanfangIn ein Array mit eckigen Klammern umwandeln
true, false, null, ZahlenUnverändert und ohne Anführungszeichen belassen

Die Regeln sind einfach, doch sobald die Hierarchie mehr als zwei, drei Ebenen umfasst, ist es mühsam, die Klammerpaare von Hand korrekt zu setzen. Enthält eine Liste wiederum Objekte, überlagern sich die Klammern, und Fehler passieren noch leichter.

Mit unserem Tool prüfen. Fügen Sie Ihr YAML in das Eingabefeld ein, und unten erscheint sofort das JSON-Ergebnis. Als Einrückung können Sie 2 Leerzeichen, 4 Leerzeichen oder eine einzelne Zeile (komprimiert) wählen und das Ergebnis direkt kopieren und in Ihren Code einfügen.

YAML-zu-JSON-Konverter

Kostenlos · ohne Anmeldung · JSON-Umwandlung direkt im Browser

Typische Stolperstellen

SituationWarum es hakt
Struktur mit Objekten innerhalb einer ListeGeschweifte Klammern innerhalb eckiger Klammern überlagern sich, die Paare sind von Hand schwer zuzuordnen
Doppelpunkt oder Anführungszeichen in ZeichenkettenOhne Escaping kommt es zu einem Syntaxfehler
Einrückung mit gemischten Tabs und LeerzeichenDie Hierarchie wird anders interpretiert, und es entsteht eine falsche Struktur
Komma nach dem letzten EintragJSON erlaubt kein Komma nach dem letzten Eintrag

Die in der Tabelle genannten Fälle fallen beim bloßen Überfliegen kaum auf; erst wenn tatsächlich geparst wird, zeigt sich die Fehlerstelle. Nach der Umwandlung sollten Sie sich daher angewöhnen, einmal zu prüfen, ob die Struktur mit dem Original übereinstimmt.

Fazit

YAML ist ein Format, das sich für Menschen gut lesen und bearbeiten lässt, JSON dagegen das Format, das Code und APIs verstehen. Wenn Sie Doppelpunkte durch Anführungszeichen, Einrückungen durch geschweifte Klammern und Listen durch eckige Klammern ersetzen, können Sie auch von Hand umwandeln.

Wird die Hierarchie jedoch tiefer oder mischen sich Listen und Objekte, passieren beim Setzen der Klammerpaare leicht Fehler. Dann geht es schneller, ein Tool zu verwenden, mit dem Sie das Ergebnis der Umwandlung direkt prüfen können.

YAML-zu-JSON-Konverter

Kostenlos · ohne Anmeldung · JSON-Umwandlung direkt im Browser

Häufig gestellte Fragen

Lässt sich die gesamte YAML-Syntax in JSON umwandeln?

Strukturen, die in Konfigurationsdateien üblich sind – Schlüssel-Wert-Paare, verschachtelte Maps und Listen –, lassen sich unverändert in JSON übertragen. Für YAML-spezifische Syntax wie Anker und Aliase gibt es in JSON jedoch kein Gegenstück, daher müssen Sie die Werte zuerst auflösen und erst dann umwandeln.

Kann ich das umgewandelte JSON direkt als API-Request-Body verwenden?

Wenn daraus eine Standard-JSON-Struktur geworden ist, können Sie es direkt als Body einer fetch- oder axios-Anfrage einsetzen. Ob die von der API erwarteten Feldnamen und Werttypen mit den Schlüsseln im ursprünglichen YAML übereinstimmen, müssen Sie allerdings separat prüfen.

Soll ich als Einrückung 2 oder 4 Leerzeichen wählen?

Die geparsten Daten selbst sind unabhängig von der Einrücktiefe identisch. Wenn Sie das Ergebnis in eine Codebasis einfügen, an der mehrere Personen arbeiten, passen Sie die Einrückung an die des Projekts an. Bei Stellen, an denen Leerraum keine Rolle spielt, etwa im API-Request-Body, ist die einzeilige (komprimierte) Option praktischer.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. YAML-Einrückungsfehler: Warum die CI-Pipeline fehlschlägtWarum ein einziges Leerzeichen in GitHub Actions oder GitLab CI den Deploy scheitern lässt und wie Sie die falsch eingerückte Zeile sofort finden.
  2. YouTube automatische Untertitel: Fehler, SRT oder VTT wählenWarum automatisch erzeugte YouTube-Untertitel bei Namen und Fachbegriffen danebenliegen, wie sie sich von manuellen unterscheiden und wann SRT, VTT oder TXT passt.
  3. Zeilennummern hinzufügen: 5 Formate und führende NullenSo nummerieren Sie Zeilen in Text oder Code automatisch, etwa als 1., [1] oder 01., lassen Leerzeilen aus und verstehen, wie die Stellenzahl berechnet wird.
  4. Anagramm prüfen: Anleitung und Algorithmus im ÜberblickAnagramme erkennen in vier Schritten: Zeichen bereinigen, sortieren, vergleichen. Dazu ein schneller Algorithmus mit Hashmap.
  5. Schimpfwortfilter: Text zensieren ohne FehltrefferTeilwort- oder Ganzwort-Treffer, längste Wörter zuerst und das Scunthorpe-Problem: So maskieren Sie Schimpfwörter automatisch, ohne harmlose Wörter zu zensieren.
  6. Base32-Kodierung erklärt: Prinzip, Padding und OTP-SchlüsselSo funktioniert Base32 nach RFC 4648: 5-Bit-Umwandlung, warum 0, 1, 8 und 9 fehlen, Padding mit „=“ berechnen und OTP-Geheimschlüssel für 2FA dekodieren.

Passende Tools