JSON-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Einklapp-/Aufklapp-Steuerung.
JSON-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Einklapp-/Aufklapp-Steuerung. JSON-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Einklapp-/Aufklapp-Steuerung.
Array
Hintergrund
Was JSON ist und warum du es anders betrachten möchtest
JSON (JavaScript Object Notation) ist das gebräuchlichste Textformat zum
Austausch strukturierter Daten im Web: Konfigurationsdateien, API-
Antworten, Protokolleinträge, Dokumentenspeicher und vieles mehr. Es ist
klein, menschenlesbar und trivial maschinenparserbar, weshalb fast jeder
moderne Dienst es spricht.
Ein rohes JSON-Dokument ist selten für sich allein nützlich. APIs und
Werkzeuge geben oft eine einzige lange Zeile ohne Leerzeichen aus, weil das
die kürzeste Darstellung ist. Wenn du ein solches Dokument in einem Editor
öffnest, ist es schwer zu scannen, schwer, nicht zusammengehörige Klammern
zu erkennen, und leicht verlierst du dich beim Zählen der Klammern. Ein
JSON-Viewer löst das, indem er das Dokument mit konsistenter Einrückung
neu ausgibt, sodass die Struktur auf einen Blick sichtbar wird.
Funktionen, die sich lohnen
Pretty-Printing lässt dich eine Einrückungsgröße wählen (meist zwei oder
vier Leerzeichen) und rendert das Dokument sofort neu. Manche Viewer lassen
dich auch Schlüssel alphabetisch sortieren, was unbezahlbar ist, wenn du
zwei Nutzdaten derselben Dienste vergleichst: Wenn sich die Schlüssel
vertikal ausrichten, kannst du nach Wertunterschieden scannen, ohne nach
Position zu matchen. Eine Statistikzeile, die die Bytezahl und Knotenzahl
meldet, ist hilfreich, wenn du gerade eine Nutzlast in ein Formular mit
1-MB-Limit einfügen willst: Sie sagt dir genau, wie groß sie ist, ohne ein
Terminal zu öffnen.
Ein Viewer ist auch ein Validator. Das Parsen mit JSON.parse
wirft einen beschreibenden Fehler, der auf genau die Zeile und Spalte
des ersten ungültigen Tokens zeigt, sodass du sofort siehst, warum dein
Dokument sich weigert zu laden. Die meisten Produktionswerkzeuge erzeugen
Fehler an demselben Punkt, sodass die Nachricht hier mit dem übereinstimmt,
was dein Backend, dein Frontend-Framework oder deine Build-Pipeline sagen
würde.
Workflow-Tipps
Nutze die Einklapp-/Aufklapp-Steuerung, um dich auf die oberste Ebene eines
tief verschachtelten Dokuments zu konzentrieren, bohre dich zum Abschnitt
vor, der dich interessiert, und kopiere den Zweig, den du brauchst. Wenn du
eine API-Antwort debuggst, sortiere die Schlüssel vor dem Vergleich, sodass
Einfügungen und Löschungen an anderen Positionen deine Augen nicht
verwirren. Wenn du im Zweifel bist, füge das Dokument in einen neuen Tab
ein, passe die Formatierung an, und verwende die Ausgabe als kanonische
Version für Dokumentation oder Commit-Nachrichten.
Häufig gestellte Fragen
Behält der Viewer Kommentare im JSON-Dokument?
Standard-JSON erlaubt keine Kommentare. Wenn deine Eingabe // oder /* */ Kommentare enthält, weist der Parser sie zurück; entferne sie zuerst oder wandele deine Datei mit einem eigenen Werkzeug in JSON5/JSONC um.
Warum stimmt die Bytezahl nicht mit dem überein, was ich von der API kopiert habe?
Die Bytezahl ist die Größe der gerenderten Ausgabe. Wenn du Pretty-Print mit 2-Leerzeichen-Einrückung aktivierst, wächst die Ausgabe. Verwende den nicht eingerückten Modus, wenn du die Übertragungsgröße brauchst.
Kann der Viewer sehr große JSON-Dokumente verarbeiten?
Ja. Der Viewer parst das gesamte Dokument im Speicher und gibt es neu aus, sodass das praktische Limit der verfügbare Heap deines Browsers ist (bequem hunderte MB auf einem modernen Laptop). Für mehr-Gigabyte-Dokumente erwäge einen Streaming-Ansatz.
Ändert das Sortieren der Schlüssel die Bedeutung des Dokuments?
Nein. JSON-Objekte sind ungeordnete Sammlungen von Name/Wert-Paaren. Sortieren ändert nur den ausgegebenen Text, nicht die Semantik. Die meisten Parser lesen Schlüssel unabhängig von der Reihenfolge in eine Hash-Map.
Warum meldet der Parser einen unerwarteten Token in einer bestimmten Spalte?
JSON.parse meldet das erste Token, das es nicht interpretieren kann. Die angegebene Zeile/Spalte ist dort, wo das Token beginnt; der eigentliche Fehler liegt oft ein Zeichen davor (ein nicht escaptes Anführungszeichen, ein fehlendes Komma oder ein verirrtes Komma am Ende eines Objekts).
Wird mein Dokument an einen Server gesendet?
Nein. Das gesamte Parsen, Sortieren und Reformattieren geschieht im Browser über native JavaScript-APIs. Es gibt keinen Upload-Schritt.