JSON-Schlüssel von camelCase in snake_case umwandeln

VeröffentlichtToolJSON Key Case Konverter

Inhalt
  1. In welchen Situationen dieses Problem auftritt
  2. Schreibweisen ohne Tool von Hand umwandeln
  3. Häufige Missverständnisse
  4. Fazit
  5. Häufig gestellte Fragen

Wenn Ihre API-Antwort in snake_case ankommt, Ihr Frontend-Code aber camelCase verwendet, müssen Sie die Schlüsselnamen nicht jedes Mal von Hand ändern. Es genügt, eine einzige Umwandlungsregel zu kennen.

camelCase, snake_case, PascalCase und kebab-case beruhen alle auf demselben Prinzip: Es wird festgelegt, wie man Wörter trennt und wieder zusammensetzt. In diesem Artikel erfahren Sie, wie Sie diese Regeln von Hand anwenden und welche Sonderfälle automatische Konverter häufig übersehen.

Zusammenfassung ① camelCase, snake_case, PascalCase und kebab-case sind unterschiedliche Schreibweisen für dieselben Daten – sie unterscheiden sich nur darin, wie Wörter getrennt werden. ② Bei der Umwandlung wird der Schlüssel anhand der Position von Großbuchstaben sowie von Unterstrichen und Bindestrichen in Wörter zerlegt und anschließend in der Zielschreibweise wieder zusammengesetzt. ③ Dieselbe Regel gilt rekursiv auch für Schlüssel in verschachtelten Objekten und Arrays – ohne Begrenzung der Verschachtelungstiefe.

In welchen Situationen dieses Problem auftritt

Das Problem entsteht, wenn die Konventionen unterschiedlicher Programmiersprachen und Frameworks über eine gemeinsame API aufeinandertreffen. Ist das Backend mit einem Python-Framework umgesetzt, liefert die Antwort-JSON die Schlüssel meist in snake_case (user_id, created_at).

Ist das Frontend dagegen in JavaScript oder TypeScript geschrieben, folgt der Code häufig der camelCase-Konvention (userId, createdAt).

Verwenden Sie die Antwort unverändert, steht in einer Datei plötzlich user_id neben userName. Bei wenigen Feldern lässt sich das mit einer von Hand geschriebenen Mapping-Funktion lösen. Bei Dutzenden Feldern mit verschachtelten Objekten und Arrays übersieht man aber leicht einen Schlüssel in einer tiefen Ebene.

Schreibweisen ohne Tool von Hand umwandeln

Alle vier Schreibweisen funktionieren nach demselben Prinzip: Sie zerlegen den Schlüsselnamen in „Wörter“ und setzen diese Wörter dann nach der jeweiligen Regel wieder zusammen.

Für die Zerlegung gibt es nur zwei Kriterien. Bei Schreibweisen ohne Trennzeichen wie camelCase und PascalCase beginnt ein neues Wort an jeder Stelle, an der ein Großbuchstabe steht. Bei Schreibweisen mit Trennzeichen wie snake_case und kebab-case wird an jedem Unterstrich (_) bzw. Bindestrich (-) getrennt.

Nach der Zerlegung setzen Sie die Wörter nach den folgenden Regeln wieder zusammen.

SchreibweiseRegel zum ZusammensetzenBeispiel (user, id)
camelCaseErstes Wort kleingeschrieben, bei allen weiteren Wörtern nur der erste Buchstabe groß, ohne TrennzeichenuserId
snake_caseAlle Wörter kleingeschrieben, verbunden mit Unterstrich (_)user_id
PascalCaseBei allen Wörtern der erste Buchstabe groß, ohne TrennzeichenUserId
kebab-caseAlle Wörter kleingeschrieben, verbunden mit Bindestrich (-)user-id

Verschachtelte Objekte und Arrays: dieselbe Regel

Angenommen, Sie wandeln { "user_id": 1, "profile": { "email_address": "a@test.com" } } in camelCase um. Dann wird user_id am Unterstrich zerlegt und zu userId. Auch email_address im verschachtelten Objekt profile wird nach derselben Regel zu emailAddress.

Wenn Sie nur die Schlüssel der obersten Ebene ändern und die inneren Objekte unverändert lassen, ist das Ergebnis nur zur Hälfte umgewandelt. Die Regel muss deshalb auf jeder Verschachtelungsebene erneut angewendet werden.

Auch bei Arrays bleibt die Regel gleich. Der Schlüssel des Arrays selbst, etwa order_list, wird zu orderList. Sind die Elemente des Arrays Objekte wie { order_id: 1 }, werden auch deren Schlüssel nach derselben Regel umgewandelt. Bestehen die Elemente aus Strings oder Zahlen (z. B. "tags": ["new", "sale"]), gibt es keine Schlüssel, die sich ändern ließen – die Werte bleiben unverändert.

