Die Bruchstelle finden
Wenn der eingefügte Text nicht durchgeht, erscheinen Zeile und Spalte, an denen der Parser aufgegeben hat. Schauen Sie zuerst eine Zeile darüber. Ein Komma zu viel oder zu wenig fällt erst beim nächsten Token auf, deshalb liegt die gemeldete Stelle meist knapp hinter dem eigentlichen Fehler.
Die üblichen Verdächtigen sind schnell aufgezählt.
- Ein Komma nach dem letzten Element. In JavaScript-Objekten erlaubt, in JSON ein Fehler.
- Einfache Anführungszeichen.
'name'ist keine JSON-Zeichenkette. Schlüssel und Werte stehen in doppelten Anführungszeichen. - Kommentare. Eine Konfigurationsdatei mit
//oder/* */ist JSONC, nicht JSON. - Schlüssel ohne Anführungszeichen.
{name: "Wert"}ist JavaScript-Syntax. NaNundInfinity. Sie sehen nach Zahlen aus, stehen aber nicht in der Spezifikation. Meist stammen sie aus einem kopierten Log.
Wann minifizieren
Beim Minifizieren fallen alle optionalen Leerzeichen weg und das Dokument steht in einer Zeile. Genau diese Form brauchen Sie für einen Konfigurationswert, eine einzelne Umgebungsvariable oder den Body eines curl-Aufrufs. Die Datei wird auch kleiner, doch Server komprimieren Antworten ohnehin mit gzip, sodass die Größe selten der Grund ist.
Für alles, was in ein Repository wandert, behalten Sie die Einrückung. Bei einer minifizierten Datei wird aus der Änderung eines Zeichens ein Diff über das ganze Dokument, und das prüft niemand mehr.
Schlüsselreihenfolge und Einrückung
Beim Formatieren bleibt die Reihenfolge Ihrer Schlüssel erhalten. Laut Spezifikation trägt die Reihenfolge der Schlüssel keine Bedeutung, in der Praxis behalten aber fast alle Parser die Einfügereihenfolge bei, deshalb sortiert dieses Werkzeug nicht um.
Zwei Leerzeichen sind am verbreitetsten, vier begegnen einem rund um Python-Werkzeuge. Tabulatoren sparen ein paar Bytes, erscheinen je nach Editor aber unterschiedlich breit. In einem gemeinsamen Repository richten Sie sich nach dem, was schon da ist.
Tokens und echte Antworten einfügen
Nichts von dem, was Sie einfügen, wird irgendwohin geschickt. Der Text wird im Browser geparst und wieder zusammengesetzt, eine Antwort voller Kundendaten oder ein Access Token verlassen das Gerät also nicht. Manche Unternehmen untersagen externe Werkzeuge trotzdem, unabhängig von der Funktionsweise: Bei Produktionsdaten prüfen Sie vorher die Richtlinie.