JSON-Formatierer

Werte und Struktur

Ein JSON-Dokument enthält einen Wert. Das kann ein Objekt oder Array sein, aber auch eine Zeichenkette, eine Zahl, ein boolescher Wert oder null ist an der Wurzel gültig. Objekte ordnen Zeichenketten als Namen Werte zu; Arrays enthalten Werte in einer bedeutsamen Reihenfolge. Beide können verschachtelt werden.

Die richtige Syntax

Verwende doppelte Anführungszeichen für Eigenschaftsnamen und Zeichenketten. Ein Doppelpunkt trennt einen Namen von seinem Wert; Kommas trennen Objektmitglieder und Array-Elemente. Füge nach dem letzten Mitglied oder Element kein Komma ein. Kommentare, einfache Anführungszeichen und JavaScript-Ausdrücke gehören nicht zu strengem JSON.

Die Literale true, false und null werden kleingeschrieben. Zahlen verwenden die Dezimalschreibweise mit optionalem Minuszeichen, Nachkommastellen und Exponenten. Führende Nullen, ein führendes Pluszeichen, NaN und Infinity sind ungültig. In Zeichenketten müssen Anführungszeichen, Rückstriche und Steuerzeichen maskiert werden; ein Zeilenumbruch muss als Escapesequenz wie \n geschrieben werden.

Objektnamen sollten für einen zuverlässigen Datenaustausch eindeutig sein. Verschiedene Programme können bei wiederholten Namen unterschiedliche Werte behalten. Der Formatierer meldet Duplikate und erhält sie, damit du entscheiden kannst, wie du sie behebst. Eine Syntaxprüfung allein kann nicht bestätigen, dass ein Dokument einen API-Vertrag oder JSON Schema erfüllt.

Was die Formatierung bewahrt

DevToolsy validiert die Eingabe und passt Leerraum um die ursprünglichen Tokens an. Zahlentext wie 900719925474099312345, 19.9900, 1e+400 und -0 bleibt ebenso erhalten wie die ursprünglichen Zeichenketten-Escapes. So wird die Rundung vermieden, die beim Parsen und erneuten Serialisieren von Zahlen als JavaScript-Gleitkommawerte entsteht. Die Anwendung, die das Ergebnis liest, bestimmt weiterhin ihre eigene Zahlengenauigkeit.

Einrückung, LF- oder CRLF-Zeilenenden und ein abschließender Zeilenumbruch sind Ausgabekonventionen. Schlüssel sortieren ist eine gesonderte, optionale Änderung: Objektmitglieder werden rekursiv nach ihren dekodierten Namen sortiert, mit einem deterministischen Vergleich unter Beachtung der Groß- und Kleinschreibung. Die Array-Reihenfolge und die relative Reihenfolge doppelter Namen bleiben erhalten. Das dient der Lesbarkeit und dem Vergleich von Änderungen; es ist kein Kanonisierungsverfahren für kryptografische Signaturen.

{"name":"Ada","roles":["developer","reviewer"],"active":true}

{
  "name": "Ada",
  "roles": [
    "developer",
    "reviewer"
  ],
  "active": true
}