JSON zu TypeScript

Der JSON-zu-TypeScript-Konverter liest einen Beispiel-JSON-Wert - eine API-Antwort, eine Konfigurationsdatei, einen Datenbankdatensatz - und schreibt die TypeScript-Schnittstellen, die ihn beschreiben Verschachtelte Objekte werden zu eigenen benannten Schnittstellen, Arrays von Objekten werden zu einer Einzelelementschnittstelle anstatt zu einer ausufernden Vereinigung zusammengeführt, und Schlüssel, die in einigen Datensätzen null sind oder fehlen, sind optional markiert Sie fügen Daten ein, die Sie bereits haben; Sie erhalten Typen, die Sie sonst handschreiben würden.

Das Eingeben einer API-Antwort von Hand ist auf eine bestimmte Weise mühsam und fehleranfällig: Sie geben ein, was Sie * denken *, der Endpunkt gibt zurück und nicht das, was es tatsächlich zurückgegeben hat. Felder, die Sie nie bemerkt haben, werden weggelassen, eine ganze Zahl, die manchmal als "Nummer" eingegeben wird, und der Fehler wird zur Laufzeit in der Produktion und nicht in Ihrem Editor angezeigt. Das Generieren von Typen direkt aus einer echten Nutzlast schließt diese Lücke, da die Form, gegen die Sie kompilieren, die Form ist, die der Server tatsächlich gesendet hat.

Alles läuft in Ihrem Browser Die Inferenz-Engine ist dependenzfreies TypeScript, kein Wrapper um einen Remote-Dienst, daher verlassen Nutzlasten - die routinemäßig Zugriffstoken, Kundendatensätze und interne IDs tragen - niemals die Seite Wählen Sie Schnittstellen oder geben Sie Aliase ein, schalten Sie das Schlüsselwort „`export` und die Modifikatoren „`only`" um, wählen Sie Ihre Einrückungsbreite aus, kopieren Sie dann die Ausgabe oder laden Sie eine „ts-Datei herunter.

Die generierten Schnittstellen beschreiben das von Ihnen bereitgestellte Sample, nicht die von Ihnen aufgerufene API, und diese Unterscheidung ist das ganze Risiko Ein Feld, das zufällig in jedem Objekt Ihrer Probe vorhanden ist, wird auch dann als erforderlich markiert, wenn der Server es manchmal weglässt, und ein Feld, das in der Stichprobe null ist, kann nicht von einem immer nullten Feld unterschieden werden Leere Arrays sind der klarste Fall: Ein Array ohne Elemente gibt keine Auskunft darüber, was es enthält Die Array-Zusammenführung hilft hier, indem jedes Objekt in einer Liste in einer Schnittstelle zusammengefasst und Schlüssel markiert werden, die in einigen Einträgen fehlen, als optional, so dass ein größeres und vielfältigeres Sample einen ehrlicheren Typ erzeugt. Wo die API-Dokument oder OpenAPI-Dokument hat, generieren Sie stattdessen daraus ein undokumentieren Sie dieses für die Untersuchung einer Antwort verwenden.