JSON-Formatter

Strukturierung und Validierung von JSON-Daten

Das JavaScript Object Notation (JSON) Format ist der etablierte Standard für den Datenaustausch in modernen Web-APIs und Konfigurationsdateien. Da JSON-Daten maschinell generiert werden, liegen sie oft in einer einzigen, ununterbrochenen Zeile vor. Dies spart Bandbreite, macht die manuelle Analyse oder Fehlersuche für Entwickler jedoch nahezu unmöglich.

Der JSON-Formatter löst dieses Problem, indem er unübersichtliche Datenstrukturen in eine sauber eingerückte, hierarchische Darstellung überführt. Neben der reinen Formatierung prüft das Tool die syntaktische Korrektheit der Daten nach den offiziellen Spezifikationen. Sollten Fehler im Dokument vorliegen, hilft die integrierte Validierung dabei, die genaue Ursache und Position der syntaktischen Abweichung zu lokalisieren und direkt im Browser zu beheben.

Eingabeoptionen und Dateiverarbeitung

Für die Verarbeitung Ihrer Daten stehen verschiedene Wege zur Verfügung. Sie können JSON-Texte direkt in das Eingabefeld einfügen oder lokale Dateien laden.

• Direkte Eingabe: Fügen Sie Ihren Text direkt in den Editor ein.
• Datei-Upload: Über die Schaltfläche "Datei öffnen" oder per Drag-and-Drop lassen sich Dateien mit den Endungen .json oder .txt laden.
• Dateigrößen-Limit: Das Tool verarbeitet Dateien bis zu einer maximalen Größe von 10 MiB. Wenn eine Datei dieses Limit überschreitet, erscheint die Meldung: "Die Datei ist zu groß — das Limit liegt bei {limit}.".
• Zeichenkodierung: Dateien müssen zwingend in UTF-8 kodiert sein. Sollte dies nicht der Fall sein, bricht der Vorgang mit dem Hinweis "Diese Datei ist kein UTF-8 text und kann hier daher nicht geöffnet werden." ab.
• Fehlerbehandlung beim Laden: Falls eine Datei beschädigt ist oder nicht gelesen werden kann, zeigt das Tool "Diese Datei konnte nicht gelesen werden. Wählen Sie sie erneut aus." an. Bei Überschreitung des absoluten Verarbeitungslimits erscheint "Die Eingabe ist größer als {limit} und übersteigt damit die Kapazität dieses Tools.".

Formatierung und Minimierung von JSON

Die Formatierung strukturiert das Dokument durch Zeilenumbrüche und Einrückungen neu, um die Lesbarkeit zu erhöhen. Über die Option "Einrückung" lässt sich der gewünschte Einrückungsgrad für die Ausgabe festlegen. Nach erfolgreicher Strukturierung meldet das System "JSON formatiert.".

Das Gegenteil der Formatierung ist das Minimieren. Diese Operation ist nützlich, um JSON-Daten für die Übertragung über APIs oder für die dauerhafte Speicherung vorzubereiten. Durch das Klicken auf "Minimieren" werden alle nicht benötigten Leerzeichen, Tabulatoren und Zeilenumbrüche entfernt, wodurch sich die Dateigröße reduziert. Das Tool bestätigt diesen Schritt mit der Meldung "JSON minimiert.". Während dieses Prozesses bleiben große Ganzzahlen (Large Integers) präzise und ohne jeglichen Datenverlust erhalten.

Zusätzlich bietet das Tool die Funktion "Schlüssel sortieren". Ein Klick auf diese Schaltfläche sortiert alle Objektschlüssel rekursiv in Codepunkt-Reihenfolge, während die Reihenfolge von Elementen innerhalb von Arrays unverändert bleibt. Das Tool gibt daraufhin die Rückmeldung: "Schlüssel sortiert — Array-Reihenfolge unverändert. Mit Strg/Cmd+Z rückgängig machen.".

Navigation in komplexen Daten über die Baumansicht

Für die Analyse verschachtelter Strukturen bietet das Tool neben der klassischen Textdarstellung ("Code") eine interaktive Baumstruktur ("Baum"). Diese Ansicht visualisiert die Hierarchie des Dokuments und ermöglicht ein gezieltes Durchsuchen und Navigieren.

Die Baumansicht unterliegt aus Performancegründen bestimmten Limits. Ist das JSON fehlerhaft, zeigt die Ansicht "Korrigieren Sie das JSON, um es als Baumstruktur anzuzeigen.". Ist das Dokument zu groß, erscheint "Dieses JSON ist zu groß, um als Baumstruktur dargestellt zu werden." oder "Dieses JSON enthält zu viele Werte, um als Baum dargestellt zu werden.". Beim vollständigen Ausklappen großer Strukturen wird die Anzeige limitiert und mit dem Hinweis "Dieses JSON ist zu groß, um vollständig ausgeklappt zu werden — angezeigt werden die ersten {count} Zeilen." versehen, wobei über "{count} weitere anzeigen…" zusätzliche Zeilen geladen werden können.

Datenextraktion mit JSON Pointer und JSONPath

Beim Navigieren in der Baumstruktur können spezifische Pfade direkt extrahiert werden. Über das Menü "Kopieroptionen für {key}" stehen folgende Optionen zur Verfügung, um Datenfragmente präzise zu kopieren:

• "Wert kopieren": Kopiert den reinen Inhalt des ausgewählten Knotens in die Zwischenablage.
• "JSON Pointer kopieren": Erstellt einen standardisierten Pfad nach RFC 6901 (z. B. /nutzer/0/name), der die genaue Position des Elements im Dokument beschreibt.
• "JSONPath kopieren": Erstellt einen Abfragepfad (z. B. $.nutzer.name), der in verschiedenen Programmiersprachen zur Datenextraktion genutzt werden kann.

