logo
GeekFormat

Consulta JSONPath

Herramienta de consulta JSONPath en línea para ingenieros de pruebas API y analistas de datos. Extraiga, filtre y localice con precisión datos de JSON masivos profundamente anidados con sintaxis estándar. Vista dual JSON/tabla, 8 ejemplos integrados, reparación automática de errores, atajos de teclado, 200 entradas de historial, editor CodeMirror. Procesamiento completamente local, rápido y seguro.

Relacionado

Casos de uso

  • Ingenieros de pruebas API escribiendo aserciones Postman/JMeter para verificar respuestas API
  • Analistas de datos extrayendo campos específicos de logs grandes y exportaciones JSON
  • Desarrolladores frontend localizando rápido campos necesarios de respuestas API anidadas
  • Testers QA verificando estructura y valores de campos en respuestas de interfaz
  • Equipos backend depurando estructuras JSON complejas y localizando anomalías de datos
  • Desarrolladores limpiando y transformando datos de logs para análisis
  • Integración API donde se deben identificar y extraer rutas de datos específicas
  • Redacción de documentación técnica donde se deben precisar rutas de campos JSON
  • Capacitación de equipos donde se debe enseñar y demostrar sintaxis JSONPath
  • Auditorías de datos verificando presencia y consistencia de campos en conjuntos JSON
  • Extracción por lotes de datos de respuestas API paginadas o respuestas de array
  • Depuración rápida donde se deben inspeccionar valores de campos específicos sin navegación manual

Características

  • Extracción precisa de datos: admite subconjunto de sintaxis JSONPath estándar para targeting preciso, incluyendo acceso a propiedades, índice de array [-1], comodín * y corte de array [start:end]
  • Filtrado condicional: filtro ?() con operadores de comparación ==/!=/>/</>=/<= para extraer datos que cumplen condiciones
  • Vista dual interactiva: cambio con un clic entre vista JSON sin formato y vista tabla estructurada para consulta y exportación de resultados
  • Resaltado sintáctico en tiempo real: resaltado sintáctico profesional y mensajes de error inteligentes para corregir expresiones de consulta rápido
  • 8 ejemplos integrados: cubre escenarios de uso común para inicio rápido y aprendizaje de sintaxis
  • Reparación automática de errores JSON: repara automáticamente errores sintácticos comunes como comas finales y comillas faltantes
  • Debounce inteligente de 400ms: ejecución automática tras pausa de escritura, evita ejecuciones frecuentes y garantiza fluidez
  • Atajos de teclado: atajos para ejecución, copia, limpieza y cambio de vista para eficiencia máxima
  • 200 entradas de historial local: almacenamiento localStorage de consultas recientes para recuperación y reejecución rápidas
  • Editor CodeMirror profesional: resaltado sintáctico, plegado de código, numeración de líneas y emparejamiento de corchetes
  • Procesamiento local de alta velocidad: cálculo completo en navegador, seguridad absoluta de datos sensibles de prueba y privacidad empresarial
  • Resaltado de resultados: resaltado visual de coincidencias en resultados para identificación rápida
  • Exportación de resultados: copia con un clic y exportación de resultados de extracción en varios formatos
  • Accesibilidad: interfaz clara y responsiva adaptada a distintos tamaños de pantalla

Cómo Usar

  1. Pegar contenido JSON en el editor izquierdo o cargar un archivo JSON
  2. Ingresar expresión JSONPath en el cuadro de consulta superior (use ejemplos integrados como referencia)
  3. Los resultados aparecen automáticamente después de 400ms en el panel derecho, en vista JSON o tabla
  4. Cambiar vista según necesidad, copiar resultados o consultar historial para reutilizar expresiones

Preguntas Frecuentes

¿Cómo uso JSONPath para extraer con precisión campos específicos de JSON profundamente anidado?

Simplemente ingrese una expresión JSONPath estándar en el cuadro de consulta (por ejemplo, `$.store.book[0].title`), la herramienta localizará y extraerá rápidamente datos profundos mediante recorrido jerárquico. Comparado con expandir manualmente archivos JSON grandes, este enfoque mejora mucho la eficiencia de localización de datos, ideal para procesar respuestas API complejas.

