Formatear y validar JSON

Prueba el archivo de ejemplo

Descarga order-options.json, un pedido ficticio con dos artículos y nombres de campos en inglés. El objeto customer agrupa un nombre y una ciudad; el array items es una lista con CARD-02 seguido de BOX-01. El ejemplo incluye texto entre comillas, cantidades y precios numéricos, el booleano true y null para una nota de entrega vacía. Los campos están sin ordenar a propósito para mostrar qué cambia la opción de ordenación.

Paso a paso

1. Abre Formateador y validador JSON. Usa Archivo para abrir el archivo order-options.json incluido, o pega su contenido en Tus datos.
2. Establece Sangría en 2 para usar dos espacios por nivel. Deja Ordenar claves de objetos sin marcar en la primera ejecución.
3. Selecciona Procesar entrada. La herramienta comprueba la sintaxis JSON antes de mostrar el resultado. Si indica un error, usa la línea y la columna para localizarlo, corrige la entrada e inténtalo de nuevo.
4. Lee el resultado. El objeto customer y los dos artículos deberían ser fáciles de seguir, con un campo o elemento de lista por línea. Los campos conservan el orden del ejemplo mientras la ordenación esté desactivada.
5. Selecciona Descargar resultado para guardar formatted.json. También puedes usar Copiar texto para llevar el resultado a otro editor.
6. Abre el archivo descargado en un editor de texto y compáralo con el ejemplo mediante las comprobaciones siguientes. Después prueba las demás opciones de sangría y ordenación, seleccionando Procesar entrada tras cada cambio.

Ejemplos de antes y después

Estos ejemplos breves muestran el objeto customer de order-options.json como un pequeño documento JSON. Compara el mismo nombre y ciudad antes y después de cada ajuste. La sección opcional de referencias al final muestra el pedido completo.

{"customer":{"name":"Zoë","city":"Bergen"}}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{
  "customer": {
    "city": "Bergen",
    "name": "Zoë"
  }
}

{
  "customer": {
    "name": "Zoë",
    "city": "Bergen"
  }
}

{"customer":{"name":"Zoë","city":"Bergen"}}

Elegir la sangría

Cambiar la entrada o un ajuste borra el resultado anterior. Selecciona Procesar entrada de nuevo para generar un resultado con los nuevos ajustes. La herramienta lee el área de entrada cada vez; no introduce automáticamente el resultado anterior como entrada.

Ordenar claves de objetos

Deja Ordenar claves de objetos sin marcar para conservar el orden original de los campos de cada objeto. Al marcarlo, ordena las claves por orden textual que distingue mayúsculas y minúsculas en todo el documento, incluidos los objetos dentro de arrays. Los elementos de los arrays conservan su secuencia original.

1. Mantén Sangría en 2, marca Ordenar claves de objetos y selecciona Procesar entrada.
2. Las claves del nivel superior son ahora customer, deliveryNote, items, order y paid. Dentro de customer, city precede a name. En cada artículo, price precede a quantity y sku.
3. El array items sigue conteniendo CARD-02 seguido de BOX-01. Ordenar las claves no ordena los artículos por sku ni por price.

Copiar, descargar y empezar de nuevo

Comprobar el JSON descargado

• Abre formatted.json en un editor de texto. Confirma que el pedido es ORD-1042, el cliente es Zoë en Bergen y hay dos artículos.
• Comprueba los valores y sus tipos: quantity es el número 2 y después 1, los precios mantienen 19.50 y 5.00, paid es el booleano true sin comillas y deliveryNote es el valor null sin comillas. Los nombres y códigos de artículo entre comillas siguen siendo cadenas.
• Después de probar Ordenar claves de objetos, confirma el orden de campos indicado y que CARD-02 sigue antes que BOX-01 en el array items.
• Prueba Minificar y Procesar entrada. Pega el resultado en Tus datos, establece Sangría en 2 y selecciona Procesar entrada de nuevo. Compara los valores y el orden de los artículos con el ejemplo original; las opciones de formato deben conservarlos.

Preguntas y solución de problemas

¿Por qué indica que el JSON no es válido?

Comprueba la línea y la columna indicadas y el campo inmediatamente anterior. Las claves y el texto necesitan comillas dobles; los campos necesitan comas y dos puntos; los corchetes y las llaves deben cerrarse. Corrige la entrada y selecciona Procesar entrada de nuevo. La validación comprueba la sintaxis JSON, por lo que un resultado válido aún puede carecer de campos que tu aplicación exige.

¿Puedo usar comentarios o una coma final?

Elimina los comentarios y cualquier coma justo antes de un corchete o una llave de cierre. No son válidos en JSON. El formateador necesita una entrada válida y no la repara automáticamente.

¿Qué significa el aviso de claves repetidas?

El mensaje «Se conservaron las claves repetidas. Algunos lectores descartan las claves repetidas.» significa que una clave aparece varias veces en el mismo objeto. El formateador conserva esas entradas y muestra un aviso. Revisa el origen, elige el valor deseado y elimina la entrada sobrante; otra aplicación podría conservar solo una de ellas.

¿Por qué no se abre o procesa mi archivo?

El límite de entrada es de 2 MiB, es decir, 2.097.152 bytes. Los archivos de texto locales deben ser UTF-8. Si la herramienta indica que los datos son demasiado complejos, reduce su anidación o número de entradas. Divide una entrada grande en documentos JSON completos más pequeños, en lugar de cortarla en mitad de un objeto o array.

¿Por qué cambian los números largos en otra aplicación?

El ejemplo separado de precisión que aparece debajo contiene 9007199254740993 y 0.10000000000000001. Este formateador conserva exactamente el texto de los números con todas las opciones de sangría y ordenación. Formatea exact-numbers.json y compara el resultado con exact-numbers-formatted.json en un editor de texto. Una aplicación que importe el resultado puede redondear los números; confirma que admite la precisión necesaria. Un código con cero inicial, como 00123, debe ser una cadena entre comillas en JSON.

¿Puede el formato recuperar dígitos ya redondeados?

El formato no puede recuperar dígitos redondeados o eliminados antes de que el texto llegue a la herramienta. Vuelve al origen y exporta el valor completo de nuevo. Cuando el valor es un identificador en lugar de una cantidad, una cadena puede ayudar a las aplicaciones receptoras a conservar sus dígitos.

Herramientas relacionadas

Fuentes