JSON Editor — Tipps & Tricks

Zurück zur Übersicht: JSON Editor · Tool live öffnen: www.jpkc.com/tools/json/

Das Manual erklärt jede Funktion, die Beispiele zeigen die Arbeitsabläufe. Hier geht es um das, was beides voraussetzt, aber selten dabeisteht: welche Ansicht zu welcher Aufgabe passt, was die Syntax-Prüfung nicht leistet, warum große Zahlen hier sicher sind und wo du auf einem geteilten Rechner aufpassen solltest. Die Oberfläche ist auf Englisch — die echten Button-Namen stehen deshalb im Original, bei Bedarf mit deutscher Erläuterung.

Die richtige Ansicht zur Aufgabe

Die drei Ansichten zeigen dasselbe Dokument, sind aber für unterschiedliche Aufgaben gemacht. Wer ständig die passende wählt, arbeitet deutlich schneller:

Tree für Struktur verstehen und umbauen — auf- und zuklappen, per Drag-and-drop umsortieren, einzelne Werte gezielt bearbeiten. Auch der Einstieg ins Transform-Werkzeug.
Table für gleichförmige Listen — ein Array von Objekten liest und bearbeitet sich als Tabelle viel schneller als im Baum. Spalten sortieren per Klick, Zeilen hinzufügen/entfernen.
Text für Rohsicht und Reparatur — wenn du den exakten Aufbau kontrollieren, kaputtes JSON von Hand korrigieren oder Suchen & Ersetzen brauchst. Format, Compact und Repair schalten ohnehin hierher.

Faustregel: Listen → Table, kaputtes oder rohes JSON → Text, alles andere → Tree.

Validieren heißt nicht Schema-prüfen

Die häufigste Fehlannahme: „Der Editor sagt, das JSON ist gültig — also stimmen meine Daten." Stimmt nur halb. Die Echtzeit-Validierung prüft die Syntax — ob das JSON wohlgeformt ist (richtige Klammern, Anführungszeichen, Kommas). Sie prüft nicht, ob deine Daten einem Schema oder Vertrag entsprechen: ob ein erwartetes Feld fehlt, ein String steht, wo eine Zahl hingehört, oder ein Wert außerhalb des erlaubten Bereichs liegt. Ein grünes „gültig" heißt: „lesbar als JSON" — nicht „inhaltlich korrekt".

Für die inhaltliche Prüfung hat der Editor den Button Schema: Du hinterlegst ein JSON Schema (Draft 4, 7, 2019-09 oder 2020-12), und der Editor markiert jede Abweichung als Warnung — dauerhaft, bis du Remove schema klickst. Das lohnt sich vor allem, wenn du dieselbe Art Dokument immer wieder bearbeitest, etwa eine Konfiguration oder die Antwort einer bestimmten API: Das Schema bleibt im Browser gespeichert und prüft beim nächsten Besuch automatisch mit. Achte darauf, dass das Schema in sich vollständig ist — externe $ref-Verweise lädt das Tool nicht nach. Wie das konkret aussieht, zeigt Beispiel 7.

Reparatur: was geht, was nicht

Der Button Repair (oder Auto repair in der Text-Ansicht) ist stark bei den häufigen, eindeutigen Fehlern — abschließende Kommas, einfache statt doppelter Anführungszeichen, nicht gequotete Schlüssel, Kommentare, fehlende schließende Klammern am Ende. Dazu kommen zwei Fälle, die beim Kopieren aus fremden Quellen oft übersehen werden: JSONP-Antworten (callback({...})) und Python-Ausgaben mit True, False und None statt true, false und null. Genau die Fälle, die beim Kopieren aus Code, Logs oder lockeren Config-Formaten entstehen.

Wo die Reparatur an Grenzen stößt: mehrdeutige oder strukturell zerstörte Eingaben. Wenn unklar ist, wo eine Klammer mitten im Dokument hingehört, kann auch die Heuristik nicht raten. Und doppelte Schlüssel lässt Repair bewusst stehen — welcher der beiden Werte der richtige ist, entscheidest du. Die Reihenfolge ist deshalb: Repair klicken, was übrig bleibt anhand der Meldung von Hand korrigieren, zum Schluss Format für eine saubere Einrückung. Gefällt dir das Ergebnis nicht, holt Ctrl+Z den Ausgangszustand zurück. Bei wirklich kaputten Quellen lohnt es sich, das Original noch einmal sauber zu beschaffen, statt lange zu flicken.

Compact + Sort: reproduzierbare Ausgabe

Zwei Buttons ergeben zusammen einen nützlichen Trick: Willst du zwei JSON-Dokumente vergleichen (z. B. in einem Diff), stören unterschiedliche Schlüssel-Reihenfolgen und Einrückungen. Drück auf beiden erst Sort keys (sortiert alle Schlüssel rekursiv) und dann Compact (oder Format für zeilenweises Diff) — dann unterscheiden sich die Dateien nur noch dort, wo sich inhaltlich etwas geändert hat. Beachte zweierlei: Sort keys sortiert nur Objekt-Schlüssel, nicht die Reihenfolge von Array-Elementen. Und es sortiert „natürlich" und ohne Rücksicht auf Groß- und Kleinschreibung (key2 vor key10) — andere Werkzeuge sortieren oft streng nach Zeichencode. Sortier für einen Vergleich deshalb beide Dokumente mit demselben Werkzeug.

Brauchst du die kompakte Fassung nur zum Weitergeben, musst du dein lesbares Dokument dafür nicht umbauen: File → Copy compact bzw. Download compact (.min.json) liefern die minifizierte Fassung, während der Editor formatiert bleibt.

