JSON a mecanografiado

El convertidor de JSON a TypeScript lee un valor JSON de muestra (una respuesta API, un archivo de configuración, un registro de base de datos) y escribe las interfaces TypeScript que lo describen. Los objetos anidados se convierten en sus propias interfaces con nombre, las matrices de objetos se fusionan en una interfaz de un solo elemento en lugar de una unión en expansión, y las claves que son nulas o faltan en algunos registros se marcan como opcionales. Pegas datos que ya tienes; Obtienes tipos que de otro modo escribirías a mano.

Escribir una respuesta de API a mano es tedioso y propenso a errores de una manera específica: escribes lo que *crees* que devuelve el punto final, no lo que realmente devolvió. Los campos que nunca notó se omiten, un número entero que a veces es nulo se escribe como `número`, y el error aparece en el tiempo de ejecución en la producción en lugar de en su editor. Generar tipos directamente desde una carga útil real cierra esa brecha, porque la forma contra la que compilas es la forma en que el servidor envió.

Todo se ejecuta en su navegador. El motor de inferencia es TypeScript libre de dependencias, no un contenedor alrededor de un servicio remoto, por lo que las cargas útiles, que habitualmente transportan tokens de acceso, registros de clientes e ID internos, nunca salen de la página. Elija interfaces o escriba alias, alterne la palabra clave `export` y los modificadores `readonly`, elija el ancho de su sangría, luego copie la salida o descargue un archivo .ts.

Las interfaces generadas describen la muestra que proporcionó, no la API a la que llama, y esa distinción es todo el riesgo. Se requiere un campo que está presente en cada objeto de su muestra incluso si el servidor lo omite a veces, y un campo que es nulo en la muestra no se puede distinguir de uno que siempre es nulo. Las matrices vacías son el caso más claro: una matriz sin elementos no proporciona información sobre lo que contiene. La fusión de matrices ayuda aquí al combinar cada objeto de una lista en una interfaz y marcar las claves que faltan en algunas entradas como opcionales, por lo que una muestra más grande y variada produce un tipo más honesto. Cuando la API tiene un esquema o documento OpenAPI, genere a partir de eso y utilícelo para explorar una respuesta no documentada.