¿Admite comodines o filtros para consultas condicionales complejas?

Totalmente compatible. Puede usar el comodín (*) para coincidir con cualquier campo, o filtros de expresión ?() para filtrado avanzado. Por ejemplo, ingresar `$.store.book[?(@.price < 10)]` filtrará instantáneamente todos los libros con precio menor a 10. La herramienta resalta resultados coincidentes en tiempo real y permite visualización intuitiva en vista tabla.

¿Cómo puede ayudarme esta herramienta con pruebas automatizadas API y aserciones?

En pruebas automatizadas API, pegue el JSON de respuesta API en la herramienta y escriba expresiones JSONPath como aserciones de prueba. Al verificar rápidamente si el resultado devuelto cumple expectativas (por ejemplo, comprobar si `$.code` es igual a 200), puede solucionar errores de lógica de interfaz rápidamente: un asistente potente en flujos de trabajo de pruebas Postman o JMeter.

¿Las expresiones JSONPath distinguen mayúsculas y minúsculas?

Sí, JSONPath distingue mayúsculas y minúsculas. Los nombres de campos deben coincidir exactamente, incluyendo mayúsculas/minúsculas. Por ejemplo, `$.User.Name` y `$.user.name` son rutas distintas. La herramienta avisa inmediatamente si no encuentra una ruta coincidente, ayudando a corregir errores de escritura rápido.

¿Cómo accedo al último elemento de un array sin conocer su longitud?

Use el índice [-1] para acceder directamente al último elemento del array. Por ejemplo, `$.store.book[-1]` devuelve el último libro. Igualmente, [-2] accede al penúltimo, y así sucesivamente. Esto es especialmente útil para procesar arrays de longitud dinámica en respuestas API.

¿Qué significa la sintaxis de corte de array [start:end]?

El corte [start:end] extrae un rango de elementos del array desde el índice start incluido hasta end excluido. Por ejemplo, `$.store.book[0:2]` extrae los dos primeros libros. Si start se omite, empieza en 0; si end se omite, llega hasta el final del array. También admite paso negativo para recorrido inverso.

¿Puedo usar varias condiciones en un filtro?

Esta versión implementa un subconjunto de sintaxis JSONPath que cubre el 90% de escenarios de uso diario. Los filtros simples con operadores de comparación ==/!=/&gt;/&lt;/&gt;=/&lt;= son totalmente compatibles. Para múltiples condiciones o expresiones de script complejas, considere bibliotecas especializadas. La herramienta muestra un mensaje claro si detecta sintaxis no compatible.

¿Cómo cambio entre vista JSON sin formato y vista tabla estructurada?

Simplemente haga clic en el botón de cambio de vista en la barra de herramientas. La vista JSON muestra la estructura jerárquica con indentación y resaltado sintáctico. La vista tabla presenta los resultados de extracción como tabla estructurada, facilitando la consulta y exportación de datos tabulares.

¿Hay ejemplos integrados para comenzar rápido?

Sí, 8 ejemplos integrados cubren escenarios de uso común: acceso simple a propiedades, índice de array, comodín, corte, filtro, etc. Haga clic en el botón de ejemplos en la barra de herramientas para cargar un ejemplo rápido y entender la sintaxis sin escribir desde cero.

¿Cómo funciona la reparación automática de errores JSON?

Si el JSON pegado contiene errores sintácticos comunes (comas finales, comillas faltantes, etc.), la herramienta intenta una reparación automática antes de ejecutar la consulta. Esto evita bloqueos por errores de formato menores y mejora la continuidad del flujo de trabajo.

¿Qué es el retardo debounce de 400ms y por qué?

La herramienta usa debounce de 400ms: la consulta se ejecuta automáticamente 400ms después de la última pulsación de tecla. Esto evita ejecuciones demasiado frecuentes mientras escribe, garantiza fluidez al tipear y evita carga innecesaria, especialmente útil para procesar JSON grandes.

¿Hay atajos de teclado para mejorar la eficiencia?

Sí, varios atajos de teclado integrados: Ctrl/Cmd+Enter para ejecutar consulta, Ctrl/Cmd+Shift+C para copiar resultados, Ctrl/Cmd+K para limpiar, Ctrl/Cmd+Y para cambiar vista. Consulte el menú de atajos en la barra de herramientas para la lista completa.

