JSON Werkzeuge · 6 Min. gelesen
JSON Formatierer: hübsch, minimiert und tatsächlich gültig
Ein JSON-Formatierer erledigt drei Aufgaben, und es lohnt sich zu wissen, welche Sie tatsächlich benötigen: Er macht dichte JSON lesbar, er macht JSON kompakt lesbar und er sagt Ihnen genau, wo eine Datei nicht mehr gültig ist JSON. Die meisten Leute greifen zu einem Formatierer, weil etwas kaputt ist – und die Fehlermeldung, nicht der hübsche Ausdruck, ist der Teil, der den Nachmittag rettet.
Aktualisiert
Pretty-Print: für Menschen und Pull-Requests
Eingerückt JSON ist überprüfbar JSON. Zwei Leerzeichen sind die Konvention in den meisten JavaScript-Codebasen und entsprechen der Standardeinstellung in `JSON.stringify(value, null, 2)`; Vier Leerzeichen eignen sich für so konfigurierte Redakteure. Die Wahl der Formatierung ist weniger wichtig als die Konsistenz, da die gemischte Einrückung jeden späteren Unterschied in Rauschen verwandelt. Wenn Ihr JSON generiert wird, legen Sie die Einrückung im Generator einmal fest und lassen Sie sie vom Formatierer lokal für eingefügte Nutzlasten erzwingen.
Minimieren: für Nutzlasten auf dem Kabel
Leerzeichen in JSON sind optional, daher ist das Entfernen dieser Leerzeichen eine kostenlose Ersparnis. Bei einer 200 KB großen API-Antwort beträgt der Unterschied normalerweise 15–30 Prozent der Bytes, was wichtig ist, wenn es sich bei dem Budget um eine mobile Verbindung oder einen Cache-Header handelt, den Sie respektieren möchten. Das Minimieren ist auch der richtige Schritt, bevor eine Nutzlast in einer Datenbankspalte gespeichert oder in ein URL eingebettet wird – minimieren Sie einfach als Build-Schritt und nicht manuell, da das Debuggen bei der manuellen Minimierung von JSON zum Scheitern verurteilt ist.
Validierung: die Fehler, auf die Sie tatsächlich stoßen
JSON ist eine bewusst kleine Grammatik, weshalb sich ihre Fehler so oft wiederholen. Fast jeder ungültige JSON-Fehler geht auf eine von fünf Gewohnheiten zurück, die aus JavaScript oder YAML übernommen wurden:
- Nachgestellte Kommas – `{"a": 1,}` ist gültiges JavaScript und ungültig JSON.
- Einfache Anführungszeichen oder Schlüssel ohne Anführungszeichen – `{a: 'b'}` muss zu `{"a": "b"}` werden.
- Kommentare – `// note` und `/* note */` haben in JSON überhaupt keinen Platz.
- Steuerzeichen ohne Escapezeichen – Literale Zeilenumbrüche innerhalb einer Zeichenfolge müssen `\n` sein.
- Verkettete Objekte – zwei Objekte der obersten Ebene nebeneinander, normalerweise aus einer Protokolldatei mit einem JSON-Dokument pro Zeile.
Ein Formatierer sollte Ihnen die Zeile und die Spalte mitteilen und den Auszug anzeigen. Allein „Unerwartetes Token“ lässt Sie scrollen; „Zeile 84, Spalte 17 – abschließendes Komma vor }“ ist eine Lösung.
Warum vor dem Debuggen validieren?
Wenn eine Integration fehlschlägt, besteht der Instinkt darin, den Code zu überprüfen. Häufiger ist die Nutzlast selbst fehlerhaft: Eine Vorlage gab ein verirrtes Komma aus, eine Protokollpipeline schnitt eine Zeile ab oder durch Kopieren und Einfügen aus einem Dokument wurden intelligente Anführungszeichen eingeführt. Wenn Sie zuerst den JSON-Formatierer ausführen, wird in Sekundenschnelle „die Daten sind falsch“ von „der Code ist falsch“ getrennt, und die genaue Zeilennummer zeigt normalerweise direkt auf die Vorlage, die sie erstellt hat.
Große Dateien und Privatsphäre
API-Antworten und Datenbankexporte enthalten häufig Token, persönliche Felder oder Kundendaten. Ein serverseitiger JSON-Formatierer bedeutet, dass diese Nutzlast an einen Dritten hochgeladen wird, um sie zurückzugeben – eine Frage des Datenschutzes, die keinen Vorteil hat, da die Formatierung ein trivialer lokaler Vorgang ist. Der Formatierer YamlBox JSON analysiert im Browser ohne Netzwerkaufrufe, funktioniert also offline und behält Ihre Nutzdaten auf Ihrem Computer; Auf derselben Seite finden Sie Einrückungsoptionen, Schlüsselsortierung für stabile Unterschiede und Live-Statistiken wie Tiefe und Schlüsselanzahl.
JSON Formatierer – häufig gestellte Fragen
Was ist der Unterschied zwischen Formatierung und Validierung von JSON?
Die Formatierung ändert nur Leerzeichen und ist immer sicher, sobald das Dokument analysiert wird. Bei der Validierung wird überprüft, ob überhaupt eine Analyse durchgeführt wird. Ein Formatierer, der Ihre Eingaben nicht analysieren kann, meldet eine Zeile und eine Spalte, anstatt eine Ausgabe zu erzeugen, und dieser Bericht ist der nützliche Teil.
Um wie viel kleiner ist das minimierte JSON?
Typischerweise 15–30 Prozent, abhängig davon, wie tief das Dokument verschachtelt ist und wie lang die Schlüssel sind. Die Minimierung ist verlustfrei: Leerzeichen zwischen Token haben in JSON keine Bedeutung, sodass ein minimiertes Dokument auf genau denselben Wert analysiert wird.
Ist es sicher, JSON, das Geheimnisse enthält, im Browser zu formatieren?
Ja, wenn der Formatierer vollständig clientseitig ausgeführt wird. Es erfolgt kein Upload und keine Anfrage an einen Server, sodass die Token in der Nutzlast in Ihrem Tab verbleiben – und die Seite funktioniert auch dann weiter, wenn das Netzwerk ausgeschaltet ist, was Sie selbst überprüfen können.
In diesem Beitrag erwähnte Tools
Weitere Artikel zum Lesen
6 Min. gelesen
JSON Diff: Daten so vergleichen, wie sie tatsächlich
Vergleichen Sie zwei JSON-Nutzlasten mit einem strukturellen JSON-Diff, der Schlüsselreihenfolge und Leerzeichen ignoriert, verschobene Werte hervorhebt und zeigt, warum Textunterschiede irreführend sind.
6 Min. gelesen
JSON bis JSON Schema: von der Beispielnutzlast bis zum Vertrag
Konvertieren Sie JSON in JSON Schema im Browser: Leiten Sie einen Entwurf aus einer echten Nutzlast ab und härten Sie dann erforderliche Felder, Formate und Aufzählungen aus – plus die Grenzen der Inferenz.
6 Min. gelesen
YAML bis JSON: Konfigurationen konvertieren, ohne den Verstand
Konvertieren Sie YAML in JSON im Browser mit Unterstützung für mehrere Dokumente und genauen Fehlerorten – plus den YAML-Fehlern, die CI-Pipelines stillschweigend unterbrechen.
- Längerer Artikel zum Lesen: YAML vs. JSON: Wann man welche verwendet (und wie man