JSON formatieren und prüfen: praktische Anleitung für Einsteiger

JSON ist ein Textformat zum Austausch von Daten zwischen Browsern, Servern, Anwendungen und Konfigurationsdateien. Es ist gut lesbar, aber streng: Ein falsches Anführungszeichen, ein abschließendes Komma oder eine fehlende Klammer kann die Verarbeitung des gesamten Dokuments verhindern.

Die grundlegenden JSON-Strukturen

Ein Objekt steht in geschweiften Klammern und enthält Schlüssel-Wert-Paare. Eine Liste steht in eckigen Klammern. Schlüssel benötigen doppelte Anführungszeichen. Werte können Text, Zahlen, true, false, null, Objekte oder Listen sein.

{
  "name": "ToolBlur",
  "active": true,
  "languages": ["en", "ar", "es", "de"],
  "stats": {
    "tools": 100,
    "free": true
  }
}

JSON erlaubt keine Kommentare, einfachen Anführungszeichen oder Werte wie undefined. Nach dem letzten Element ist kein Komma zulässig. Diese Unterschiede sind wichtig, wenn ein JavaScript-Objekt kopiert wird.

Was JSON-Formatierung bedeutet

Formatierung fügt Zeilenumbrüche und Einrückungen hinzu, ohne Daten zu verändern. Verschachtelte Objekte und Änderungen lassen sich dadurch leichter prüfen. Minimierung entfernt umgekehrt unnötigen Leerraum. Beide Fassungen können genau dieselben Informationen enthalten.

Füge den Inhalt in den ToolBlur JSON-Formatter ein. Die Auswertung findet im Browser statt. Entferne dennoch Tokens, Zugangsdaten und unnötige personenbezogene Informationen, bevor du die Ausgabe weitergibst.

Häufige Fehler finden

• Abschließendes Komma: Das Komma vor der schließenden Klammer entfernen.
• Einfache Anführungszeichen: 'Wert' durch "Wert" ersetzen.
• Schlüssel ohne Anführungszeichen: "name" statt name schreiben.
• Steuerzeichen: In Zeichenketten Sequenzen wie \n verwenden.
• Unpassende Klammern: Für jede öffnende Klammer die passende schließende prüfen.

Wenn eine Fehlermeldung eine Position nennt, untersuche auch die Zeichen davor. Ein früher Fehler kann dazu führen, dass der Parser erst später endgültig die Struktur nicht mehr versteht.

Gültige Syntax bedeutet nicht korrekte Daten

Ein Dokument kann gültiges JSON sein und trotzdem falsche Felder enthalten. Eine API kann beispielsweise eine positive Zahl für age verlangen, obwohl "age": "unknown" syntaktisch korrekt ist. JSON Schema beschreibt Pflichtfelder, Typen, Grenzen und Muster. Syntax- und Schemaprüfung lösen unterschiedliche Probleme.

Sicherer Arbeitsablauf für APIs

1. Eine Kopie des ursprünglichen Wertes aufbewahren.
2. Zuerst die Syntax prüfen.
3. Für die Kontrolle von Namen, Ebenen und Typen formatieren.
4. Das Dokument mit API-Dokumentation oder Schema vergleichen.
5. In einer Entwicklungsumgebung testen, bevor Produktion verändert wird.

Häufig gestellte Fragen

Ist die Reihenfolge von Schlüsseln wichtig?

Sie sollte normalerweise keine Bedeutung tragen. Eine Anwendung greift über den Schlüsselnamen auf Werte zu.

Unterstützt JSON Datumswerte?

Es gibt keinen eigenen Datumstyp. Häufig wird eine ISO-8601-Zeichenkette verwendet, deren Format und Zeitzone vereinbart werden müssen.

Kann JSON sehr große Zahlen speichern?

Das Format kann sie darstellen, einige Laufzeitumgebungen verlieren jedoch Genauigkeit. Große numerische Kennungen werden deshalb oft als Text übertragen.