Ver un array JSON en tabla: encabezados, orden y búsqueda

PublicadoHerramientaVisualizador de Matriz JSON en Tabla

Contenido
  1. Cuándo se vuelve un problema no poder ver una matriz JSON como tabla
  2. Cómo revisar una matriz JSON como tabla sin herramientas
  3. Puntos que suelen confundir
  4. Resumen
  5. Preguntas frecuentes

Las matrices JSON que llegan en la respuesta de un servidor de API o dentro de un archivo de texto vienen con corchetes y llaves amontonados en un solo bloque, así que cuesta mucho ver a simple vista cuántos elementos hay o qué campos incluye cada uno.

En este artículo explicamos, tal como funciona, cómo se crean realmente las columnas cuando conviertes una matriz de objetos JSON en una tabla y con qué criterio comparan los valores la ordenación y la búsqueda. También verás cómo comprobarlo tú mismo sin ninguna herramienta, solo con el navegador.

Resumen ① Los encabezados de columna se forman reuniendo las claves de todos los elementos de la matriz, así que aunque cada elemento tenga campos distintos, todos quedan en una sola tabla. ② La ordenación compara las columnas numéricas por magnitud numérica y el resto por el orden de la cadena pasada a minúsculas; las filas sin valor siempre quedan al final. ③ El buscador convierte el valor de todas las celdas en cadenas y busca coincidencias parciales sin distinguir mayúsculas de minúsculas; los valores de objetos o matrices anidados solo se muestran como la cadena resultante de la conversión.

Cuándo se vuelve un problema no poder ver una matriz JSON como tabla

Cuando consultas una lista de usuarios o de pedidos en una API REST, es habitual que el resultado llegue como una matriz de objetos JSON. Si hay decenas o cientos de elementos, con el texto solo cuesta entender qué valor hay en cada uno.

La confusión es mayor si la respuesta incluye campos como phone o address en algunos usuarios y en otros no. Comparar a ojo una matriz en la que un objeto tiene 5 campos y otro tiene 7 para localizar los que faltan lleva su tiempo.

Y si los datos mezclan campos numéricos como el precio o las existencias y quieres verlos de mayor a menor, o filtrar solo los elementos que contengan cierta palabra clave, con el texto original no hay forma de ordenar ni de buscar.

Cómo revisar una matriz JSON como tabla sin herramientas

La consola de las herramientas de desarrollo del navegador ya trae console.table, una función que dibuja una matriz en forma de tabla. Sin instalar nada, con esta función puedes reproducir la tabla, la ordenación y la búsqueda.

Verla como tabla

Pulsa F12 (en Mac, Cmd+Option+I) para abrir las herramientas de desarrollo y ve a la pestaña Consola. Pega el texto de la matriz JSON tal cual después de console.table( y ciérralo con ); al ejecutarlo, se dibuja una tabla cuyas columnas reúnen las claves de todos los objetos de la matriz.

Eso sí: las celdas que contienen objetos o matrices anidados no se despliegan como texto, sino que aparecen como una referencia que puedes expandir. Este punto es distinto de cómo muestra los valores la herramienta que veremos más abajo, así que conviene no confundirlos.

Reproducir la ordenación

En la consola, guarda la matriz en una variable (const data = array_pegado) y escribe algo como data.slice().sort((a, b) => (a.precio ?? Infinity) - (b.precio ?? Infinity)) para comparar un campo numérico en orden ascendente.

Si el campo es de texto, compara los dos valores pasados a minúsculas; y si filtras aparte los elementos sin valor y los añades al final de la matriz, el resultado es el mismo.

Reproducir la búsqueda

Si ejecutas data.filter(row => Object.values(row).some(v => String(v).toLowerCase().includes('palabra'))), te quedas solo con los resultados de comprobar, con coincidencia parcial en minúsculas, el valor de todos los campos convertido en cadena.

En lugar de escribir este proceso en la consola cada vez, la herramienta de abajo ya trae esa misma lógica en botones y campos de entrada.

Compruébalo con nuestra herramienta.

Visualizador de Matriz JSON en Tabla

Se procesa solo en tu navegador: convierte un array JSON en tabla sin instalar nada ni registrarte.

Puntos que suelen confundir

Cuando la tabla no se dibuja o se ve distinto de lo esperado, casi siempre es por una de estas cuatro cosas.

