So nutzen Sie den JSON-Formatter
- Fügen Sie Ihr JSON in das Eingabefeld ein oder tippen Sie es direkt ein.
- Wählen Sie eine Einrückung: 2 Leerzeichen, 4 Leerzeichen oder Tabs.
- Klicken Sie auf Formatieren, um es übersichtlich darzustellen, oder auf Minifizieren, um alle überflüssigen Leerzeichen und Umbrüche zu entfernen.
- Ist die Eingabe ungültig, zeigt der Validator die Fehlermeldung zusammen mit Zeile und Spalte der Stelle an, an der das Parsen fehlgeschlagen ist.
- Aktivieren Sie bei Bedarf Schlüssel sortieren, um die Schlüssel von Objekten alphabetisch zu ordnen, oder wandeln Sie das Ergebnis in YAML oder CSV um.
- Kopieren Sie die Ausgabe und fügen Sie sie dort ein, wo Sie sie brauchen.
Alles läuft in Ihrem Browser: Ihr JSON wird nie auf einen Server hochgeladen oder gespeichert. Sie können also bedenkenlos API-Antworten, Konfigurationsdateien und Logs formatieren, die private Daten enthalten.
Was ist JSON und warum formatiert man es?
JSON (JavaScript Object Notation) ist ein schlankes, textbasiertes Datenformat, das in RFC 8259 und ECMA-404 standardisiert ist. Es besteht aus nur sechs Arten von Werten: Objekten ({}), Arrays ([]), Strings, Zahlen, den booleschen Werten true und false sowie null. Diese Einfachheit ist der Grund, warum fast jede REST-API, viele Konfigurationsdateien und unzählige Log-Pipelines es verwenden.
Maschinen ist Leerraum egal, daher wird JSON, das über das Netzwerk geht, oft auf eine einzige Zeile minifiziert. Das ist effizient, für Menschen aber kaum lesbar. Beim Formatieren werden Zeilenumbrüche und eine einheitliche Einrückung ergänzt, sodass Sie die Verschachtelung auf einen Blick erkennen, ein fehlendes Feld bemerken und zwei Dokumente in einem Diff vergleichen können. Minifizieren bewirkt das Gegenteil und ist nützlich, wenn Sie JSON in eine Anfrage einbetten oder die Datenmenge verringern möchten.
Häufige JSON-Fehler und wie Sie sie beheben
JSON ist strenger als JavaScript-Objektliterale. Diese Fehler findet der Validator am häufigsten:
| Problem | Ungültig | Gültig |
|---|---|---|
| Abschließendes Komma | [1, 2, 3,] | [1, 2, 3] |
| Einfache Anführungszeichen | {'name': 'Ada'} | {"name": "Ada"} |
| Schlüssel ohne Anführungszeichen | {name: "Ada"} | {"name": "Ada"} |
| Kommentare | // note oder /* note */ | Entfernen oder ein Feld "_comment" verwenden |
| Werte, die es in JSON nicht gibt | undefined, NaN, Infinity | null oder ein String |
| Führende Nullen | {"id": 007} | {"id": 7} oder "007" |
Ein typischer fehlerhafter Ausschnitt, der aus JavaScript-Code kopiert wurde, sieht so aus:
{
name: 'Ada Lovelace',
born: 1815, // year
languages: ['English', 'French',],
}Im korrigierten JSON stehen alle Schlüssel und Strings in doppelten Anführungszeichen, der Kommentar fällt weg und beide abschließenden Kommas sind entfernt:
{
"name": "Ada Lovelace",
"born": 1815,
"languages": ["English", "French"]
}Weitere häufige Ursachen sind nicht maskierte doppelte Anführungszeichen oder echte Zeilenumbrüche innerhalb von Strings (verwenden Sie \" und \n) sowie ein verirrtes Zeichen nach der schließenden Klammer. Wirkt die gemeldete Position falsch, prüfen Sie die Zeile direkt darüber: Ein fehlendes Komma fällt meist erst auf, wenn der Parser den nächsten Wert erreicht.
Tipps und bewährte Vorgehensweisen
- Wählen Sie eine Einrückung und bleiben Sie dabei. Zwei Leerzeichen sind in JavaScript-Projekten die gängigste Konvention, vier Leerzeichen sind bei Python-Werkzeugen verbreitet. Einheitlichkeit ist wichtiger als die Wahl selbst.
- Sortieren Sie Schlüssel vor einem Diff. JSON-Objekte sind ungeordnet, daher können zwei gleichwertige Dokumente unterschiedlich aussehen. Sortierte Schlüssel machen Diffs in der Versionsverwaltung und Vergleiche deutlich übersichtlicher.
- Vorsicht bei sehr großen Zahlen. JavaScript speichert Zahlen als 64-Bit-Gleitkommawerte, daher können ganze Zahlen über 9.007.199.254.740.991 (253 − 1) beim Parsen im Browser an Genauigkeit verlieren. Senden Sie große IDs als Strings.
- Verwenden Sie UTF-8. RFC 8259 schreibt UTF-8 für JSON vor, das zwischen Systemen ausgetauscht wird.
- Wandeln Sie um, wenn es hilft. CSV eignet sich für ein flaches Array von Objekten, das Sie in einer Tabellenkalkulation öffnen möchten; YAML lässt sich leichter von Hand bearbeiten. Für die Umwandlung in beide Richtungen probieren Sie den Konverter JSON ↔ YAML oder den Konverter CSV ↔ JSON.
Häufig gestellte Fragen
Erlaubt JSON Kommentare?
Nein. Weder RFC 8259 noch ECMA-404 lassen Kommentare zu. Manche Tools akzeptieren erweiterte Formate wie JSONC oder JSON5, aber ein Standard-Parser lehnt sie ab. Entfernen Sie Kommentare vor der Validierung oder verschieben Sie Notizen in ein normales Feld.
Warum ist mein JSON ungültig, obwohl es in JavaScript funktioniert?
JavaScript-Objektliterale erlauben einfache Anführungszeichen, Schlüssel ohne Anführungszeichen, abschließende Kommas, Kommentare und Werte wie undefined. JSON erlaubt nichts davon. Erzeugen Sie gültiges JSON im Code mit JSON.stringify(), statt es von Hand zu schreiben.
Verändert das Formatieren meine Daten?
Formatieren und Minifizieren ändern nur den Leerraum zwischen den Tokens; Schlüssel, Werte und die Reihenfolge in Arrays bleiben gleich. Beim Sortieren der Schlüssel werden die Einträge von Objekten neu angeordnet, was die Bedeutung nicht ändert, weil JSON-Objekte ungeordnet sind.
Was ist der Unterschied zwischen Formatieren und Validieren?
Beim Validieren wird geprüft, ob der Text syntaktisch korrektes JSON ist. Beim Formatieren wird gültiges JSON mit gut lesbarer Einrückung neu ausgegeben. Der Formatter validiert zuerst; ein Dokument, das sich nicht parsen lässt, können Sie also nicht formatieren.
Kann ich verschachteltes JSON in CSV umwandeln?
CSV ist eine flache Tabelle und funktioniert daher am besten mit einem Array von Objekten, die dieselben Schlüssel haben. Verschachtelte Objekte und Arrays haben keine direkte Entsprechung in CSV und werden in der Regel abgeflacht oder in eine einzelne Zelle serialisiert.
Aktualisiert