Ir al contenido principal
Bethemesh

Probador JSONPath

Consulta datos JSON con una expresión JSONPath simple. El procesamiento se realiza directamente en tu navegador.

  • Portapapeles
  • Exportar

Integrar este widget

Personaliza el aspecto, comprueba la vista previa y copia el código.

Vista previa

Tipo de código de integración

Código para copiar

Se adapta a tu página y Bethemesh ajusta su tamaño automáticamente.

Expresión

¿Te ha resultado útil esta herramienta?

¿Cómo funciona esta herramienta?

Este testador selecciona un valor de un documento JSON mediante una ruta simple. Te permite localizar un campo anidado, comprobar un índice de array o investigar una propiedad ausente en una respuesta API copiada. El resultado se muestra como JSON: los objetos conservan su estructura, las cadenas mantienen sus comillas y null se distingue de la ausencia de coincidencias. La evaluación ocurre en tu navegador. La herramienta no consulta una URL de API ni envía el documento a un servicio de consultas.

Empieza la ruta con $, que representa todo el documento. La notación con puntos selecciona propiedades ordinarias, como $.user.name. Un entero entre corchetes selecciona un elemento del array empezando por cero. Solo se admiten índices enteros no negativos: un array con tres elementos tiene las posiciones 0, 1 y 2.

Escribe las claves con espacios, puntos o guiones entre comillas dentro de corchetes. $["a.b"] selecciona el nombre literal a.b, mientras que $.a.b selecciona b dentro de a. Se aceptan comillas simples y dobles. Los caracteres especiales requieren las secuencias de escape reconocidas por el selector.

Es un subconjunto de navegación, no una implementación completa de RFC 9535. Los filtros, comodines, segmentos de arrays, índices negativos y búsqueda recursiva se rechazan explícitamente. Sustituye $..name por una ruta exacta: no se interpreta como búsqueda global. Una expresión compatible selecciona como máximo un valor, no una lista de nodos normalizada.

El navegador analiza los valores con los tipos JSON de JavaScript. Los números fuera de su precisión pueden redondearse al leerlos y serializar la salida. Representa los identificadores grandes como cadenas. Solo se recorren propiedades propias del documento: un nombre heredado como constructor no se convierte en una coincidencia artificial.

Cómo utilizar esta herramienta

  1. Proporciona JSON válido

    Pega el cuerpo JSON completo sin cabeceras HTTP ni delimitadores Markdown. Se admiten arrays en la raíz; puedes recorrerlos directamente con $[0].

  2. Construye una ruta exacta

    Empieza por $, añade propiedades una a una y usa corchetes para índices o nombres especiales. Los filtros copiados de otro motor no son compatibles aquí.

  3. Interpreta la selección

    Ejecuta la expresión y comprueba valor y tipo JSON. Cambiar el documento o la ruta oculta el resultado anterior para evitar reutilizar una selección desactualizada.

Casos de uso

Comprobar un campo de una respuesta API

Apunta a un valor como $.user.id antes de implementar la extracción en tu aplicación. El testador no contacta con el servidor ni comprueba la actualidad de la respuesta pegada.

Revisar posiciones de un array

Selecciona la primera entrada con [0] y después otro índice conocido. Una posición fuera de los límites devuelve ausencia de coincidencia, sin crear un elemento sustituto.

Investigar un nombre con punto

Compara la notación con puntos y una clave entre comillas para distinguir objetos anidados de una propiedad cuyo nombre contiene realmente ese separador.

Ejemplos

Seleccionar una clave con punto y otra con espacio

El primer corchete selecciona a.b como nombre completo; [0] elige el primer objeto y el último corchete selecciona quoted key. La salida es una cadena JSON válida con comillas.

Entrada

{"a.b":[{"quoted key":"Ada"}]}
$["a.b"][0]['quoted key']

Resultado

"Ada"

Excluir una propiedad heredada

El documento vacío no contiene constructor como propiedad propia. El testador devuelve el marcador de ausencia, aunque los objetos JavaScript suelen heredar ese nombre mediante su prototipo.

Entrada

{}
$.constructor

Resultado

[]

Consejos y buenas prácticas

  • Comprueba primero el documento entero con $ y añade un segmento cada vez para localizar el paso exacto en el que desaparece la coincidencia.
  • [] puede indicar una ausencia de coincidencias o un array vacío seleccionado. Examina el elemento padre si necesitas distinguirlos.
  • null es un valor presente; una ruta inexistente no selecciona nada. Mantén separados ambos casos al diseñar las reglas de validación.
  • Utiliza XPath para consultar XML. Cambiar la extensión de un archivo no transforma XML en una estructura JSON.

Fuentes y referencias

Preguntas frecuentes

¿Por qué se rechazan mi filtro o comodín JSONPath?

El testador solo implementa rutas exactas de propiedades e índices. Rechaza la sintaxis incompatible en lugar de ofrecer resultados incompletos presentados como conformes con toda la norma.

¿Cómo selecciono una propiedad cuyo nombre tiene un punto?

Escribe el nombre completo entre comillas dentro de corchetes, por ejemplo $["a.b"]. La expresión $.a.b representa dos niveles de objetos y no selecciona esa misma clave literal.

¿Los índices de array empiezan en uno o en cero?

En cero. [0] selecciona la primera entrada y [1] la segunda. No se admiten índices negativos, decimales ni segmentos; una posición inexistente produce el marcador de ausencia [].

¿Por qué la cadena seleccionada incluye comillas?

La salida conserva el tipo JSON: "Ada" es una cadena válida, mientras que Ada sin comillas no constituye JSON válido. Los objetos y arrays se serializan con sangría para facilitar la lectura.

Herramientas relacionadas

Herramientas similares o complementarias a esta.

Herramientas similares

Formatea, minimiza y valida un documento JSON para hacerlo más legible o compacto.

DesarrolloDestacadaUsar esta herramienta

Valida un documento JSON con un esquema y localiza cada error con precisión.

DesarrolloDestacadaUsar esta herramienta

Prueba una expresión XPath sobre XML e inspecciona inmediatamente los resultados coincidentes.

DesarrolloUsar esta herramienta