Automatisierung mit regulären Ausdrücken

Wenn Sie diesen Vorgang programmatisch umsetzen, nehmen Sie in der Regel reguläre Ausdrücke. Eine Funktion für camelCase sucht den Kleinbuchstaben nach einem „-“ oder „_“, macht ihn zum Großbuchstaben und entfernt dabei das Trennzeichen – das gelingt mit einer einzigen Ersetzung.

Eine Funktion für snake_case oder kebab-case geht umgekehrt vor: Sie fügt vor jedem Großbuchstaben ein Trennzeichen ein und wandelt anschließend alles in Kleinbuchstaben um. PascalCase erhalten Sie, indem Sie im camelCase-Ergebnis nur den ersten Buchstaben großschreiben.

Bei wenigen Schlüsseln reicht es völlig, diese Regeln von Hand anzuwenden. Sind die Objekte jedoch tief verschachtelt und gibt es viele Schlüssel, übersieht man beim manuellen Ändern leicht einen Schlüssel an einer verschachtelten Stelle. Unser JSON Key Case Konverter übernimmt diese rekursive Anwendung automatisch.

Mit dem JSON Key Case Konverter ausprobieren.

JSON Key Case Konverter

Kostenlos nutzbar, ohne Anmeldung. Nach einem Klick auf „Konvertieren“ erscheint das Ergebnis sofort.

Häufige Missverständnisse

Die Regel selbst ist einfach. In echten Daten können aber einige Schlüsselformen dazu führen, dass das Ergebnis anders ausfällt als erwartet.

SituationErgebnis
Gemischte Bindestriche und Unterstriche (user-id_name)Beide Trennzeichen werden als Wortgrenze erkannt und bei der Umwandlung in camelCase korrekt zu userIdName zusammengesetzt
Schlüssel, der bereits mit einem Großbuchstaben beginnt (UserId)Weil bei der Umwandlung in snake_case oder kebab-case vor jedem Großbuchstaben ein Trennzeichen eingefügt wird, kann auch vor dem ersten Buchstaben ein Trennzeichen stehen bleiben, etwa _user_id oder -user-id
Wert (Value) ist String, Zahl, Boolean oder nullNur Schlüssel werden umgewandelt; der Inhalt der Werte bleibt unverändert
Ungültige JSON-SyntaxEs erfolgt keine Umwandlung; stattdessen wird die von JSON.parse ausgelöste Fehlermeldung unverändert angezeigt

Schlüssel mit gemischten Trennzeichen oder Großbuchstaben am Anfang

Auch wenn Bindestrich und Unterstrich in einem Schlüssel gemischt vorkommen (user-id_name), müssen Sie sich keine Sorgen machen. Beide Trennzeichen werden als „Beginn eines neuen Wortes“ erkannt, sodass die Umwandlung in camelCase korrekt userIdName ergibt.

Beginnt der ursprüngliche Schlüssel dagegen bereits mit einem Großbuchstaben, wie bei PascalCase (UserId), sollten Sie das Ergebnis genauer prüfen. Die Regel für snake_case und kebab-case fügt „vor jedem Großbuchstaben ein Trennzeichen ein“. Ist schon der erste Buchstabe ein Großbuchstabe, wird auch dort ein Trennzeichen eingefügt, sodass es am Anfang des Ergebnisses stehen bleiben kann.

Sehen Sie am Anfang des Ergebnisses ein Trennzeichen, ist das ein Hinweis darauf, dass der ursprüngliche Schlüssel mit einem Großbuchstaben begann.

Werte (Values) und JSON-Syntaxfehler

Werte (Values) werden nicht umgewandelt. Strings, Zahlen, Booleans und null bleiben unabhängig von der Schreibweise unverändert. Steht in einem Wert zufällig ein String wie user_id, bleibt auch dieser String unverändert.

Ist die JSON-Syntax fehlerhaft, erscheint statt der Umwandlung die Fehlermeldung des Parsers. Typische Ursachen sind nicht zusammenpassende eckige oder geschweifte Klammern, Schlüssel ohne doppelte Anführungszeichen, ein Komma nach dem letzten Eintrag (Trailing Comma) oder einfache statt doppelter Anführungszeichen.

Die Zahl nach „position“ in der Fehlermeldung gibt an, bei welchem Zeichen das Problem auftritt – gezählt ab dem Anfang des Strings, einschließlich Leerzeichen. Prüfen Sie die Stelle und ihre Umgebung, um die Ursache einzugrenzen.

