Usa el Probar JSONPath Online gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
Probar Consultas JSONPath con JSON Real
JSONPath es un lenguaje de consulta para JSON, igual que un filtro de búsqueda lo es para una lista. En lugar de recorrer un documento grande a mano, escribes una expresión corta y recibes exactamente los valores que coinciden. La expresión $.store.book[*].author devuelve todos los autores de libros. La expresión $.store.book[0].title devuelve el título del primer libro. La expresión $..price devuelve todos los precios a cualquier profundidad. Esta herramienta te permite probar esas consultas al instante, con tu propio JSON, sin instalar nada.
Pega el JSON, escribe la consulta y pulsa Ejecutar. La herramienta muestra cuántos valores coinciden y lista cada coincidencia como JSON. Un resultado de cero también es información útil: significa que esa ruta no existe en el documento, lo que normalmente indica un error de escritura en la consulta o una idea equivocada sobre la estructura. En ambos casos, aprendes algo en segundos.
Las Consultas que Más Usarás
La mayoría de las consultas diarias usan un conjunto pequeño de piezas. Un punto seguido de un nombre selecciona un campo: $.store.bicycle.color. Un número entre corchetes selecciona un elemento de un arreglo: $.store.book[0]. Un asterisco selecciona todo: $.store.book[*] devuelve todos los libros, y $..price busca de forma recursiva todos los precios en cualquier parte del documento. Un índice negativo cuenta desde el final, así que $.store.book[-1] es el último libro.
Los filtros son la pieza potente. Un filtro tiene esta forma: $..book[?(@.price < 10)] y devuelve solo los libros de menos de diez. El símbolo @ significa el elemento actual que se está probando. Los filtros pueden comparar números, comprobar la igualdad de textos y combinar condiciones. Esta herramienta ejecuta las consultas con filtros a través de la biblioteca jsonpath-plus, que implementa toda la sintaxis de filtros, mientras que las rutas simples también funcionan con un evaluador integrado si la biblioteca llegara a estar bloqueada. En los casos comunes obtienes las mismas respuestas de ambas maneras.
Cómo Construir una Consulta Paso a Paso
Empieza desde la raíz y añade una pieza cada vez. Primero escribe $ y ejecútalo: deberías recibir todo el documento. Después añade el primer campo, como $.store, y comprueba que el resultado es el objeto de la tienda. Después añade la siguiente pieza, como $.store.book, y confirma que ves el arreglo. Después añade el índice o el asterisco. En cada paso, el resultado te dice si la ruta hasta ahí es correcta, así que un error aparece de inmediato en lugar de esconderse al final de una expresión larga.
Cuando una consulta no devuelve nada, revisa tres cosas. Primero, la ortografía: las claves JSON distinguen mayúsculas y minúsculas, así que Book y book son campos distintos. Segundo, la estructura: si book es un arreglo, necesitas un índice o un asterisco antes de llegar a author. Tercero, la profundidad: si el campo que buscas está anidado más de lo que pensabas, el operador recursivo .. lo encontrará, y después podrás escribir la ruta exacta cuando veas dónde vive.
Usos Reales de JSONPath
Los desarrolladores usan JSONPath en varios lugares. En pruebas, una consulta comprueba que una respuesta de API contiene el valor esperado sin comparar todo el documento. En flujos de datos, una consulta extrae un campo de miles de registros. En archivos de configuración, una consulta saca un ajuste de un documento grande. Al depurar, una consulta responde una pregunta rápida: ¿esta respuesta contiene un precio por encima de un límite y, si es así, qué artículos?
Para todos estos usos, el hábito es el mismo: escribe la consulta aquí primero, confirma las coincidencias y después copia la consulta en tu código. Probar la consulta por separado ahorra una ronda de depuración en tu aplicación, donde una consulta incorrecta es más difícil de ver porque el fallo parece falta de datos en lugar de una expresión incorrecta.
Errores Comunes
El error más común es olvidar que los índices de arreglo empiezan en cero, así que el primer elemento es [0], no [1]. El segundo es usar notación de punto para claves con espacios o caracteres especiales: esas necesitan notación de corchetes con comillas, como $[“mi clave”]. El tercero es esperar que un filtro funcione sobre un campo que no está presente en todos los elementos: los elementos sin ese campo simplemente no coinciden, lo que normalmente es lo que quieres, pero puede sorprenderte si esperabas un error.
Otro error es confundir JSONPath con JSON Pointer o con jq. Parecen similares pero difieren en sintaxis. JSONPath empieza con $ y usa puntos y corchetes. JSON Pointer usa barras y empieza vacío o con una barra. jq es un lenguaje distinto de línea de comandos con sus propios filtros. Si una consulta que funciona en jq falla aquí, revisa la sintaxis con las reglas de JSONPath en lugar de suponer que ambos lenguajes coinciden.
Privacidad
Tu JSON y tus consultas nunca salen de tu navegador. La herramienta funciona en local, con la biblioteca jsonpath-plus cargada desde un CDN público para toda la sintaxis de filtros. No hace falta cuenta y nada de lo que pegas se guarda en ningún sitio.