JSON zu TypeScript
Verwandeln Sie ein gewöhnliches JSON-Beispiel in einen lesbaren TypeScript-Typalias. Untersuchen Sie optionale Felder und gemischte Arrays und kopieren Sie dann den Code oder speichern Sie eine TypeScript-Datei. Das Ergebnis beschreibt die beobachtete Struktur und erfordert eine Überprüfung; zukünftige Daten werden zur Laufzeit nicht validiert.
Generieren Sie einen Typ aus JSON
- Fügen Sie ein JSON-Dokument ein oder laden Sie das Beispiel. Objekte, Arrays und primitive Werte an der Wurzel sind innerhalb der Grenzen zulässig. Kommentare, abschließende Kommas, nach der Dekodierung doppelte Schlüssel und ungepaarte UTF-16-Surrogate werden abgelehnt.
- Wählen Sie einen Stammtypnamen, der mit einem ASCII-Großbuchstaben beginnt, gefolgt von Buchstaben, Ziffern oder Unterstrichen (bis zu 64 Zeichen). Wählen Sie zwei oder vier Leerzeichen aus und generieren Sie den Typ.
- Überprüfen Sie die abgeleiteten Felder und die Nur-Beispiel-Qualifikation. Copy schreibt nur den aktuellen Code; Beim Herunterladen von TypeScript wird derselbe UTF-8-Code wie json-types.ts gespeichert. Durch Bearbeiten einer Eingabe wird das alte Ergebnis gelöscht.
So funktioniert die Stichprobeninferenz
Primitive Werte werden zu null, boolean, number oder string. Zeichenfolgen, die wie Datumsangaben, Kennungen oder Zahlen aussehen, bleiben Zeichenfolgen. Zahlentoken werden ohne Umwandlung eingeordnet; number garantiert keine numerische Genauigkeit in JavaScript.
Objekte im selben Kontext werden zusammengeführt. Ein Schlüssel ist optional, wenn er in mindestens einem Objekt der Gruppe fehlt. Ein explizites null ist ein Wert; optional und nullable sind unterschiedliche Eigenschaften. Leere Objekte zählen ebenfalls.
Arrays fassen beobachtete Elemente rekursiv zusammen, statt Tupel fester Länge zu bilden. Leere Arrays können Elemente nicht leerer Arrays im selben Kontext nutzen; ohne Elemente entsteht unknown[]. Verschiedene Eigenschaftspfade teilen keine Daten.
Das Ergebnis ist ein exportierter Typalias mit inline verschachtelten Typen, Schlüsseln in Anführungszeichen und stabiler Formatierung. Ein Objektpool ohne Schlüssel verwendet eine Zeichenfolgenindexsignatur mit dem Wert unknown, die eher zulässig als exakt leer ist. Es wird keine Enum-, Diskriminanz-, Wörterbuch-, Datums- oder UUID-Heuristik angewendet.
Erforderliche, optionale und nullfähige Beispiele
Im Beispiel enthält das erste Objekt id 1, label Ada und score null; das zweite enthält id 2 und score 4. id und score kommen in beiden Objekten vor und sind erforderlich. label kommt einmal vor und wird optional. score kombiniert null und number.
Für ein Objekt, dessen left-Feld ein leeres Array ist und dessen right-Feld 1 enthält, bleibt left unknown[] und right wird zu number[]. Für zwei entsprechende items-Arrays, eines leer und eines mit 1, erzeugt ihr gemeinsamer Elementnachweis stattdessen number[] .
Beim Zusammenführen von Objekten mit kind ok und value sowie Objekten mit kind error und message wird kind zu einer Zeichenfolge; value und message werden optional. Die ursprüngliche Beziehung geht verloren, sodass nicht beobachtete Kombinationen möglich sind. Prüfen Sie solche Fälle, wenn Sie eine diskriminierte Union benötigen.
Schlussfolgerungen und Größenbeschränkungen
Eine Stichprobe kann nicht jedes zukünftige Feld, jeden fehlenden Wert oder jede Variante ermitteln. Generierte Deklarationen sind Kompilierzeittypen, kein Laufzeitvalidator, kein genaues Objektschema oder ein Beweis dafür, dass eine API-Antwort korrekt ist.
Die Eingabe ist auf 256 KiB UTF-8-Text, Tiefe 32 und 20.000 Datensätze beschränkt. Jeder JSON-Wert zählt einmal und jedes Objektmitglied fügt zwei weitere Datensätze hinzu. Die Ausgabe ist auf 1 MiB einschließlich Formatierung und abschließender Zeilenumbruch begrenzt. Grenzwerte lehnen die gesamte Operation ohne abgeschnittenes Ergebnis ab.
Ein einzelnes BOM am Anfang ist zulässig. Nach der Dekodierung doppelte Namen und ungepaarte UTF-16-Surrogate werden aus Interoperabilitätsgründen abgelehnt. Zahlentoken dürfen höchstens 1024 Zeichen und einen Exponenten mit einem Betrag bis 100000 haben; bigint und numerische Genauigkeit werden nicht abgeleitet.
Das Tool akzeptiert JSON-Text und gibt einen Typalias aus. Es importiert keine Dateien oder URLs, führt keine Beispiele aus, generiert keine Schnittstellen oder Laufzeitcode, leitet kein JSON-Schema ab, übersetzt keine Schlüssel und installiert keinen Compiler in Ihrem Browser. Überprüfen Sie die Deklarationen im TypeScript-Projekt, in dem Sie sie verwenden werden.
Beispiele und Code bleiben im Workflow dieser Seite
Das Tool lädt das Beispiel nicht auf einen Server hoch, speichert keinen Verlauf, erstellt keinen Link mit Eingaben und ergänzt keine Telemetrie mit JSON, Schlüsseln, Typnamen oder erzeugtem Code. Kopieren und Download erfolgen auf Wunsch. Bestehende Website-Dienste, Erweiterungen und die spätere Nutzung des Codes sind von dieser Beschreibung nicht umfasst.
Fragen zu JSON zu TypeScript
Quellen und Referenzen
- rfc-editor.orgRFC 8259JSON-Syntax und Interoperabilität.
- typescriptlang.orgTypeScript: Everyday TypesTypeScript-Aliase, Arrays und Unions.
- typescriptlang.orgTypeScript: Object TypesObjekteigenschaften und Indexsignaturen.
- typescriptlang.orgTypeScript: unknownDer Typ unknown für Werte ohne beobachtete Daten.
- typescriptlang.orgTypeScript: Erased TypesTypdeklarationen bieten keine Laufzeitvalidierung.
Quellen geprüft am 2026-11-15. Zusammenführung, Namen und Grenzen sind Vorgaben dieses Werkzeugs.
Ähnliche Werkzeuge
JSON in YAML
Konvertiere JSON lokal in YAML und bewahre Zahlentext und Zeichenfolgen in Anführungszeichen; kopiere oder lade das vollständige Ergebnis herunter.
Werkzeug öffnen — JSON in YAMLYAML in JSON
Konvertiere YAML lokal in JSON mit exakten Zahlen, begrenzten Aliasen und vollständigem Kopieren oder Download.
Werkzeug öffnen — YAML in JSONYAML-Formatierer
YAML-Einrückung vereinheitlichen und das geprüfte Ergebnis mit Kommentaren und Details des Quelltexts kopieren.
Werkzeug öffnen — YAML-FormatiererXML-Formatierer
XML 1.0 mit Namensräumen prüfen, lokal formatieren oder kompaktieren und das UTF-8-Ergebnis kopieren oder herunterladen.
Werkzeug öffnen — XML-FormatiererJSON-Formatierer und -Validator
JSON-Syntax lokal prüfen, formatieren oder minimieren und das Ergebnis unter Erhalt der ursprünglichen Daten kopieren oder herunterladen.
Werkzeug öffnen — JSON-Formatierer und -Validator