Einen JSON-String validieren

Ob eine Zeichenkette gültiges JSON ist, entscheidet sich an den Regeln des Formats. Auf oberster Ebene darf ein JSON-Dokument ein Objekt in geschweiften Klammern, ein Array in eckigen Klammern oder einen einzelnen Wert enthalten, also eine Zeichenkette, eine Zahl, einen Wahrheitswert oder null. Viele nehmen an, JSON müsse immer mit einer geschweiften Klammer beginnen, doch auch der String „hallo“ oder die Zahl 42 sind für sich genommen gültiges JSON. Entscheidend ist, dass die gesamte Zeichenkette genau einen Wert beschreibt und danach nichts mehr folgt. Steht nach dem abschließenden Zeichen noch weiterer Text, ist der String ungültig. Das Werkzeug prüft die Zeichenkette als Ganzes und meldet, sobald ein unerwartetes Zeichen die Struktur verletzt oder überflüssiger Inhalt am Ende die Prüfung scheitern lässt.

Ein besonders häufiges Problem bei der Prüfung eines JSON-Strings sind die Anführungszeichen. In JSON stehen sowohl Schlüssel als auch Textwerte immer in doppelten Anführungszeichen. Einfache Anführungszeichen, wie man sie aus manchen Programmiersprachen kennt, sind nicht erlaubt und führen sofort zu einem Fehler. Innerhalb eines Textwertes müssen bestimmte Zeichen maskiert werden: ein Anführungszeichen als Backslash gefolgt vom Anführungszeichen, ein Backslash selbst durch einen doppelten Backslash und ein Zeilenumbruch durch die Folge Backslash-n. Wird ein solches Zeichen unmaskiert eingefügt, etwa weil ein Text mit echten Zeilenumbrüchen aus einer Datenbank stammt, bricht der Parser ab. Das Werkzeug zeigt Ihnen in diesen Fällen die genaue Position, an der die Maskierung fehlt. So erkennen Sie schnell, ob nur ein einzelnes Zeichen falsch escapt ist und der String ansonsten korrekt aufgebaut wäre.

Neben den Anführungszeichen gibt es eine kleine Zahl weiterer Fehler, die immer wieder auftreten. Ein abschließendes Komma nach dem letzten Element eines Objekts oder Arrays ist in JSON verboten, obwohl viele Editoren und Sprachen es tolerieren. Ebenso müssen alle geöffneten Klammern wieder geschlossen werden, und zwar in der richtigen Reihenfolge; eine fehlende schließende Klammer am Ende ist ein klassischer Grund für einen ungültigen String. Kommentare, ob mit zwei Schrägstrichen oder als Block, gehören nicht zum JSON-Standard und lassen die Prüfung scheitern. Auch Zahlen unterliegen Regeln: führende Nullen oder ein nachgestelltes Plus sind nicht erlaubt. Das Werkzeug kennt all diese Fälle und benennt den ersten Verstoß konkret mit Position und Ursache. Wenn Sie die typischen Meldungen ein paar Mal gesehen haben, erkennen Sie die Muster schnell und vermeiden sie beim nächsten Mal.

Wie bei allen Prüfungen dieses Anbieters wird auch Ihr JSON-String ausschließlich lokal in Ihrem Browser verarbeitet. Die eingefügte oder geladene Zeichenkette wird nicht an einen Server übertragen, nicht gespeichert und nicht an Dritte weitergegeben. Die gesamte Analyse läuft als JavaScript in der geladenen Seite ab, sodass die Daten Ihr Gerät zu keinem Zeitpunkt verlassen. Das ist gerade dann wichtig, wenn Ihr String vertrauliche Inhalte enthält, etwa Zugangsdaten, personenbezogene Angaben oder interne Konfigurationswerte. Sie können solche Zeichenketten also bedenkenlos prüfen. Ein weiterer Vorteil der lokalen Verarbeitung ist die Geschwindigkeit, denn ohne den Umweg über ein Netzwerk erhalten Sie das Ergebnis unmittelbar. Sobald die Seite einmal geladen ist, funktioniert die Prüfung sogar offline. Es ist keine Registrierung nötig, es gibt kein Wasserzeichen und keine künstliche Begrenzung der Stringlänge außer dem Speicher Ihres Browsers.

Ein gültiger String bedeutet zunächst nur, dass die Zeichenkette wohlgeformt ist und von einem Parser gelesen werden kann. Ob die enthaltenen Werte auch inhaltlich passen, ist eine andere Frage. Wenn Ihr String beispielsweise ein Objekt mit bestimmten Pflichtfeldern beschreiben soll, prüft die reine Syntaxvalidierung nicht, ob diese Felder vorhanden sind. Dafür bietet das Werkzeug optional eine Prüfung gegen ein JSON Schema an, mit der Sie Datentypen, Pflichtfelder und erlaubte Werte kontrollieren. Die Fehlererkennung selbst arbeitet nach dem Prinzip, den String von vorne nach hinten zu lesen und beim ersten unerwarteten Zeichen anzuhalten. Die gemeldete Position entspricht dem Zeichen-Offset, den auch JavaScript beim Aufruf von JSON.parse zurückgibt. So erhalten Sie eine präzise, nachvollziehbare Auskunft und müssen nicht raten, an welcher Stelle Ihr String von der erwarteten Struktur abweicht.