SituaciónLo que ocurre en realidad
Pegas solo un objeto { } y no una matriz en el nivel superiorJSON.parse se ejecuta sin problema, pero como no es una matriz solo aparece un mensaje de error y no se dibuja la tabla
La respuesta de la API envuelve la matriz, por ejemplo { "data": [ ... ] }Como el nivel superior es un objeto, sale el mismo error anterior; hay que copiar y pegar solo la parte de la matriz interna para que se dibuje la tabla
Algún valor contiene objetos o matrices anidadosEn la celda solo se muestra el resultado de la conversión a cadena de JavaScript (los objetos como [object Object] y las matrices como texto separado por comas), así que el detalle no se ve
Cada elemento tiene una estructura de campos distintaSe crea una sola tabla con las claves de todos los elementos, sin errores, y los campos que faltan aparecen como celdas vacías

La ordenación también es un punto que confunde. Si en una misma columna se mezclan números y texto, el criterio de comparación puede cambiar de un elemento a otro, y las filas con el valor vacío (null o undefined) siempre se van al final de la tabla, tanto en orden ascendente como descendente.

Resumen

  • Los encabezados de columna se forman reuniendo las claves de todos los elementos de la matriz. Aunque cada elemento tenga una estructura de campos distinta, se obtiene una sola tabla sin errores.
  • La ordenación compara los números por magnitud numérica y el resto por el orden de la cadena pasada a minúsculas; las filas sin valor siempre quedan al final.
  • El buscador convierte el valor de todas las celdas en cadenas y busca coincidencias parciales sin distinguir mayúsculas de minúsculas.
  • Si el nivel superior no es una matriz (un solo objeto, o un objeto que envuelve la matriz), aparece un error y no se dibuja la tabla.
  • Los valores de objetos y matrices anidados solo se muestran como cadena, así que no puedes ver su detalle directamente en la tabla.
Visualizador de Matriz JSON en Tabla

Se procesa solo en tu navegador: convierte un array JSON en tabla sin instalar nada ni registrarte.

Preguntas frecuentes

¿Cómo se comparan los valores si en la columna de ordenación se mezclan números y texto?

Los valores que se reconocen como números se comparan por magnitud numérica y los que no, por el orden de la cadena pasada a minúsculas. Si en una misma columna se mezclan números y texto, los criterios de comparación se entremezclan y el orden puede salir distinto de lo que esperas.

Escribo en el buscador un valor que está ahí y no aparece. ¿A qué se debe?

La búsqueda comprueba coincidencias parciales sobre el resultado de convertir en cadena el valor de cada celda. Los valores de objetos o matrices anidados se muestran como el resultado de la conversión a cadena (por ejemplo, [object Object]) y no con su contenido original, así que si escribes el valor real que había dentro, no lo encuentra.

¿Dónde quedan al ordenar las filas que tienen un campo sin valor?

Las filas cuyo valor en la columna de ordenación es null o undefined siempre se sitúan al final de la tabla, sin importar si el orden es ascendente o descendente.

Pego el texto JSON y solo aparece un error, sin tabla.

Pasa cuando la estructura del nivel superior no es una matriz ([ ]) sino un único objeto ({ }), o cuando la sintaxis del JSON no es correcta. Si la respuesta de la API envuelve la matriz, como en { "data": [...] }, tienes que copiar y pegar solo la parte de la matriz interna.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Convertir JSON a lista HTML ul/li: reglas y erroresQué regla convierte cada elemento de un array JSON en texto de un li, cómo se aplican ul u ol y class, y por qué fallan el parseo o una clave mal escrita.
  2. JSON inválido: cómo leer el error y repararlo automáticamentePor qué JSON.parse falla con comentarios, comas finales o claves sin comillas, cómo leer line y position en el error y qué hace la corrección automática.
  3. Escapar JSON en una línea: cómo convertir y pegar sin erroresPor qué el JSON se rompe al pegarlo en un argumento de CLI o en .env, qué escape sustituye cada carácter y cómo funcionan los modos JSON y Raw.
  4. Cómo aplanar JSON anidado: reglas de claves combinadasAprende cómo se combinan las claves anidadas (clave padre + separador + clave hija), por qué los arrays quedan intactos y qué falla al elegir separador.
  5. Convertir claves JSON de camelCase a snake_case: reglas y casosConvierte claves JSON a camelCase, snake_case, PascalCase o kebab-case: reglas, ejemplos y cómo aplicar el cambio en objetos y arrays anidados.
  6. Eliminar claves JSON: varias a la vez y en cualquier nivelAprende a borrar varias claves JSON a la vez y de forma recursiva: opción de mayúsculas, coincidencia exacta y resultado con un JSON no válido.

Herramientas relacionadas