Evaluación de expresiones JSONPath sobre estructuras de datos
La extracción precisa de información en documentos JSON complejos requiere herramientas de consulta estructuradas. JSONPath funciona como un lenguaje de consulta para JSON, equivalente a lo que representa XPath para los documentos XML. Esta herramienta permite introducir datos JSON y una expresión JSONPath para evaluar de forma inmediata qué valores coinciden con la consulta, mostrando tanto el contenido extraído como la ruta exacta de origen dentro de la estructura jerárquica.
El proceso de evaluación se realiza de manera local. Tu JSON y JSONPath se prueban en tu navegador y no se sube nada a BroBroGo. Esto garantiza que los datos introducidos no se transmitan a servidores externos durante el análisis.
Límites de entrada y validación de datos
Para asegurar un rendimiento óptimo durante el procesamiento en el navegador, la herramienta aplica restricciones cuantitativas a los datos de entrada:
- Entrada JSON: El área de texto destinada al documento de origen admite un tamaño máximo de 500.000 caracteres. Si el contenido supera este límite, la interfaz detiene el análisis y muestra el mensaje: Este JSON es demasiado grande para probarlo aquí. Usa una muestra más pequeña..
- Expresión JSONPath: El campo de texto para la consulta acepta un máximo de 4.000 caracteres. Si se excede esta longitud, se presenta el aviso: Esta expresión JSONPath es demasiado larga para probarla aquí..
La validación se ejecuta en tiempo real. Si el documento JSON estructurado presenta errores de sintaxis o no cumple con la especificación del formato, la herramienta interrumpe la evaluación y muestra el error: Este JSON no es válido.. Del mismo modo, si la consulta introducida no sigue las reglas de construcción de JSONPath, se muestra el mensaje: Esta expresión JSONPath no es válida..
Sintaxis admitida y patrones de selección
La herramienta es compatible con los patrones de consulta más comunes de la especificación JSONPath, lo que permite interactuar con objetos anidados y colecciones de datos:
- Rutas directas y operadores comodín: Permiten navegar por la jerarquía definida de claves, como por ejemplo
$.store.book[*].title. - Descenso recursivo: Mediante el operador
..se pueden buscar propiedades de forma profunda sin necesidad de especificar la ruta completa, como$..price. - Filtros condicionales: Expresiones lógicas aplicadas a los elementos de un array para filtrar según sus propiedades, por ejemplo
[?@.price < 10]. - Cortes de arrays (slices): Sintaxis para seleccionar subconjuntos de elementos dentro de una lista basándose en sus índices.
Cuando la expresión se evalúa correctamente pero no encuentra ningún elemento que cumpla con las condiciones especificadas en el documento JSON, la interfaz devuelve el estado: Sin coincidencias.. Si se limpian los campos de entrada, el sistema confirma la acción con el mensaje: Borrado..
Gestión de resultados y rendimiento
Una vez procesada la consulta, la herramienta genera una lista estructurada bajo el encabezado Detalle. Cada coincidencia incluye el valor extraído y la ruta exacta de donde procede dentro del JSON original, facilitando la localización de elementos profundamente anidados.
Para evitar el bloqueo del navegador con conjuntos de datos excesivamente repetitivos, la visualización de resultados está limitada a un máximo de 200 registros. Si la consulta genera un volumen superior, la interfaz muestra el indicador Coincidencias: 200+ junto con la advertencia: Se muestran las primeras {max}..
En escenarios donde la consulta requiere un procesamiento excesivo debido a la complejidad del descenso recursivo o al volumen del JSON, el evaluador interrumpe la ejecución tras un breve periodo de tiempo para proteger los recursos del sistema. En este caso, se muestra el mensaje de error: Este JSONPath tardó demasiado. Acota la expresión o usa una muestra más pequeña.. Si ocurre cualquier otro fallo imprevisto durante el análisis de la consulta, la herramienta devuelve: No se pudo evaluar este JSONPath..
Preguntas frecuentes
¿Qué sintaxis JSONPath puedo usar?
Usa patrones habituales como $.store.book[*].title, descenso recursivo con $..price, filtros como [?@.price < 10] y cortes de arrays.
¿Por qué cada resultado muestra una ruta?
La ruta indica de dónde salió el valor dentro del JSON original, para que puedas copiar una coincidencia sin perder su ubicación.
¿Por qué puede agotarse una consulta?
Las consultas recursivas muy amplias o las muestras enormes pueden tardar demasiado. El probador las detiene tras un límite corto para que acotes la expresión o uses una muestra menor.