¿Cuántas consultas se guardan en el historial?

La herramienta guarda automáticamente las últimas 200 consultas en localStorage del navegador. Puede recuperar, volver a ejecutar o eliminar elementos del historial rápidamente. Los datos del historial permanecen localmente en el navegador y nunca se envían a servidores.

¿Los datos se envían a servidores?

No, todo el procesamiento se realiza localmente en el navegador. El JSON ingresado y las expresiones de consulta nunca salen de su dispositivo, garantizando privacidad absoluta de datos sensibles de prueba e información empresarial. Incluso después de cerrar la página, no se conservan datos en el servidor.

¿Qué editor se usa para la entrada de JSON?

La herramienta integra el editor CodeMirror con resaltado sintáctico profesional, plegado de código, numeración de líneas y emparejamiento de corchetes. Ofrece una experiencia de edición similar a IDE, haciendo más cómoda la entrada y modificación de JSON.

Sobre JSONPath y consultas en línea

JSONPath es un lenguaje de expresión para consultar y extraer datos de estructuras JSON. Inspirado en XPath para XML, proporciona una forma de recorrer la jerarquía JSON y localizar campos o valores con precisión, similar a cómo consultas SQL interrogan bases de datos. Se ha convertido en herramienta indispensable para desarrolladores y testers que trabajan con APIs y datos JSON.

El concepto fundamental de JSONPath es el uso de expresiones de ruta para navegar por la estructura de árbol JSON. El símbolo raíz $ representa el punto de inicio, luego el operador punto . accede a propiedades hijas, y corchetes [] acceden a elementos de array por posición. Por ejemplo, la expresión $.store.book[0].title parte de la raíz, accede al objeto store, luego al array book, toma el primer elemento y devuelve el valor del campo title.

Para arrays, JSONPath admite varios modos de acceso: índices numéricos simples como [0] para el primer elemento, índices negativos [-1] para el último elemento sin conocer la longitud del array, comodín * para coincidir con todos los elementos, y sintaxis de corte [start:end] para extraer rangos de elementos consecutivos. Estas funciones cubren la gran mayoría de necesidades de acceso a arrays en escenarios comunes.

El operador comodín * se puede usar para coincidir con cualquier propiedad o elemento. Por ejemplo, $.store.* devuelve todos los campos directos en store, y $.store.book[*] devuelve todos los elementos en el array book. Esto es especialmente útil para recorrer todos los hijos sin conocer nombres de campos explícitos.

La función de filtro ?() es un mecanismo potente para selección condicional de datos. En filtros, @ representa el nodo actual, y operadores de comparación ==/!=/&gt;/&lt;/&gt;=/&lt;= se pueden usar para filtrar elementos según condición. Por ejemplo, $.store.book[?(@.price &lt; 10)] selecciona todos los libros en el array book cuyo precio es menor a 10: muy práctico para extraer rápido subconjuntos de datos que cumplen criterios.

Esta herramienta integra varias funciones para mejorar la experiencia de uso: editor CodeMirror con resaltado sintáctico profesional, vista dual JSON/tabla para presentación de resultados adaptable, 8 ejemplos integrados para inicio rápido, reparación automática de errores JSON comunes, debounce de 400ms para ejecución fluida durante la escritura, atajos de teclado para eficiencia y 200 entradas de historial local para recuperar expresiones anteriores.

Todo el procesamiento se realiza localmente en el navegador: JSON y expresiones de consulta nunca se envían a servidores, garantizando privacidad absoluta de datos sensibles como claves API, tokens e información empresarial. Esto es especialmente importante para ingenieros de prueba que procesan respuestas API de producción con datos sensibles.

Esta herramienta implementa un subconjunto de sintaxis JSONPath cuidadosamente seleccionado que cubre el 90% de escenarios de uso diario: acceso a propiedades, índices de array (positivos/negativos), comodín *, corte [start:end] y filtros simples ?() con operadores de comparación. Funciones avanzadas como descenso recursivo (..), expresiones de script complejas y combinaciones de múltiples condiciones no son compatibles en esta versión, priorizando estabilidad y simplicidad para usos comunes.

术语表

