ToolsOps

Herramientas JSON y YAML

Validación, conversión y errores frecuentes — todo en el navegador.

Para qué sirve esta colección

JSON y YAML son los formatos por defecto del trabajo moderno con APIs, contenedores y orquestación. Los manifiestos de Kubernetes, los workflows de GitHub Actions, los ficheros docker-compose y la mayoría de configuraciones de aplicaciones viven en uno u otro. Aunque parecen intercambiables, los detalles importan: una coma de más, una indentación incorrecta o una clave duplicada pueden bloquear un deploy entero.

Esta colección agrupa las dos calculadoras que ToolsOps publica hoy para ese trabajo cotidiano: un validador JSON con formato y minify, y un conversor bidireccional YAML ↔ JSON. Ambas se ejecutan completamente en tu navegador. No subimos tu input a ningún servidor, no lo almacenamos y no lo enviamos a terceros: ese es el contrato.

Si lo que necesitas es entender por qué un parser rechaza tu fichero, la sección de errores comunes más abajo cubre los siete fallos más frecuentes. Si quieres profundidad técnica (anchors YAML, big numbers, JSON Schema, validación previa a deploy), la guía editorial enlazada al final completa el cuadro.

JSON frente a YAML

Decisiones rápidas: para qué sirve cada formato y dónde se rompen.
AspectoJSONYAML
FormatoTexto estricto con llaves y corchetesTexto basado en indentación, más legible
Mejor paraAPIs HTTP, payloads programáticos, intercambio entre serviciosConfiguración editada por humanos: Compose, Kubernetes, GitHub Actions
Permite comentariosNoSí, con #
Riesgos frecuentesTrailing commas, claves sin comillas, pérdida de precisión en enteros muy grandesIndentación inconsistente, booleanos implícitos en YAML 1.1 (yes/no/on/off), anchors/aliases poco intuitivos
Herramienta recomendadaJSON validatorYAML ↔ JSON converter

Herramientas de la colección

Las dos utilidades publicadas hoy. Ambas funcionan offline tras la primera carga porque no dependen de ningún backend ni de servicios externos.

Errores comunes y cómo corregirlos

Los siete fallos que más bloquean un deploy o un PR. Pega el caso en la herramienta correspondiente para verificarlo al instante.

  • Coma final (trailing comma) en JSON

    Síntoma: El parser lanza «Unexpected token ]» o «Unexpected token }». La especificación JSON estricta no permite una coma después del último elemento.

    Cómo corregirlo: Elimina la coma sobrante. Si necesitas comas finales por cuestiones de diffs limpios, considera JSON5 o cambia el fichero a YAML, que sí las permite.

  • Comentarios en JSON

    Síntoma: Líneas con // o /* */ producen error de parseo. JSON estándar no soporta comentarios, aunque algunos parsers permisivos los toleren.

    Cómo corregirlo: Extrae el comentario a un campo dedicado ("_comment": "…") o cambia a YAML, que admite # de forma nativa.

  • Claves sin comillas

    Síntoma: { name: "Ana" } falla porque las claves JSON deben ir entre comillas dobles. El error suele ser «Unexpected token n» o similar.

    Cómo corregirlo: Envuelve todas las claves entre comillas dobles: { "name": "Ana" }. No uses comillas simples.

  • Claves duplicadas

    Síntoma: El parser acepta el fichero pero solo conserva el último valor de cada clave duplicada. El bug es silencioso y reaparece como datos perdidos en producción.

    Cómo corregirlo: Renombra o consolida las claves. JSON.parse conserva la última ocurrencia, así que valida con una herramienta específica de duplicate-key detection si tu contrato necesita rechazar duplicados.

  • Números grandes y precisión

    Síntoma: Un entero como 9007199254740993 se redondea a 9007199254740992 al parsearse, porque JavaScript usa coma flotante de doble precisión para todos los números.

    Cómo corregirlo: Trata el campo como string en JSON ("id": "9007199254740993") o usa la opción «bigint» del parser si está disponible. JSON no tiene tipo entero arbitrario.

  • Indentación inconsistente en YAML

    Síntoma: YAML rechaza el fichero con un error críptico («could not find expected ':'», «mapping values are not allowed here»). La causa habitual es mezclar tabs y espacios o cambiar el ancho de indentación.

    Cómo corregirlo: Usa siempre espacios (2 o 4) y mantén el mismo ancho en todo el fichero. Configura tu editor para mostrar caracteres invisibles si la cadena es repetitiva.

  • Booleanos implícitos en YAML 1.1 (yes/no/on/off)

    Síntoma: El string «yes» se convierte en true silenciosamente. Lo mismo con no, on, off, y o n en YAML 1.1, la versión que aún usan muchos parsers.

    Cómo corregirlo: Cita el valor explícitamente: "yes" entre comillas. Si controlas el parser, configura YAML 1.2, que restringe los booleanos a true/false.

Buenas prácticas JSON y YAML

Cuándo elegir cada formato, errores frecuentes en profundidad, gotchas de YAML 1.1 vs 1.2, anchors/aliases, números grandes y por qué validar client-side importa.

Leer la guía completa →