Formatear JSON: validar, indentar y revisar los datos
Admin ·
Un JSON compacto puede ser válido y aun así resultar difícil de revisar. Aquí puedes separar la comprobación de sintaxis de la presentación: formatear para leer, minificar para copiar y explorar la estructura. La salida recupera los números de sus tokens originales, en lugar de volver a serializar valores JavaScript Number.
Esta guía explica qué conserva la herramienta, cómo ordena las claves y qué significan sus avisos. La entrada, la salida y el árbol tienen límites distintos; un árbol ausente no significa que se haya recortado el resultado.
Preparar, procesar y revisar
Pega el documento completo en «Entrada», usa «Abrir archivo de texto» para un archivo local o empieza con «Probar un ejemplo». Elige «Sangría» y el orden de claves antes de pulsar «Formatear JSON» o «Minificar».
La selección del editor no limita el procesamiento: ambas acciones usan toda la entrada. «Formatear JSON» añade presentación legible y «Minificar» quita espacios innecesarios fuera de las cadenas. Revisa «Resultado» y los avisos antes de exportar.
- Carga el documento completo, no solo el fragmento seleccionado.
- Elige sangría de 2 o 4 espacios y el orden de claves.
- Formatea para leer o minifica para reducir espacios de presentación.
- Corrige los errores de sintaxis y revisa las claves repetidas.
- Explora el árbol y sus punteros si necesitas localizar un valor.
- Copia o descarga toda la salida y guarda una copia fuera de la pestaña.
Se acepta un solo valor JSON estricto
El validador JSON admite objetos, arrays y valores escalares como documento completo. Exige nombres y cadenas entre comillas dobles y rechaza comentarios, comas finales y contenido adicional después del primer valor.
No repara JSON, no interpreta JSON5 y no reúne registros NDJSON. Para comprobar varios registros separados debes preparar un documento JSON válido por tu cuenta; cambiar solo la sangría no corrige la sintaxis.
| Ejemplo de entrada | ¿Se acepta aquí? | Significado |
|---|---|---|
{"ready":true} | Sí | Un objeto JSON con nombre entre comillas y valor booleano. |
[3,2,1] | Sí | Un array cuyo orden de elementos se conserva. |
"hello", 42, true, null | Sí | Cualquiera de ellos puede ser un valor completo en la raíz. |
| Editor vacío o con solo espacios | No | Falta un valor JSON. |
{"a":1,} o [1,] | No | Se rechazan las comas finales. |
{/* note */"a":1} | No | Se rechazan los comentarios. |
{a:1}, {'a':1}, NaN, Infinity | No | No son formas de JSON estricto aceptadas. |
{"a":1}
{"a":2} | No | Dos registros separados no forman un único documento JSON. |
Leer el primer error de sintaxis
El aviso señala el primer problema con línea y columna, ambas a partir de 1. La columna cuenta unidades UTF-16, no necesariamente caracteres visibles; un carácter fuera del plano básico ocupa dos unidades.
En {
"a": }, el cierre inesperado está en la línea 2, columna 8. Corrige la causa en «Entrada» y vuelve a procesar: pueden aparecer otros errores después del primero. La comprobación es de sintaxis, no de JSON Schema ni de reglas de negocio.
Conservar enteros grandes y escapes de JSON
El formateador JSON construye la salida con fragmentos originales para los números y las cadenas. Conserva enteros grandes, notación científica, ceros decimales, cero negativo y la escritura de los escapes; para generar ese texto no serializa los valores numéricos JavaScript Number del analizador.
Esta conservación pertenece al texto generado aquí. Otro programa puede redondear un número, interpretar un exponente como infinito o volver a serializar una cadena de otra forma. Compara los literales necesarios antes y después de enviar el archivo.
| Token o propiedad original | Qué conserva Resultado | Qué no se garantiza |
|---|---|---|
9007199254740993 | Los dígitos originales. | Que todos los receptores manejen el número de forma exacta. |
1e400 | El token de exponente original. | Un valor finito en un receptor con números binary64. |
1e+09 y 1.2300 | La escritura del exponente y de la parte decimal. | Una representación normalizada única. |
-0 | El signo menos y el cero. | Que otro serializador conserve esa escritura. |
"\u0061" | La escritura original de la cadena escapada. | Que la búsqueda de valores decodificados busque el texto del escape. |
"a":1,"\u0061":2 | Ambas propiedades con su escritura. | Nombres decodificados ni punteros únicos. |
RFC 8259: sintaxis e interoperabilidad de JSONECMAScript: JSON.parse
Detectar y conservar claves JSON repetidas
Las propiedades repetidas generan un aviso, pero siguen presentes y separadas. La detección compara nombres decodificados: "a" y "\u0061" representan el mismo nombre aunque estén escritos de forma distinta.
La herramienta no decide qué valor debe prevalecer ni elimina duplicados. Otras aplicaciones pueden quedarse solo con el último valor. Revisa los objetos avisados antes de utilizarlos en una configuración o intercambio de datos.
Ordenar claves sin mover los elementos de los arrays
En «Ordenar claves de objetos», elige «Conservar orden original», «Ascendente (UTF-16)» o «Descendente (UTF-16)». La ordenación compara los nombres decodificados por unidades UTF-16; no es un orden lingüístico ni una ordenación de números naturales.
La ordenación se aplica recursivamente a los objetos, incluidos los situados dentro de arrays. El orden de los elementos de cada array se conserva, al igual que el orden relativo de las claves que se decodifican igual. En ascendente, "10" va antes que "2". No es una canonicalización apta por sí sola para firmas digitales.
Explorar el árbol JSON
Después de procesar, pulsa «Explorar árbol JSON». Expande o contrae los contenedores para revisar propiedades y elementos; cada rama muestra primero hasta 100 hijos y permite cargar más en grupos de hasta 100.
Los números y las cadenas de las hojas conservan su escritura original; los contenedores resumen sus hijos. «Ocultar árbol JSON» vuelve a la vista de texto y «Restablecer árbol» borra la búsqueda y restaura las ramas iniciales. Editar la entrada invalida y borra el resultado anterior; volver a procesarla genera un resultado nuevo y cierra el árbol anterior.
Copiar punteros JSON y entender ~0 y ~1
Cada nodo puede mostrar un puntero JSON. La raíz se rotula con $, pero su puntero real es la cadena vacía. Dentro de un nombre, ~ se escribe ~0 y / se escribe ~1; las barras entre niveles son separadores.
«Copiar puntero» copia el puntero del nodo. Si el portapapeles falla, puedes seleccionar manualmente un puntero no vacío; la raíz no ofrece un marcador visible equivalente a su cadena vacía. Dos propiedades con el mismo nombre decodificado comparten puntero: según RFC 6901, su evaluación no está definida y falla. Aquí se muestran y copian rutas, no se resuelve esa ambigüedad.
| Nodo o clave | Ejemplo de puntero | Cómo interpretarlo |
|---|---|---|
| Raíz del documento | Cadena vacía, representada aquí como "" | Copiar el puntero copia cero caracteres, no $ ni comillas. |
Clave name de un objeto raíz | /name | Un nivel de miembro de objeto. |
Clave a/b~c de un objeto raíz | /a~1b~0c | Se escapan la barra y la tilde del nombre. |
| Primer elemento bajo esa clave de array | /a~1b~0c/0 | El cero final es un índice de array. |
Dos propiedades raíz que se decodifican como a | /a para ambas | El nombre repetido hace ambiguo el puntero. |
Buscar claves y valores en el árbol
La búsqueda del árbol busca subcadenas sin distinguir mayúsculas en etiquetas, rutas y valores de cadena decodificados. Por eso la cadena escrita como "\u0061" puede encontrarse con a; no hay que buscar necesariamente el escape original. Las demás hojas se buscan por su representación literal.
La consulta admite hasta 1000 unidades UTF-16. Se cuentan todas las coincidencias, pero la lista muestra como máximo las primeras 100; concreta la consulta para reducirla. Esta búsqueda del árbol no modifica el documento ni sustituye la búsqueda del editor de entrada.
Distinguir los límites de entrada, archivo y árbol
El límite de entrada se mide en unidades UTF-16; el del archivo local, en bytes antes de leerlo. Un carácter visible puede ocupar varias unidades y varios bytes, así que los dos controles no se pueden intercambiar.
El árbol tiene además presupuestos propios de nodos y texto. Un objeto con una propiedad de valor escalar usa cuatro nodos sintácticos: objeto, propiedad, nombre y valor. Si el árbol no cabe, el resultado formateado completo sigue disponible; no se promete un tiempo de respuesta para todo documento que quepa en los límites.
| Límite | Regla actual | Consecuencia práctica |
|---|---|---|
| Entrada y texto importado decodificado | Como máximo 1,000,000 de unidades UTF-16. | Se admite exactamente el límite; divide entradas más largas. |
| Bytes del archivo local | Estrictamente menos de 4,000,000 bytes. | Se rechaza un archivo de exactamente 4,000,000 bytes. |
| Anidamiento JSON | Como máximo 256 contenedores anidados. | Una profundidad mayor se rechaza antes del formato. |
| Nodos sintácticos del árbol | Como máximo 10,000 nodos del analizador. | No equivale a un permiso para 10,000 propiedades. |
| Presupuesto de texto del árbol | Como máximo 2,000,000 de unidades UTF-16 acumuladas en etiquetas, rutas y literales de hojas. | Puede omitirse el árbol y mantenerse completo Resultado. |
| Hijos visibles por rama | 100 al principio y después grupos de hasta 100. | Usa Mostrar los siguientes para revelar más hijos. |
| Búsqueda del árbol | Consulta de hasta 1,000 unidades UTF-16; se muestran las primeras 100 coincidencias. | El total puede superar la lista visible. |
| Historial de entrada | Hasta 20 instantáneas anteriores y 4,000,000 de unidades UTF-16 de pasado y futuro combinadas, sin contar la entrada actual. | Puede descartarse historial antiguo; no es almacenamiento permanente. |
Abrir un archivo de texto UTF-8 como JSON
«Abrir archivo de texto» lee un archivo local como texto UTF-8 y después comprueba la longitud decodificada. No detecta otras codificaciones ni analiza PDF o DOCX. El tamaño inferior a 4000000 bytes no garantiza que la entrada decodificada quepa en 1000000 unidades UTF-16.
La herramienta no descarga un documento desde una URL incluida en el texto. Si el archivo se rechaza o no se puede leer, conserva una copia fuera de la pestaña y prepara un archivo de texto más pequeño o con la codificación adecuada.
Copiar, descargar o reutilizar todo el resultado
«Copiar resultado» y «Descargar» usan toda la salida, aunque hayas seleccionado un fragmento. La descarga contiene texto UTF-8 y se llama toolmellow-result.json. Si el portapapeles no está disponible, selecciona el texto y cópialo manualmente.
La sangría puede producir más de 1000000 unidades UTF-16 de salida; no se aplica a la salida ese límite de entrada. Puedes copiarla o descargarla. «Usar resultado como entrada» solo acepta una salida que quepa en el límite: si lo supera, conserva ambos editores; si la acepta, sustituye la entrada, borra el resultado y permite deshacer dentro del historial disponible.
Buscar y reemplazar en la entrada, y deshacer
«Buscar y reemplazar en el texto» actúa sobre toda «Entrada». La búsqueda es literal, con «Distinguir mayúsculas» desactivado al principio: . no es una expresión regular y $& en «Reemplazar por» se inserta literalmente. La búsqueda admite 1000 unidades UTF-16 y el reemplazo 10000. «Reemplazar todo» se rechaza si superaría el límite de entrada.
Un pegado nativo demasiado grande se rechaza completo: se resta la selección que sustituiría y se normalizan CRLF o CR a LF antes de comprobar el tamaño. «Deshacer» y «Rehacer» guardan hasta 20 instantáneas anteriores y 4000000 unidades UTF-16 combinadas entre pasado y futuro, sin contar la entrada actual; los estados más antiguos pueden descartarse.
Vaciar, cancelar y entender el procesamiento local
«Vaciar» borra entrada, resultado, historial y búsquedas, pero mantiene las opciones. No se puede deshacer. No hay guardado automático ni restauración prometida al salir de la pestaña: guarda antes los datos que necesites.
«Cancelar» detiene el trabajo pendiente y conserva la entrada original. El procesamiento se ejecuta en un worker local con un plazo de 60 segundos que incluye su arranque. Un fallo de inicio, un tiempo agotado o un error del motor puede exigir menos texto o recargar; estar por debajo de los límites no garantiza terminar.
El procesamiento del JSON no envía su contenido a un servicio de conversión ni ejecuta los datos como código. Los recursos iniciales de la página pueden requerir red; esto no promete funcionamiento sin conexión, borrado de secretos ni certificación de seguridad. Las URL contenidas en el documento no se consultan.
Revisar el formato y los saltos de línea antes de entregar
Con el orden original, el formato usa el primer salto real CRLF, CR o LF que llega al formateador; si no hay ninguno, usa LF. Al ordenar claves se reconstruye primero un texto compacto, por lo que el formato posterior usa LF. Los escapes escritos \r y \n dentro de cadenas no cuentan como saltos reales.
Los controles del navegador pueden normalizar los saltos, los espacios exteriores se recortan y un escalar o un contenedor vacío puede no añadir ninguna línea. «Ajustar líneas» cambia la presentación del editor, no los bytes del JSON. Revisa los literales, los duplicados, el orden y el archivo final en la aplicación que vaya a recibirlos.
RFC 8259: sintaxis e interoperabilidad de JSONRFC 6901: punteros JSON
Preguntas frecuentes
¿Se conservan los enteros grandes y la escritura de los escapes?
Sí. Los números y las cadenas conservan sus tokens originales, incluidos 9007199254740993, 1e400, -0 y "\u0061". Un consumidor posterior puede interpretarlos o serializarlos de otra forma.
¿Se eliminan las claves JSON repetidas?
No. Se avisa de los nombres decodificados repetidos y se conservan todas las propiedades. No se elige un valor ganador; otra aplicación puede quedarse solo con el último.
¿Puedo procesar solo una selección?
No con las acciones de la herramienta: se procesa toda Entrada y se copia o descarga todo Resultado. Una selección sirve para las operaciones normales de copia del navegador.
¿Por qué se rechazan los comentarios y las comas finales?
Porque se exige JSON estricto. Los comentarios, las comas finales, JSON5 y varios registros NDJSON no se convierten ni reparan automáticamente.
¿Puedo usar una cadena o un número en la raíz?
Sí. Un documento puede contener un único objeto, array, cadena, número, booleano o null. Una entrada vacía no contiene un valor JSON.
¿Cómo se ordenan las claves y se conserva el orden de los arrays?
Se comparan nombres decodificados por UTF-16 y se ordenan los objetos recursivamente. Los arrays conservan el orden de sus elementos; las claves iguales conservan su orden relativo.
¿Por qué falta el árbol aunque el resultado esté completo?
El árbol tiene un máximo de 10000 nodos sintácticos y 2000000 de unidades UTF-16 de texto acumulado. Superar ese presupuesto no recorta la salida completa de Resultado.
¿Qué límites tienen la entrada, los archivos y el anidamiento?
Entrada admite hasta 1000000 unidades UTF-16 incluidas; los archivos deben tener menos de 4000000 bytes y el anidamiento no puede superar 256 contenedores. Los bytes y las unidades UTF-16 son medidas distintas.
¿Por qué no puedo usar una salida grande como entrada?
La sangría puede ampliar la salida por encima del límite de entrada. Puedes copiarla o descargarla; Usar resultado como entrada se rechaza y conserva los dos editores si no cabe.
¿El validador JSON también comprueba un JSON Schema?
No. Se comprueba la sintaxis de un único valor JSON; no se validan tipos, propiedades obligatorias ni otras reglas de un esquema.
¿Buscar y reemplazar admite expresiones regulares?
No. Busca texto literal, con distinción de mayúsculas opcional. El punto se busca como punto y $& se inserta literalmente en el reemplazo.
¿Qué significan ~0 y ~1 en un puntero JSON?
~0 representa una tilde y ~1 una barra dentro de un nombre. La raíz tiene un puntero vacío, no $; con nombres duplicados, la evaluación del puntero no está definida y falla.
¿Se abre una URL escrita en el JSON?
No. El documento se procesa como datos en el navegador; sus URL no se descargan ni su contenido se ejecuta. Cargar los recursos de la página puede necesitar red.
¿Puedo deshacer Vaciar y se guarda el texto al salir?
Vaciar no se puede deshacer: borra también el historial, aunque mantiene las opciones. No hay guardado automático al salir; guarda los datos que quieras conservar.
Referencias principales
Ponlo en práctica.
- Formatear JSON
- Formateador HTML
- Minificador y formateador CSS
- Limpiador de texto y listas
- Generador de hash SHA
Guías relacionadas
- Cómo formatear código HTML para leerlo mejor
- Cómo minificar o formatear CSS
- Cómo quitar líneas duplicadas y ordenar un texto
- Cómo generar un hash SHA-256 de un texto
- Cómo codificar y decodificar texto en Base64
- Cómo codificar y decodificar una URL
- Cómo generar un UUID: v4, v7 y GUID
- Cómo decodificar un JWT y leer sus claims
- Cómo convertir un timestamp Unix a fecha
- Cómo generar texto de relleno Lorem Ipsum