YamlBox

Codegeneratoren

JSON bis TypeScript Generator

Fügen Sie eine JSON-Antwort ein und geben Sie TypeScript ein, bereit zum Einfügen. Array-Elemente werden zusammengeführt, sodass optionale Felder erkannt werden, verschachtelte Objekte zu benannten Schnittstellen werden und gemischte Typen zu ehrlichen Vereinigungen werden.

Konvertierungsoptionen

JSON Probe

Beispiele: Benutzerobjekt · Liste mit optionalen Feldern —⌘/Strg + Eingabetaste konvertiert · legt eine Datei ab, um sie zu laden · lokal verarbeitet

TypeScript

Die Ausgabe ist schreibgeschützt. Verwenden Sie Kopieren, Herunterladen oder Teilen, um es zu verschieben.

So verwenden Sie das JSON bis TypeScript-Tool

  1. Fügen Sie eine echte Antwort ein

    Verwenden Sie eine Nutzlast, die die optionalen und Nullable-Felder enthält, die Sie tatsächlich in der Produktion sehen – je repräsentativer, desto besser die abgeleiteten Typen.

  2. Benennen Sie Ihren Root-Typ

    Geben Sie dem Stammtyp den Namen, den er in Ihrer Codebasis hat (Benutzer, Bestellung, ApiResponse), und wählen Sie Schnittstellen oder Typaliase aus, die Ihrem Styleguide entsprechen.

  3. Kopieren Sie es in Ihr Projekt

    Fügen Sie das Ergebnis in Ihre Typendatei ein. Koppeln Sie es zur Laufzeitvalidierung mit einem JSON-Schema oder einem Laufzeitvalidator wie Zod.

Was macht dieses Tool anders?

  • Führt Array-Elementformen zusammen und markiert nicht-universelle Schlüssel als optional
  • Unions für gemischte Typen (Zeichenfolge | Zahl, Zeichenfolge | Null) anstelle von stillen beliebigen
  • Verschachtelte Objekte, benannt nach ihrem Schlüsselpfad (Adresse, Beweis, …)
  • Schnittstellen- oder Typ-Alias-Ausgabe mit einem benutzerdefinierten Stammnamen
  • Optionale ISO-Datumserkennung zur Kennzeichnung von Zeitstempelfeldern

Datenschutz durch Architektur: Diese Seite enthält keine Analysen, die Ihre Eingaben empfangen, und der Konvertierungscode wird in Ihrem Tab ausgeführt. Nach dem Laden können Sie die Verbindung zum Netzwerk trennen und weiterarbeiten.

JSON bis TypeScript – häufig gestellte Fragen

Wie werden optionale Felder erkannt?

Wenn es sich bei der Eingabe um ein Array von Objekten handelt, wird jede Eigenschaft für jedes Element überprüft. Fehlt bei manchen Artikeln ein Schlüssel, wird er mit einem „?“ als „optional“ gekennzeichnet. Überall vorhandene Schlüssel bleiben erforderlich.

Wie werden Nullable-Felder zu Typen?

Ein Nullwert wird als eigener Typ behandelt, sodass ein Feld, das manchmal eine Zeichenfolge und manchmal Null ist, den Typ string | hat null – ein ehrlicher Typ und keine Lüge, der Ihr Compiler vertraut.

Schnittstellen oder Typaliase – welche soll ich wählen?

Schnittstellen sind die gebräuchlichere Konvention und lassen sich gut in Deklarationen integrieren. Typaliase sind für Vereinigungen und Schnittmengen besser lesbar. Funktionell funktioniert für generierte Datenformen beides – passen Sie es an Ihre vorhandene Codebasis an.

Kann es Zod oder andere Laufzeitschemata generieren?

Nicht direkt. Generieren Sie das JSON-Schema aus derselben Nutzlast und leiten Sie einen Validator ab, oder schreiben Sie das Zod-Schema manuell und verwenden Sie diese Schnittstellen für die statische Seite. Typen beschreiben die Form zur Kompilierungszeit; Validatoren schützen Sie zur Laufzeit.

Funktioniert dies für große API-Antworten?

Ja. Fügen Sie die JSON-Datei ein oder löschen Sie sie – die Verschachtelung wird rekursiv abgeleitet. Sehr große Nutzlasten werden eher durch den Browserspeicher als durch den Generator selbst begrenzt.

Auf der Suche nach “json zu ts”, “json zur Schnittstelle”, “Quicktype-Alternative”? Hier sind Sie richtig – Durchsuchen Sie alle 19 Tools.

Tiefergehende Lektüre

Blogartikel · 6 Minuten Lesezeit JSON bis TypeScript: Typen, die der Realität entsprechen Konvertieren Sie JSON- in TypeScript-Schnittstellen aus einer echten API-Antwort – optionale Schlüssel, Null-Unions, verschachtelte Typen – und verhindern Sie, dass generierte Typen driften. Lesen Sie die Anleitung →