Zum Hauptinhalt springen

JSON

Überblick

JSON (JavaScript Object Notation) ist ein leichtgewichtiges, textbasiertes Datenformat, das Anfang der 2000er von Douglas Crockford eingeführt wurde. Es leitet sich von der Objekt-Literal-Syntax von JavaScript ab, ist aber sprachunabhängig. Heute ist JSON das am weitesten verbreitete Format für den Datenaustausch zwischen Web-Clients und Servern, Konfigurationsdateien und APIs.

Dateibenennung

Antwort: kebab-case

user-data.json
api-config.json
database-schema.json

Warum kebab-case?

  • Plattformübergreifend sicher: Keine Probleme mit Dateisystemen, die nicht zwischen Groß- und Kleinschreibung unterscheiden (Windows/macOS)
  • Bessere Lesbarkeit in Dateilisten und Explorern
  • URL-freundlich: Funktioniert ohne Encoding, wenn Dateien über HTTP bereitgestellt werden

Schlüsselbenennung

Antwort: camelCase

{
"userId": 123,
"firstName": "Alice",
"isActive": true
}

Warum camelCase?

  • Standard im JavaScript-/TypeScript-Ökosystem, aus dem JSON stammt
  • Die JSON-Spezifikation selbst schreibt keinen Schlüsselstil vor
  • Die meisten öffentlichen Web-APIs (Google, GitHub, Stripe) verwenden camelCase

Hinweis

snake_case ist in Python-orientierten APIs üblich (z.B. Django REST Framework, FastAPI). Einen Stil wählen und im Projekt konsistent bleiben.

JSON vs. JSONC vs. JSON5

MerkmalJSONJSONCJSON5
KommentareNein// und /* */// und /* */
Trailing CommasNeinJaJa
Schlüssel ohne AnführungszeichenNeinNeinJa
Einfache AnführungszeichenNeinNeinJa
Typische VerwendungDatenaustausch, APIsKonfigurationsdateien (VS Code, TypeScript)Konfigurationsdateien, manuell bearbeitete Daten