JSON‑zu‑TypeScript‑Generator

JSON Eingabe

Editor wird geladen…

Generierter TypeScript

Configuration

TypeScript‑Generierungsoptionen

Interfaces statt Typ‑Aliase erzeugen

Properties als optional markieren, wenn sie undefined sein könnten

Fügen Sie JSON hinzu, um TypeScript‑Typen zu generieren

Erzeugt Interfaces, Typen und stark typisierte Objekte

So konvertieren Sie JSON in TypeScript – Schritt-für-Schritt-Anleitung

Verwenden Sie diesen JSON-zu-TypeScript-Generator, um typsichere Schnittstellen und Typen aus JSON-Beispielen für Frontend-Apps und Node.js-Dienste zu erstellen.

  1. Schritt 1 – Fügen Sie ein JSON-Beispiel ein

    • Fügen Sie ein repräsentatives JSON-Objekt oder -Array in den linken Editor ein.
    • Schließen Sie verschachtelte Objekte, Arrays und Nullable-Felder ein, damit Typen korrekt abgeleitet werden.
    • Verwenden Sie Import, um JSON aus einer Datei, URL oder Beispieldaten zu laden.
  2. Schritt 2 – Wählen Sie die Optionen für die TypeScript-Generierung

    • Legen Sie einen Root Type Name fest, der Ihrem Modell entspricht (zum Beispiel Root).
    • Wählen Sie eine Null-Handhabungsstrategie (Optional (?) vs. Union (| null)), die zu Ihrer Codebasis passt.
    • Entscheiden Sie, ob Sie die Aliase interfaces oder type für die Ausgabe verwenden möchten.
  3. Schritt 3 – Überprüfen Sie den generierten Code

    • Überprüfen Sie Feldnamen, Typen und die Modellierung von Arrays/Objekten.
    • Passen Sie Optionen wie Root Type Name, Nullbehandlung und Frameworks an, falls verfügbar.
    • Wenn ein Feld falsch abgeleitet wird, optimieren Sie Ihren Beispiel-JSON und generieren Sie ihn neu.
  4. Schritt 4 – Verwenden Sie die generierten Typen

    • Fügen Sie die Ausgabe in Ihr Projekt ein und exportieren Sie sie aus Ihrem Typenmodul.
    • Verwenden Sie die Typen für API-Antworten, DTOs und Laufzeit-Parsing-Grenzen.
    • Führen Sie eine Neugenerierung durch, wenn sich Ihre JSON-Nutzlast ändert, um die Clients synchron zu halten.
  5. Schritt 5 – Kopieren oder Herunterladen

    • Kopieren Sie die Ausgabe in Ihr Projekt oder laden Sie sie als Datei herunter.
    • Führen Sie Ihren Formatierer/Linter entsprechend Ihrem Codestil aus.
    • Fügen Sie JSON-Parsing-/Serialisierungsbibliotheken hinzu, wenn Ihre Sprache dies erfordert.

Schnelle Tipps

  • Bevorzugen Sie unknown für wirklich untypisierte Felder und grenzen Sie sie dann bei der Validierung ein.
  • Wenn die API inkonsistent ist, sollten Sie erwägen, ein JSON-Schema zu generieren und zur Laufzeit zu validieren.
  • Halten Sie die generierten Dateien getrennt, damit sie bei Updates leicht ersetzt werden können.
Beispielausgabe (vereinfacht)
// JSON-Eingabe
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// Generated TypeScript types (simplified)
export interface Metadata {
  plan: string;
}

export interface Root {
  id: number;
  name: string;
  email: string | null;
  active: boolean;
  roles: string[];
  metadata: Metadata;
  createdAt: string;
  score: number;
  notes: null;
}

Verwandte JSON- und TypeScript-Tools

Entdecken Sie weitere JSON- und Schema-Tools, die zusammen mit diesem JSON-zu-TypeScript-Generator hervorragend funktionieren.

Häufig gestellte Fragen

Welche TypeScript‑Features werden im generierten Code unterstützt?

Der Generator erstellt TypeScript‑Interfaces, ‑Typen und Klassen mit voller Typsicherheit. Er unterstützt optionale Properties, Union Types, verschachtelte Interfaces, Array‑Typen und korrektes Null‑Handling. Der Code ist mit aktuellen TypeScript‑Standards kompatibel.

Wie werden komplexe verschachtelte JSON‑Strukturen behandelt?

Komplexe verschachtelte Objekte werden in separate TypeScript‑Interfaces mit passenden Typ‑Beziehungen umgewandelt. Arrays werden korrekt typisiert, und es entsteht eine Typ‑Hierarchie, die Ihrer JSON‑Struktur entspricht – bei voller Typsicherheit.

Kann ich Null- und Undefined‑Handling anpassen?

Ja. Sie können zwischen verschiedenen Strategien wählen: optionale Properties mit '?', Union Types mit '| null' oder das vollständige Ignorieren von null‑Werten. So entscheiden Sie, wie strikt Ihre Typen sein sollen.

Ist der generierte TypeScript‑Code produktionsreif?

Ja! Der Code folgt TypeScript‑Best Practices, enthält passende Exports und kann direkt in TypeScript‑Projekte importiert werden. Die Interfaces sind wartbar und folgen gängigen Namenskonventionen.

JSON‑zu‑TypeScript‑Generator | JSONSwiss