JSON in TypeScript umwandeln
Leiten Sie TypeScript-Deklarationen aus einer JSON-Stichprobe ab, einschließlich Vereinigungen, optionaler Eigenschaften und verschachtelter Objekte. Prüfen Sie den Code vor der Verwendung als API-Vertrag.
Entwicklertools
JSON in TypeScript umwandeln
Leiten Sie TypeScript-Deklarationen aus einer JSON-Stichprobe ab, einschließlich Vereinigungen, optionaler Eigenschaften und verschachtelter Objekte. Prüfen Sie den Code vor der Verwendung als API-Vertrag.
Höchstens 200 KiB UTF-8; maximal 50 Verschachtelungsebenen.
.ts
Bei Arrays oder primitiven Wurzelwerten erzeugt der interface-Modus einen Typalias.
Die Typen beschreiben nur die Stichprobe. Fehlende Eigenschaften werden optional; null bleibt explizit; leere Arrays verwenden unknown[]. Keine Datenprüfung zur Laufzeit.
02 / Anleitung
Über dieses Tool
So verwenden Sie dieses Werkzeug
Eingabe
Fügen Sie gültiges JSON ein oder laden Sie das synthetische Beispiel. Berücksichtigen Sie typische Varianten der zu beschreibenden Struktur.
Optionen
Geben Sie einen gültigen Wurzelnamen wie ApiResponse ein und wählen Sie interface oder type. Wurzeln ohne Objektstruktur verwenden einen Typalias.
Ergebnis
Klicken Sie auf Umwandeln, prüfen Sie optionale Eigenschaften und Vereinigungen und kopieren oder laden Sie die .ts-Datei herunter. Prüfen Sie sie mit Ihrem Compiler.
Durchgerechnetes Beispiel
Durchgerechnetes Beispiel · JSON in TypeScript umwandeln
Der zweite Datensatz enthält active, der erste nicht. Daher ist active optional. Beide beobachteten tag-Typen stehen in der Vereinigung.
Eingabe
[{"id":1,"tag":"x"},{"id":2,"tag":null,"active":true}]Ergebnis
export type ApiResponse = ({
active?: boolean;
id: number;
tag: null | string;
})[];Formate und Grenzen
- Grenzen
- Höchstens 200 KiB UTF-8; maximal 50 Verschachtelungsebenen.
- Optionen
- Beide beschreiben Objekte. Type erzeugt einen Alias, interface eine Schnittstelle für eine Objektwurzel. Arrays und primitive Wurzeln benötigen auch im interface-Modus einen Alias.
- Ergebnis
- Alle Objekte desselben Arrays werden verglichen. Fehlt eine Eigenschaft in einem davon, wird sie mit ? markiert. Ein null-Wert ist keine fehlende Eigenschaft.
Häufige Probleme
Was passiert mit null und leeren Arrays?
Null bleibt ein expliziter Typ und kann Teil einer Vereinigung sein. Ein leeres Array wird zu unknown[], weil keine Elemente zur Typableitung vorliegen.
Werden Daten zur Laufzeit geprüft?
Nein. TypeScript prüft Typen während der Entwicklung. Diese Deklarationen untersuchen keine künftigen API-Antworten. Ergänzen Sie bei Bedarf eine Laufzeitvalidierung.
Prüfen Sie das Ergebnis vor der Verwendung
Der zweite Datensatz enthält active, der erste nicht. Daher ist active optional. Beide beobachteten tag-Typen stehen in der Vereinigung.
Formate und Grenzen
Höchstens 200 KiB UTF-8; maximal 50 Verschachtelungsebenen. Verarbeitung im Browser. Daten werden weder hochgeladen noch gespeichert.
Häufig gestellte Fragen
Soll ich interface oder type wählen?
Beide beschreiben Objekte. Type erzeugt einen Alias, interface eine Schnittstelle für eine Objektwurzel. Arrays und primitive Wurzeln benötigen auch im interface-Modus einen Alias.
Wie werden optionale Eigenschaften erkannt?
Alle Objekte desselben Arrays werden verglichen. Fehlt eine Eigenschaft in einem davon, wird sie mit ? markiert. Ein null-Wert ist keine fehlende Eigenschaft.
Was passiert mit null und leeren Arrays?
Null bleibt ein expliziter Typ und kann Teil einer Vereinigung sein. Ein leeres Array wird zu unknown[], weil keine Elemente zur Typableitung vorliegen.
Werden Daten zur Laufzeit geprüft?
Nein. TypeScript prüft Typen während der Entwicklung. Diese Deklarationen untersuchen keine künftigen API-Antworten. Ergänzen Sie bei Bedarf eine Laufzeitvalidierung.
Was passiert bei einer unvollständigen Stichprobe?
Das Ergebnis kennt nur die vorhandenen Werte. Es entdeckt keine künftigen Felder, Geschäftsregeln, Datumswerte oder Aufzählungen. Nutzen Sie vielfältige Beispiele und prüfen Sie den tatsächlichen Vertrag.