JSON a TypeScript
Convierta una muestra JSON normal en un alias de tipo TypeScript legible. Inspeccione los campos opcionales y las matrices mixtas, luego copie el código o guarde un archivo TypeScript. El resultado describe la estructura observada y necesita revisión; no valida datos futuros en tiempo de ejecución.
Generar un tipo desde JSON
- Pega un documento JSON o carga el ejemplo. Se aceptan objetos, arrays y valores primitivos en la raíz dentro de los límites. Se rechazan comentarios, comas finales, claves duplicadas tras decodificarlas y unidades sustitutas UTF-16 sin pareja.
- Elija un nombre de tipo raíz que comience con una letra mayúscula ASCII, seguida de letras, dígitos o guiones bajos, hasta 64 caracteres. Seleccione dos o cuatro espacios y escriba Generar.
- Revise los campos inferidos y la calificación de solo muestra. Copiar escribe solo el código actual; Descargar TypeScript guarda el mismo código UTF-8 que json-types.ts. La edición de una entrada borra el resultado anterior.
Cómo funciona la inferencia de muestras
Los valores primitivos se convierten en null, boolean, number o string. Las cadenas que parecen fechas, identificadores o números siguen siendo cadenas. Los tokens numéricos se clasifican sin convertirlos; number no garantiza precisión numérica en JavaScript.
Los objetos del mismo contexto se agrupan. Una clave es opcional cuando falta en al menos un objeto del grupo. Un null explícito es un valor: opcional y anulable son conceptos distintos. Los objetos vacíos también cuentan.
Los arrays combinan recursivamente los elementos observados, sin crear tuplas de longitud fija. Los arrays vacíos pueden usar elementos de arrays no vacíos del mismo contexto; si no hay elementos, el resultado es unknown[]. Las rutas de propiedades distintas no comparten datos.
El resultado es un alias de tipo exportado con tipos anidados en línea, claves entre comillas y formato estable. Un grupo de objetos sin claves utiliza una firma de índice de cadena con valor unknown, que es permisiva en lugar de estar exactamente vacía. No se aplica ninguna heurística de enumeración, discriminante, diccionario, fecha o UUID.
Ejemplos obligatorios, opcionales y que aceptan valores NULL
En el ejemplo, el primer objeto tiene id 1, label Ada y score null; el segundo tiene id 2 y score 4. id y score aparecen en ambos y son obligatorios. label aparece una vez y es opcional. score combina null y number.
Para un objeto cuyo campo left es una matriz vacía y el campo right contiene 1, left permanece unknown[] y right se convierte en number[]. Para dos matrices items correspondientes, una vacía y otra que contiene 1, su evidencia de elemento compartido produce number[].
Al combinar objetos con kind ok y value y objetos con kind error y message, kind pasa a ser una cadena y value y message son opcionales. Se pierde la relación original y se permiten combinaciones no observadas. Revisa estos casos si necesitas una unión discriminada.
Límites de inferencia y tamaño.
Una muestra no puede establecer todos los campos futuros, valores faltantes o variantes. Las declaraciones generadas son tipos en tiempo de compilación, no un validador en tiempo de ejecución, un esquema de objeto exacto o una prueba de que una respuesta API es correcta.
La entrada está limitada a 256 KiB de texto UTF-8, profundidad 32 y 20000 registros. Cada valor JSON cuenta una vez y cada miembro del objeto agrega dos registros más. La salida está limitada a 1 MiB, incluido el formato y su nueva línea final. Los límites rechazan toda la operación sin un resultado truncado.
Se permite un único BOM al inicio. Se rechazan los nombres duplicados tras decodificarlos y las unidades sustitutas UTF-16 sin pareja por interoperabilidad. Los tokens numéricos admiten hasta 1024 caracteres y un exponente de magnitud hasta 100000; no se infiere bigint ni se garantiza precisión numérica.
La herramienta acepta texto JSON y emite un alias de tipo. No importa archivos ni URL, no ejecuta muestras, no genera interfaces ni código de tiempo de ejecución, no infiere esquemas JSON, no traduce claves ni instala un compilador en su navegador. Revise las declaraciones en el proyecto TypeScript donde las utilizará.
Las muestras y el código permanecen en el flujo de trabajo de esta página.
La herramienta no envía la muestra a un servidor, guarda historial, crea enlaces con los datos ni añade telemetría con JSON, claves, nombres de tipo o código generado. La copia y la descarga solo se realizan a petición. Los servicios existentes del sitio, las extensiones y el uso posterior del código quedan fuera de esta descripción.
Preguntas de JSON a TypeScript
Fuentes y referencias
- rfc-editor.orgRFC 8259Sintaxis JSON e interoperabilidad.
- typescriptlang.orgTypeScript: Everyday TypesAlias, matrices y uniones de TypeScript.
- typescriptlang.orgTypeScript: Object TypesPropiedades de objetos y firmas de índice.
- typescriptlang.orgTypeScript: unknownEl tipo unknown para valores sin información observada.
- typescriptlang.orgTypeScript: Erased TypesLas declaraciones de tipo no proporcionan validación en tiempo de ejecución.
Fuentes revisadas el 2026-11-15. La agrupación, los nombres y los límites son decisiones de esta herramienta.
Herramientas relacionadas
JSON a YAML
Convierte JSON a YAML localmente, conservando el texto numérico y las cadenas entre comillas; copia o descarga el resultado completo.
Abrir herramienta — JSON a YAMLYAML a JSON
Convierte YAML a JSON localmente con números exactos, alias limitados y copia o descarga completa.
Abrir herramienta — YAML a JSONFormateador de YAML
Ajusta la sangría de YAML y copia el resultado comprobado conservando los comentarios y los detalles del original.
Abrir herramienta — Formateador de YAMLFormateador XML
Comprueba XML 1.0 con espacios de nombres, formatea o compacta localmente y copia o descarga el resultado en UTF-8.
Abrir herramienta — Formateador XMLFormateador y validador JSON
Comprueba la sintaxis JSON, formatea o minimiza localmente y copia o descarga el resultado conservando los datos originales.
Abrir herramienta — Formateador y validador JSON