YamlBox

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

Durchsuchen Sie die vollständige Liste der 19-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.

Alle 19 Beiträge →