JSONPath
Lenguaje de expresión para consultar y extraer datos de estructuras JSON, similar a XPath para XML
$
Símbolo raíz que representa el objeto o array JSON raíz, punto de inicio de toda expresión JSONPath
@
Nodo actual en expresiones de filtro, representa el elemento en procesamiento
.
Operador de acceso hijo para acceder a propiedades de objeto, por ejemplo $.store.book accede al campo book en store
[]
Operador de índice de array para acceder a elementos por posición, [-1] representa el último elemento
*
Comodín que coincide con cualquier propiedad o elemento de array, por ejemplo $.store.* devuelve todos los campos en store
[start:end]
Corte de array para extraer un rango de elementos desde el índice start hasta end (excluido)
?()
Expresión de filtro para seleccionar elementos que cumplen una condición, usando operadores de comparación
Vista tabla
Presentación de resultados de extracción como tabla estructurada con columnas y filas para lectura facilitada
Debounce 400ms
Tiempo de espera antes de ejecutar consulta tras última pulsación, evita ejecuciones excesivas durante la escritura
localStorage
Almacenamiento local del navegador para guardar historial de consultas sin enviar datos a servidores
CodeMirror
Biblioteca de editor de código integrada que ofrece resaltado sintáctico profesional y funciones de edición

Tabla de referencia de sintaxis JSONPath

Sintaxis JSONPath compatible con descripciones y ejemplos

SintaxisDescripciónEjemplo
$Objeto/array raíz$
.propertyAcceso a propiedad hija$.store.book
[n]Índice de array (n positivo/negativo)$.book[0] / $.book[-1]
*Comodín, cualquier campo/elemento$.store.*
[start:end]Corte de array$.book[0:2]
?(condition)Filtro condicional$.book[?(@.price &lt; 10)]

Tabla de operadores de comparación para filtros

Operadores de comparación utilizables en expresiones de filtro ?()

OperadorSignificadoEjemplo
==Igual a?(@.price == 10)
!=Distinto de?(@.category != "reference")
&gt;Mayor que?(@.price &gt; 10)
&lt;Menor que?(@.price &lt; 10)
&gt;=Mayor o igual que?(@.price &gt;= 10)
&lt;=Menor o igual que?(@.price &lt;= 10)

Tabla de atajos de teclado

Atajos de teclado integrados para mejorar eficiencia

AtajoAcción
Ctrl/Cmd + EnterEjecutar consulta
Ctrl/Cmd + Shift + CCopiar resultados
Ctrl/Cmd + KLimpiar editor y consulta
Ctrl/Cmd + YCambiar entre vista JSON y tabla

Privacy & Security

Todas las consultas JSONPath, ediciones JSON y procesamientos en esta herramienta se ejecutan completamente en su navegador. Los datos no se envían a servidores, ni se almacenan o cachean remotamente. Incluso al procesar respuestas API con claves, tokens o información empresarial sensible, es absolutamente seguro. Después de cerrar o actualizar la página, los datos se eliminan (el historial se guarda solo en su localStorage).

Authoritative References

Troubleshooting

No se devuelven resultados / ruta no encontrada

Verifique que los nombres de campos estén escritos correctamente (distingue mayúsculas/minúsculas), que la estructura JSON coincida con la ruta esperada. Pruebe primero un ejemplo integrado para validar funcionamiento, luego construya la expresión gradualmente desde la raíz.

Error de sintaxis JSON en la entrada

La herramienta intenta reparación automática de errores comunes. Si la reparación falla, verifique comillas dobles para claves y cadenas, ausencia de coma final después del último elemento, pares de llaves/corchetes cerrados correctamente. Use la herramienta de reparación JSON si es necesario.

La expresión de filtro no funciona como se espera

Verifique que @ haga referencia al campo correcto en el array, que los valores comparados sean del tipo adecuado (números sin comillas, cadenas con comillas dobles). Esta versión admite filtros simples; múltiples condiciones y scripts no son compatibles.

El descenso recursivo .. no funciona

El descenso recursivo (..) no es compatible en esta versión. Esta herramienta implementa un subconjunto de sintaxis que cubre el 90% de escenarios comunes. Para búsqueda recursiva profunda, construya rutas explícitas nivel por nivel.