Große Zahlen und doppelte Schlüssel

Ein Werkzeug, das mit dem eingebauten JSON-Parser des Browsers arbeitet, verändert Daten unter Umständen, ohne es zu sagen: Dieser Parser kennt nur 64-Bit-Gleitkommazahlen. Aus der Bestellnummer 12345678901234567890 wird dann 12345678901234567000, aus 1.10 wird 1.1. Bei 64-Bit-IDs aus Datenbanken oder Beträgen mit festen Nachkommastellen ist das ein echter Datenverlust. Der JSON Editor parst mit lossless-json und lässt jede Ziffer stehen — auch nach Format, Compact, Sort keys und Download. Probier es am Beispiel-Dokument aus: Die orderId 9007199254740993 liegt knapp über der Grenze, ab der Gleitkommazahlen nicht mehr jede Ganzzahl darstellen können, und bleibt trotzdem exakt.

Ähnlich bei doppelten Schlüsseln: Ein normaler Parser behält still den letzten Wert. Der Editor nennt den Schlüssel und lässt das Dokument als Text stehen. Siehst du die Meldung „Duplicate key …", such die Stelle mit Ctrl+F und entscheide selbst, welcher Wert bleibt.

Local Storage: Komfort und Stolperfalle

Der Editor speichert deinen Stand automatisch im Browser und stellt ihn beim nächsten Besuch wieder her — sehr bequem gegen versehentliche Reloads. Ein paar Dinge solltest du wissen:

Geteilter oder fremder Rechner: Der Inhalt bleibt im Browser liegen, bis du ihn mit File → Clear leerst. Ein hinterlegtes JSON Schema bleibt davon unberührt — das entfernt erst Remove schema im Schema-Dialog. Nach der Arbeit mit sensiblen Daten an einem nicht-eigenen Gerät also beides nicht vergessen.
Kein Sync, kein Backup: Der Stand liegt nur im Local Storage dieses Browsers. Er wandert nicht zwischen Geräten und ist weg, wenn du die Browser-Daten löschst. Was du behalten willst, sicher per Download als Datei.
Große Dokumente werden nicht gespeichert: Über 2 Millionen Zeichen zeigt das Badge Not saved — too large, und eine ältere Kopie wird gelöscht. Hier ist der Download Pflicht, bevor du den Tab schließt.

Beruhigend dabei: Dein Dokument verlässt den Browser nie — gespeichert wird nur lokal, ein Upload findet nicht statt. Einzige Funktion mit Server-Beteiligung ist Load from URL: Dabei schickst du nur die Adresse an den Proxy der Website, der das JSON von dort abholt.

File → Load from URL… spart den Umweg über Download und Öffnen, hat aber klare Grenzen: nur öffentlich erreichbare http/https-Adressen, höchstens 2 MB, keine eigenen Header und keine Zugangsdaten. Interne Adressen (localhost, Intranet, private IP-Bereiche) lehnt der Proxy ab. Für eine API mit Token oder für einen Server im eigenen Netz lädst du die Antwort deshalb mit curl oder im Browser herunter und öffnest die Datei per Drag-and-drop. Für öffentliche Endpunkte, Feeds und Beispieldaten ist der URL-Import dagegen der schnellste Weg.

Tastatur und große Dokumente

Bleib auf der Tastatur: Ctrl+O öffnet eine Datei, Ctrl+S lädt das Dokument herunter — beides auch, wenn der Cursor im Editor steht. Suchen (Ctrl+F), Ersetzen, Undo/Redo und in der Text-Ansicht Formatieren (Ctrl+I) gehen ebenfalls per Tastenkürzel. Auf dem Mac jeweils mit Cmd.
Vollbild für große Dateien: Der Vollbild-Button gibt dem Editor den ganzen Bildschirm; Esc beendet ihn wieder. Ist ein Dialog, ein Menü oder die Suche offen oder bearbeitest du gerade einen Wert, beendet Esc den Vollbildmodus nicht — so verlierst du ihn nicht versehentlich, wenn du eigentlich nur etwas abbrechen willst.
Sehr große Dateien sind möglich, aber speicherhungrig: Die echte Obergrenze setzt der Arbeitsspeicher deines Browsers. Wird es bei riesigen Dateien zäh, hilft die Text-Ansicht (leichter als Tree/Table) und das Schließen anderer Tabs. Einen schnellen Überblick über Umfang und Verschachtelungstiefe gibt dir die Statistik in der Fußzeile.

Mit anderen JPKCom-Tools kombinieren

Der JSON Editor ist oft nur eine Station — diese Tools schließen sich nahtlos an:

Falsches Format? Der Convertor PRO wandelt JSON in YAML, TOML, XML und zurück. Workflow: im JSON Editor aufräumen und validieren, dann im Convertor ins Zielformat überführen.
Eigentlich eine Tabelle? Wenn dein Array von Objekten als CSV besser aufgehoben ist, übernimmt der CSV Editor — bearbeiten, Format erkennen, exportieren.
Kodierte Werte im JSON? Stecken Base64-Blobs, URL-kodierte Strings oder JWT-Tokens in deinen Feldern, ent- und codiert sie der Coder — danach zurück in den JSON Editor zur Kontrolle.

Noch mehr Kontext: die Übersicht zum großen Bild, das Manual für jede Funktion im Detail und die Beispiele für die Schritt-für-Schritt-Abläufe. Ausprobieren kannst du alles direkt im Tool.