Entwicklung 6 Min. Lesezeit
Wer schon einmal mit einer API, einer Konfigurationsdatei oder einem Datenexport gearbeitet hat, ist JSON begegnet. Es wirkt einfach, doch ein einziges falsch gesetztes Komma reicht, um die ganze Datei ungültig zu machen und eine kryptische Fehlermeldung auszulösen.
In diesem Leitfaden erfahren Sie, was JSON ist, welche Werttypen es kennt, welche Syntaxregeln gelten, welche Fehler am häufigsten vorkommen (mit Vorher-Nachher-Beispielen) und wie Sie Ihre Daten in Sekunden validieren, formatieren und minifizieren.
JSON jetzt validieren und formatieren Fügen Sie Ihr JSON ein, um Fehler zu finden, es zu formatieren oder zu minifizieren. Alles läuft in Ihrem Browser, nichts wird hochgeladen. JSON-Formatter öffnenWas ist JSON?
JSON (JavaScript Object Notation) ist ein schlankes Textformat zum Speichern und Austauschen von Daten. Die Daten sind als Schlüssel-Wert-Paare aufgebaut, zum Beispiel {"name": "Ana", "alter": 30}. Es ist für Menschen gut lesbar und für Programme leicht zu verarbeiten.
Obwohl JSON aus JavaScript stammt, ist es sprachunabhängig. Web-APIs nutzen es standardmäßig, um Daten zwischen Servern und Apps zu übertragen, und es ist auch in Konfigurationsdateien, Logs und Exporten weit verbreitet.
Die sechs Werttypen
Jeder Wert in JSON gehört zu einem dieser sechs Typen:
- String: Text in doppelten Anführungszeichen, zum Beispiel "hallo".
- Zahl: Ganzzahl oder Dezimalzahl, zum Beispiel 42 oder 3.14, ohne Anführungszeichen.
- Boolean: true oder false, kleingeschrieben und ohne Anführungszeichen.
- Null: das Wort null für "kein Wert".
- Array: eine geordnete Liste in eckigen Klammern, zum Beispiel [1, 2, 3].
- Objekt: eine Menge von Schlüssel-Wert-Paaren in geschweiften Klammern, zum Beispiel {"stadt": "Berlin"}. Schlüssel sind immer Strings.
Arrays und Objekte können weitere Arrays und Objekte enthalten, so lassen sich beliebig tief verschachtelte Daten beschreiben.
Die Syntaxregeln im Überblick
JSON ist deutlich strenger als JavaScript. Die meisten Fehler entstehen durch den Bruch einer dieser Regeln:
- Strings und Schlüssel brauchen doppelte Anführungszeichen. Einfache sind nicht erlaubt.
- Kein Komma am Ende: Auf das letzte Element eines Arrays oder Objekts darf kein Komma folgen.
- Keine Kommentare: Weder // noch /* */ sind gültig.
- Es gibt nur die sechs Typen: undefined, NaN, Infinity und Funktionen sind ungültig.
- Paare werden durch Kommas getrennt, Schlüssel und Wert durch einen Doppelpunkt.
- Jede geöffnete Klammer braucht ihre schließende Klammer.
Die häufigsten Fehler und wie man sie behebt
Diese fünf Fehler verursachen die meisten "ungültiges JSON"-Meldungen:
- Komma am Ende. Vorher: {"a": 1, "b": 2,}. Nachher: {"a": 1, "b": 2}. Entfernen Sie das Komma nach dem letzten Element.
- Einfache Anführungszeichen. Vorher: {'name': 'Ana'}. Nachher: {"name": "Ana"}. Ersetzen Sie alle einfachen durch doppelte Anführungszeichen.
- Schlüssel ohne Anführungszeichen. Vorher: {name: "Ana"}. Nachher: {"name": "Ana"}. Setzen Sie jeden Schlüssel in doppelte Anführungszeichen.
- Fehlende Klammer. Vorher: {"items": [1, 2, 3}. Nachher: {"items": [1, 2, 3]}. Schließen Sie jedes Array und jedes Objekt, das Sie öffnen.
- Falsch maskierte Anführungszeichen. Vorher: {"text": "Er sagte "hallo""}. Nachher: {"text": "Er sagte \"hallo\""}. Ein doppeltes Anführungszeichen innerhalb eines Strings muss mit einem Backslash maskiert werden. Dasselbe gilt für den Backslash selbst, der als \\ geschrieben wird.
Vorsicht auch bei typografischen Anführungszeichen aus Textverarbeitungen: Sie sehen aus wie Anführungszeichen, sind in JSON aber ungültig.
So lesen Sie eine JSON-Fehlermeldung
Die meisten Parser sagen, wo sie die Orientierung verloren haben, etwa mit "Unexpected token } in JSON at position 25" oder "Expected double-quoted property name at line 3 column 5". Die Position ist die Zeichenanzahl ab dem Anfang, Zeile und Spalte nennen die genaue Stelle.
Der eigentliche Fehler liegt oft kurz vor der gemeldeten Position. Eine unerwartete schließende geschweifte Klammer deutet meist auf ein Komma direkt davor hin, ein unerwartetes Datenende auf eine fehlende schließende Klammer. Prüfen Sie die gemeldete Zeile und die darüber.
JSON validieren, formatieren und minifizieren
- Öffnen Sie den kostenlosen JSON-Formatter. Er läuft komplett in Ihrem Browser, Ihre Daten verlassen Ihr Gerät nicht.
- Fügen Sie Ihr JSON ein. Ist es ungültig, zeigt das Tool den Fehler mit Zeile und Spalte an, damit Sie ihn beheben können.
- Nutzen Sie die Formatierung, um es einzurücken und lesbar zu machen, oder minifizieren Sie es, um Leerzeichen zu entfernen und die Größe vor dem Senden zu verringern.
- Kopieren Sie das Ergebnis. Wenn Sie eine Datei geändert haben und genau sehen möchten, was anders ist, vergleichen Sie beide Versionen mit dem Text-Diff-Tool.
JSON, XML und YAML im Vergleich
XML ist ausführlicher, mit öffnenden und schließenden Tags, unterstützt aber Attribute und ist in älteren Systemen weiterhin üblich. YAML ist für Menschen übersichtlicher und erlaubt Kommentare, weshalb es in Konfigurationsdateien beliebt ist, doch die Einrückung ist leicht falsch gesetzt.
JSON liegt dazwischen: kompakt, eindeutig und von praktisch jeder Sprache unterstützt, daher die Standardwahl für APIs. Der größte Nachteil sind die fehlenden Kommentare.
Praktische Tipps
- Validieren Sie JSON immer, bevor Sie es senden oder in eine Konfigurationsdatei speichern.
- Nutzen Sie einen Editor mit JSON-Syntaxhervorhebung, der fehlende Anführungszeichen und Klammern sofort anzeigt.
- Schreiben Sie JSON nicht von Hand, wenn Sie es per Code erzeugen können: Bibliotheken maskieren Zeichen korrekt.
- Wenn ein URL-Parameter JSON enthält, kodieren Sie ihn zuvor mit dem URL-Encoder, damit Sonderzeichen die Anfrage nicht stören.
- Fügen Sie keine Passwörter oder Tokens in Online-Tools ein, die Daten hochladen. Bevorzugen Sie Tools, die lokal arbeiten.
Fazit
JSON ist einfach, wenn man die Regeln kennt: sechs Werttypen, doppelte Anführungszeichen, kein Komma am Ende und keine Kommentare. Wenn etwas bricht, lesen Sie Zeile und Spalte der Fehlermeldung, prüfen Sie die Stelle direkt davor und lassen Sie einen Validator die Hauptarbeit erledigen. Ein paar Sekunden mit einem Formatter sparen viel Zeit bei der Fehlersuche.
Häufig gestellte Fragen
Wofür wird JSON verwendet?
Es dient dem Datenaustausch zwischen Anwendungen, besonders bei Web-APIs, und dem Speichern von Einstellungen und strukturierten Daten in Dateien. Fast jede Programmiersprache kann JSON lesen und schreiben.
Darf JSON Kommentare enthalten?
Nein. Standard-JSON erlaubt keine Kommentare. Wenn Sie Notizen brauchen, nutzen Sie ein normales Feld wie "kommentar" oder ein Format wie YAML für Konfigurationsdateien.
Warum meldet mein JSON "unexpected token"?
Der Parser hat ein unerwartetes Zeichen gefunden, meist ein Komma am Ende, ein einfaches Anführungszeichen, einen Schlüssel ohne Anführungszeichen oder eine fehlende Klammer. Prüfen Sie die gemeldete Position und die Zeile direkt darüber.
Was ist der Unterschied zwischen Formatieren und Minifizieren?
Formatieren fügt Zeilenumbrüche und Einrückungen für die Lesbarkeit hinzu. Minifizieren entfernt alle überflüssigen Leerzeichen, um die Datei zu verkleinern. Die Daten bleiben exakt dieselben.
Ist ein Online-JSON-Formatter sicher?
Er ist sicher, wenn das Tool in Ihrem Browser arbeitet und den Inhalt nicht an einen Server sendet. Unser JSON-Formatter verarbeitet alles lokal auf Ihrem Gerät.
Kostenlose Tools aus diesem Artikel
Weiterlesen
- So erstellen Sie ein sicheres PasswortLänge, Zufall und Einzigartigkeit: die einfachen Regeln, die Ihre Konten wirklich schützen, und wie Sie sie befolgen, ohne sich etwas merken zu müssen.
- Die Pomodoro-Technik: Der komplette LeitfadenArbeite in konzentrierten 25-Minuten-Blöcken mit kurzen Pausen. So funktioniert die Methode, so startest du heute und so passt du sie an deinen Alltag an.
- Was ist ein Hash? MD5, SHA-256 und wofür man sie brauchtEin Hash ist ein kurzer Fingerabdruck beliebiger Daten. So funktioniert er, welche Algorithmen Sie nutzen sollten und wie Sie Dateien prüfen und Passwörter schützen.