Entrada YAML

Salida TypeScript

¿Qué es YAML a TypeScript?

Estás cargando un archivo de config YAML en Node.js — tal vez un config.yml, un manifiesto de Kubernetes, o un workflow de GitHub Actions — y tienes tipos any por todas partes. Escribir interfaces TypeScript manualmente para YAML profundamente anidado es lento y propenso a errores. Esta herramienta lee tu documento YAML 1.2 y genera interfaces TypeScript que puedes usar directamente con js-yaml o el paquete npm yaml.

La generación se ejecuta completamente en tu navegador — nada se envía a un servidor. Los tipos generados funcionan con cualquier proyecto TypeScript. Para JSON a TypeScript, usa JSON a TypeScript.

Ejemplos YAML a TypeScript

Genera interfaces TypeScript desde YAML. Ejemplo temático de telecomunicaciones:

Ejemplo: Registro de suscriptor

Entrada YAML

Salida TypeScript:

Salida TypeScript

Haz clic en el botón Ejemplo de arriba para cargar más ejemplos en el editor.

Cómo usar esta herramienta

1

Pegar o subir YAML

Copia tu YAML y pégalo en el editor izquierdo. También puedes hacer clic en Subir para cargar un archivo .yaml o .yml. El botón Ejemplo carga datos de ejemplo. Un YAML inválido mostrará un error.

2

Revisar salida TypeScript

El panel derecho muestra las interfaces TypeScript generadas. Úsalas con js-yaml o el paquete yaml para parsear y tipar tu config. Ajusta los campos opcionales usando ? o tipos union según necesites.

3

Copiar o descargar

Usa Copiar o Descargar. Para JSON a TypeScript, usa JSON a TypeScript. Para formatear YAML, usa Formateador YAML.

Cuándo ayuda YAML a TypeScript

Al construir apps Node.js o frontend que cargan config YAML (ej. config.yml, manifiestos Kubernetes o workflows CI), necesitas estructuras tipadas para los datos parseados. Pegar un ejemplo aquí te da interfaces TypeScript que puedes usar con js-yaml o el paquete yaml. Escribir tipos manualmente para YAML anidado complejo es tedioso; esta herramienta infiere la estructura desde tu ejemplo.

Los archivos de config como application.yml o los workflows de GitHub Actions a menudo tienen anidamiento profundo. Los tipos generados ayudan a detectar errores tipográficos y proporcionan autocompletado en tu IDE. Para extraer valores específicos de YAML grande, convierte primero a JSON y usa jq.

Preguntas frecuentes

¿Cómo uso los tipos TypeScript generados para parsear YAML?

Instala js-yaml o el paquete npm yaml. Luego: const config = yaml.parse(str) as MyConfig. Para validación en tiempo de ejecución, agrega Zod o io-ts.

¿Cuál es la diferencia entre js-yaml y el paquete yaml?

js-yaml es ampliamente usado y bien probado. El paquete yaml tiene mejor preservación de comentarios y cumplimiento más estricto de YAML 1.2. Ambos funcionan con las interfaces generadas.

¿Son privados mis datos YAML al generar TypeScript?

Sí. La generación se ejecuta completamente en tu navegador. No se envía YAML ni código a ningún servidor.

¿Cómo manejo campos opcionales vs requeridos en las interfaces YAML?

El generador infiere desde tus datos de ejemplo. Agrega ? a las propiedades de interfaz para campos que pueden no estar siempre presentes. Para validación estricta en tiempo de ejecución, usa Zod.

¿Puedo usar los tipos TypeScript generados con Angular o React?

Sí. Las interfaces generadas funcionan en cualquier proyecto TypeScript — servicios Angular, hooks React, o scripts Node.js. Carga tu YAML en tiempo de compilación o ejecución y castéalo a la interfaz generada.

Herramientas relacionadas

Documentación TypeScript. Especificación YAML. js-yaml. Especificación JSON. MDN.