Probador de JSONPath gratis
Consultar JSON anidado con seguridad con caminos, punteros, comodines, cortes y exportación de resultados.
Cargando herramienta…
Cómo extraer valores JSON con consultas seguras de JSONPath
Usa JSONPath para seleccionar valores de un documento anidado sin expandir manualmente cada objeto. Las expresiones y filtros de script están deshabilitados en este espacio de trabajo.
- Pegar o importar un documento JSON.
- Introduce una consulta que comienza con el símbolo raíz $.
- Ejecute la consulta e inspeccione rutas, punteros y valores coincidentes.
- Refina el selector, luego copia o descarga el resultado extraído.
Que busca un probador JSONPath
Respuestas de API, exportación de configuración y registros de registro a menudo entierran el valor que necesita varios niveles profundos. Un probador JSONPath le permite escribir un selector corto, ver cada partido a la vez y confirmar que el selector es justo antes de ponerlo en código, una prueba o una regla de monitoreo.
Los usuarios típicos incluyen desarrolladores que comprueban una ruta antes de añadirla a una integración, evaluadores de QA que sacan cada precio o ID de una respuesta de muestra, y analistas que recibieron una gran exportación y sólo necesitan un campo de cada registro. También es una forma rápida de aprender la sintaxis JSONPath mediante el intento de pequeños cambios y ver la actualización de resultados.
Un ejemplo trabajado con los datos de la tienda de muestras
Selecciona Cargar ejemplo para llenar el editor con un documento de tienda pequeña. Tiene una matriz de libros con dos entradas: id 1, Diseño Práctico, precio 12, e id 2, Notas de jardín, precio 18. El cuadro de consulta comienza con $.store.books[*].title.
Ejecute esa consulta y la lista de resultados dos coincide. El primero tiene la ruta $['store']['books'][0]['title'], el puntero /store/books/0/title y el valor Diseño Práctico. El segundo tiene la ruta $['store']['books'][1]['title'], el puntero /store/books/1/title y el valor Garden Notes.
Ahora prueba $.. precio. Descenso recursivo busca cada nivel, por lo que devuelve 12 y 18 con los punteros /store/books/0/price y /store/books/1/price. La rebanada $.store.books[-1:].title devuelve sólo Garden Notes, porque un inicio negativo cuenta desde el final de la matriz.
Cómo el motor de consulta lee su selector
Cada consulta debe comenzar con $, que representa la raíz del documento, y debe permanecer por debajo de 1.000 caracteres. Desde allí puede encadenar nombres de propiedades con puntos o corchetes, elegir posiciones de array con índices, combinar varias teclas o índices en una unión, tomar un rango con una rebanada como [0:2], utilizar * como comodín y utilizar.. para descenso recursivo.
Cada partido vuelve con tres piezas. La ruta normalizada utiliza notación de soporte para cada paso, lo que elimina cualquier ambigüedad sobre las teclas con caracteres inusuales. El puntero JSON sigue el estilo de barra de RFC 6901, que muchas herramientas de parche y validación esperan. El valor es los datos emparejados, ya sea un número, una cadena, un objeto o una matriz.
El documento puede ser de hasta 2 MB, con un máximo de 80.000 nodos y 60 niveles de anidación. La consulta se ejecuta en un trabajador de fondo en tu navegador, por lo que la página se mantiene sensible y puede cancelar un largo plazo.
Errores comunes a evitar
No pega expresiones de filtro como [?(@.price > 10)]. Los caracteres?, paréntesis, @ y el signo de retroceso son rechazados para que ningún script pueda ejecutarse. Selecciona el conjunto más amplio en su lugar y acotarlo en tu propio código o con una rebanada.
Recuerda que las secciones excluyen el índice final, por lo que [0:2] devuelve posiciones 0 y 1, no tres elementos. También comprueba si tus datos comienzan con un objeto o una matriz. Una ruta escrita para $.items[0] no encontrará nada si el documento es en sí mismo una matriz, donde $[0] es correcto.
Por último, tenga cuidado con el descenso recursivo en archivos grandes. Una consulta como $..* puede producir más coincidencias de las que esperas, y la herramienta se detiene por encima de 10.000 coincidencias.
Consejos útiles y limitaciones
- Comienza con una ruta de propiedad simple antes de añadir descenso recursivo o comodines.
- Las consultas regresan a 10.000 coincidencias. Estrecha las consultas amplias cuando un documento es grande.
- Copia el puntero JSON de una coincidencia cuando necesite hacer referencia a la misma ubicación en un parche JSON o un mensaje de error de esquema.
- Construye un selector largo paso a paso, ejecutando la consulta después de cada segmento añadido, de modo que puedas ver exactamente dónde una ruta deja de coincidir.
Preguntas frecuentes
¿Este probador JSONPath ejecuta filtros JavaScript?
No. Las expresiones y los filtros del script están desactivados. Usa selectores de propiedades compatibles, índices, comodines, uniones, cortes y descenso recursivo.
¿Puedo ver de dónde vienen cada partido de JSONPath?
Sí. Cada resultado incluye su ruta normalizada, JSON Pointer y el valor correspondiente.
¿Cuál es la diferencia entre el camino y el puntero en cada resultado?
La ruta es una JSONPath normalizada en notación de soporte, como $['store']['books'][0]. El puntero es la misma ubicación escrita en forma de puntero JSON, como /store/books/0. Ambos identifican un nodo exacto.
¿Puedo seleccionar varias propiedades en una consulta?
Sí. Usa un sindicato entre paréntesis, por ejemplo $.store.books[*]['id','title'], para devolver ambos campos de cada libro en una sola carrera.
¿Qué tan grande puede ser mi documento JSON?
La entrada puede ser de hasta 2 MB, con no más de 80.000 nodos y 60 niveles de anidación. Los documentos más grandes deben ser recortados o divididos antes de la consulta.
Las consultas se ejecutan localmente y no ejecutan scripts ni envían a JSON a un servidor.
Lee nuestra política de privacidad · Acerca de ToolWorld Online