Fazit

  • camelCase, snake_case, PascalCase und kebab-case sind Schreibweisen für dieselben Daten; sie unterscheiden sich nur in der Regel, nach der Wörter getrennt und wieder zusammengesetzt werden.
  • Maßgeblich für die Zerlegung in Wörter sind die Stellen, an denen Großbuchstaben beginnen, sowie die Positionen von Unterstrichen und Bindestrichen.
  • Dieselbe Regel muss auch auf Schlüssel in verschachtelten Objekten und Arrays ohne Begrenzung der Verschachtelungstiefe immer wieder angewendet werden, damit wirklich alle Schlüssel umgewandelt werden.
  • Beginnt der ursprüngliche Schlüssel mit einem Großbuchstaben, kann bei der Umwandlung in snake_case oder kebab-case am Anfang des Ergebnisses ein Trennzeichen stehen bleiben.
  • Der Inhalt von Werten (Values) wird nicht umgewandelt, und bei ungültiger JSON-Syntax wird die Fehlermeldung des Parsers unverändert angezeigt.
JSON Key Case Konverter

Kostenlos nutzbar, ohne Anmeldung. Nach einem Klick auf „Konvertieren“ erscheint das Ergebnis sofort.

Häufig gestellte Fragen

Werden auch Schlüssel in verschachtelten Objekten oder Arrays konvertiert?

Ja. Ob ein Objekt weitere Objekte enthält oder ein Array Objekte beinhaltet: Der JSON Key Case Konverter durchsucht alle Ebenen rekursiv, ohne Begrenzung der Verschachtelungstiefe, und wandelt jeden Schlüssel nach derselben Regel um.

Ändert sich das Ergebnis automatisch, wenn ich das JSON im Eingabefeld bearbeite?

Nein. Die Konvertierung wird einmalig ausgeführt, wenn Sie auf „Konvertieren“ klicken, und zwar mit der Eingabe zu diesem Zeitpunkt. Nachdem Sie die Eingabe korrigiert haben, müssen Sie erneut auf die Schaltfläche klicken, um ein neues Ergebnis zu erhalten.

Wird auch der Text innerhalb von Werten (Values) umgewandelt, nicht nur die Schlüsselnamen?

Nein. Umgewandelt werden ausschließlich die Schlüsselnamen. Werte wie Strings, Zahlen, Booleans und null bleiben unverändert.

Es erscheint ein JSON-Syntaxfehler: was ist das Problem?

In diesem Fall hält sich die eingegebene Zeichenfolge nicht an die Syntax, die JSON.parse verlangt. Häufige Ursachen sind ein Komma nach dem letzten Eintrag (Trailing Comma), einfache Anführungszeichen oder Schlüssel ohne doppelte Anführungszeichen. Anhand der Positionsangabe (position) in der angezeigten Fehlermeldung sehen Sie, an welchem Zeichen das Problem auftritt.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. JSON-Schlüssel löschen: Mehrere Eigenschaften rekursiv entfernenSo entfernen Sie mehrere JSON-Schlüssel per Komma-Liste rekursiv in einem Schritt – inklusive Groß-/Kleinschreibung, exakter Übereinstimmung und ungültigem JSON.
  2. JSON Schlüssel sortieren: Was die Sortierung tatsächlich ändertJSON-Schlüssel alphabetisch sortieren: Die Reihenfolge im Array bleibt erhalten. Beispiele zeigen, wie rekursive Option und Einrückung das Ergebnis beeinflussen.
  3. JavaScript-Objekt in JSON umwandeln: Fehlerursachen und LösungWarum JSON.parse bei kopierten JS-Objekten „Unexpected token“ meldet, was JSON-Syntax von Objektliteralen unterscheidet und wie Sie in der Konsole konvertieren.
  4. JSON-Schema erstellen: So werden Typen erkannt (Draft-07)Wie aus einem JSON-Beispiel ein Draft-07-Schema entsteht: Typerkennung bei Strings, Zahlen und Arrays, required und anyOf erklärt, plus Grenzen eines Beispiels.
  5. JSON Syntaxfehler: Ursachen anhand der Fehlermeldung findenWas die Position in JSON-Fehlermeldungen bedeutet und wie Sie typische Syntaxfehler wie Trailing Comma, einfache Anführungszeichen und Kommentare erkennen.
  6. JSON in TypeScript umwandeln: ? und | in Interfaces lesenWann steht in einem aus JSON erzeugten TypeScript-Interface ein Fragezeichen (optional) oder ein Union-Typ mit |? Die Regeln, gezeigt an einem JSON-Beispiel.

Passende Tools