Nach dem Kopieren zeigt das Interface "In die Zwischenablage kopiert." an.

Fehlererkennung und automatische Reparatur

Wenn das eingegebene JSON syntaktisch ungültig ist, wechselt der Status auf "Ungültiges JSON". Das Tool führt eine präzise Fehleranalyse durch und gibt die genaue Position über "Zeile {line}, Spalte {col}" aus. Mit der Schaltfläche "Zum Fehler springen" springt der Cursor direkt an die betroffene Stelle im Editor.

Das Tool erkennt spezifische Syntaxfehler und benennt diese im Detail:

• "Fehlendes Komma zwischen Einträgen"
• "Überflüssiges Komma vor der schließenden Klammer"
• "Objektschlüssel müssen in doppelte Anführungszeichen gesetzt werden"
• "Fehlender Doppelpunkt nach einem Eigenschaftsnamen"
• "Einem String fehlt das schließende Anführungszeichen"
• "Das JSON endet zu früh — es wirkt abgeschnitten"
• "Unerwartetes Zeichen an einer Stelle, an der ein Wert stehen sollte"
• "Dieses JSON ist zu tief verschachtelt, um verarbeitet zu werden"
• "Doppelter Schlüssel {key} — entfernen Sie einen davon vor dem Formatieren" (Verhindert das stille Zusammenführen oder Verwerfen von Werten).

Erkennung von Nicht-Standard-Formaten und Reparatur

Das Tool erkennt automatisch, wenn es sich bei der Eingabe um ein verwandtes oder eingebettetes Format handelt, und bietet eine passende Reparatur an:

• Markdown-Codeblöcke: Erkennt "Das sieht nach JSON in einem Markdown-Codeblock aus.". Die Aktion "Beim Anwenden bleibt nur das JSON innerhalb des Codeblocks erhalten." isoliert die Daten.
• Escaped JSON: Erkennt "Das sieht nach JSON aus, das in einer Zeichenkette escaped wurde.". Die Aktion "Beim Anwenden wird die Zeichenkette zu reinem JSON entschärft." stellt das Originaldokument wieder her.
• Python-Dictionaries: Erkennt "Das sieht eher nach einem Python-Dictionary als nach JSON aus.". Die Aktion "Beim Anwenden werden Anführungszeichen und True/False/None als JSON umgeschrieben." konvertiert die Syntax.
• JSON Lines (NDJSON): Erkennt "Das sieht nach JSON Lines aus — ein Wert pro Zeile.". Die Aktion "Beim Anwenden werden die Zeilen zu einem JSON-Array zusammengefasst." strukturiert die Daten um.
• JSONP-Callbacks: Erkennt "Das sieht nach JSON in einem JSONP-Callback aus.". Die Aktion "Beim Anwenden wird der Callback-Wrapper entfernt." extrahiert das reine JSON.
• JSONC (JSON mit Kommentaren): Erkennt "Das sieht nach JSONC aus — Kommentare oder nachgestellte Kommas. Stellen Sie die Syntax auf JSONC um oder wenden Sie die Korrektur an.". Die Aktion "Beim Anwenden werden Kommentare und nachgestellte Kommas entfernt." bereinigt das Dokument.

Über die Schaltfläche "Korrektur ansehen" öffnet sich die "Korrektur-Vorschau", die im direkten Vergleich das "Original" und das Ergebnis "Nach der Korrektur" gegenüberstellt. Ist das Dokument zu groß, wird die Anzeige mit dem Hinweis "Vorschau gekürzt — die Korrektur betrifft das gesamte Dokument." limitiert. Mit "Korrektur anwenden" wird die Änderung übernommen, was das Tool mit "Korrektur angewendet. Mit Strg/Cmd+Z rückgängig machen." bestätigt. Schlägt die Reparatur fehl, erscheint "Diese Eingabe konnte nicht automatisch repariert werden.".

Performance-Grenzen und Datenschutz

Um die Stabilität des Browsers bei der Verarbeitung extrem großer Dokumente zu gewährleisten, gelten feste technische Grenzwerte:

• Synchrones Verarbeitungslimit: Liegt bei 250.000 Zeichen. Bei Überschreitung oder zu hoher Systemlast wird der Vorgang abgebrochen und die Meldung "Die Prüfung dieses JSON hat zu lange gedauert und wurde abgebrochen. Versuchen Sie es mit einem kleineren Dokument." ausgegeben.
• Maximales Dateilimit: Dokumente über 10 MiB werden nicht verarbeitet.
• Lokale Verarbeitung: Die Verarbeitung Ihrer Daten erfolgt vollständig lokal in Ihrem Webbrowser. Es werden keine Daten an BroBroGo übertragen.

---

Häufig gestellte Fragen (FAQ)

Wird mein JSON hochgeladen?
Nein. Der Formatter läuft direkt in Ihrem Browser und lädt Ihr JSON nicht hoch.

Was bewirkt das Minimieren (Minify)?
Minimieren entfernt unnötige Leerzeichen und Zeilenumbrüche, während die JSON-Daten unverändert bleiben.

Wie verhält sich das Tool bei doppelten Schlüsseln in einem Objekt?
Im Gegensatz zu anderen Parsern, die doppelte Schlüssel stillschweigend überschreiben, bricht dieses Tool mit einer Fehlermeldung ab ("Doppelter Schlüssel {key} — entfernen Sie einen davon vor dem Formatieren"), um Datenverlust zu verhindern.

Können Kommentare in JSON-Dateien verarbeitet werden?
Standard-JSON erlaubt keine Kommentare. Wenn Ihre Datei Kommentare enthält, können Sie die Syntax auf "JSONC" umstellen oder die automatische Korrektur anwenden, um die Kommentare entfernen zu lassen.