Testador JSONPath Grátis — Avalie Consultas Online

O Que É um Testador JSONPath?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

Principais Recursos

Exemplos Resolvidos

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

Como Usar o Testador JSONPath

1. 1

   Cole ou envie seu JSON

   Arraste o JSON para a caixa de entrada, cole-o ou clique em Enviar para carregar um arquivo .json / .txt do disco. Formatar JSON reindenta o documento. JSON inválido é sinalizado em linha com uma mensagem do analisador antes de você consultar.

2. 2

   Escolha um motor

   RFC 9535 (o padrão IETF de 2024, sem eval) é o padrão. Troque para Clássico (Goessner) quando estiver executando uma expressão copiada de uma ferramenta mais antiga, como o jsonpath.com, para que os resultados correspondam ao que você viu lá.

3. 3

   Digite sua expressão JSONPath

   O $ inicial já é mostrado para você. Comece com um caminho de filho como .store.book[*].title, um índice como [0], uma descida recursiva como ..author ou um filtro como [?(@.price < 10)]. Os resultados atualizam ao vivo enquanto você digita.

4. 4

   Alterne a vista de resultado

   Valores mostra um array JSON dos valores correspondentes. Caminhos mostra o caminho normalizado de cada correspondência, como $['store']['book'][0]['title']. Ambos os mostra lado a lado para que você possa mapear cada valor à sua localização exata no documento.

5. 5

   Copie o resultado ou compartilhe um permalink

   Copiar resultado coloca a saída na sua área de transferência. Copiar link codifica o JSON, a expressão, o motor e a vista num fragmento de URL (sem upload) para que um colega possa reproduzir a consulta exata localmente na própria máquina.

Erros Comuns de JSONPath

store.book[*].title  →  inválido (sem raiz)

$.store.book[*].title  →  seleciona todos os títulos

$.store.book[0:2]  →  os DOIS primeiros livros, não três

$.store.book[0:3]  →  os três primeiros livros (índices 0,1,2)

Filtro Clássico rodado sob RFC 9535  →  erro de análise ou nós inesperados

Trocar o motor para Clássico (Goessner)  →  reproduz o resultado original

$.store.book.length()  →  erro de análise (não é um segmento RFC 9535 válido)

$.store.book[?length(@.title) > 15]  →  livros com título acima de 15 caracteres

$.store.book[?($.price < 10)]  →  escopo errado

$.store.book[?(@.price < 10)]  →  livros abaixo de 10

$[store][book]  →  seletores de colchete inválidos

$['store']['book']  →  o mesmo que $.store.book

$..price  →  todo price em qualquer ponto da árvore

$.store.book[*].price  →  apenas preços de livros

Quem Usa Esta Ferramenta

Extrair Campos de uma Resposta de API

Extraia IDs de requisição, atributos de recursos aninhados ou uma lista de nomes de um payload JSON sem escrever código de travessia. Construa o caminho aqui contra uma resposta de amostra, confirme que ele retorna exatamente os nós que você quer na vista Valores e depois cole a expressão validada na sua aplicação ou teste.

Escrever Asserções para Testes de Integração

Muitos frameworks de teste e ferramentas de teste de contrato (REST Assured, Karate, Postman) usam JSONPath para fazer asserções sobre corpos de resposta. Rascunhe o caminho da asserção aqui, verifique que ele seleciona o nó certo contra uma resposta real e copie-o para o seu teste — pegando um caminho errado antes que a suíte fique vermelha.

Configurar Transformações de Dados em Pipelines

Kubernetes, AWS Step Functions, Azure Logic Apps e muitas ferramentas de ETL aceitam JSONPath para endereçar campos em payloads de evento. Prototipe o caminho exato contra um evento representativo aqui, confirme que ele resolve e coloque-o na configuração do seu pipeline com a confiança de que aponta para onde você pretende.

Reproduzir um Resultado do jsonpath.com de Forma Privada

Tem uma expressão de um avaliador apoiado em servidor, mas não pode colar seus dados num site de terceiros? Troque para o modo Clássico (Goessner), carregue seu JSON e reproduza o mesmo resultado localmente — nenhum payload deixa o seu navegador, então dados proprietários permanecem na sua máquina.

Migrar Expressões Legadas para o RFC 9535

Está migrando para um sistema que anuncia conformidade com o RFC 9535? Execute uma expressão legada no modo Clássico e depois alterne para o motor RFC 9535 para ver se ela ainda é analisada e corresponde aos mesmos nós. A comparação de motor duplo aponta as diferenças de filtro, união e função que você de outra forma encontraria em produção.

Depurar Por Que um Caminho Retorna os Nós Errados

Um caminho que seleciona demais ou de menos é difícil de raciocinar apenas pelos valores. Troque para a vista Caminhos para ver a localização normalizada de cada correspondência — o índice exato do array, a cadeia exata de membros — e a fatia com erro por um ou a descida recursiva perdida fica óbvia imediatamente.

Ensinar ou Revisar JSONPath

Abra uma expressão funcional contra dados de amostra e percorra-a seletor por seletor, alternando entre Valores e Caminhos para que o aprendiz veja tanto o que é selecionado quanto onde reside. A folha de referência e os exemplos resolvidos dão uma referência estruturada para revisão de código ou integração de novos membros.

Notas de Motor e Algoritmo

Motor RFC 9535 (jsonpath-rfc9535, Sem Dependências)

O motor padrão implementa a gramática do IETF RFC 9535 diretamente: ele tokeniza e analisa a expressão numa árvore de sintaxe abstrata e a interpreta contra o documento. Não há eval nem construtor Function em parte alguma do caminho, então ele é imune à classe de bugs de injeção via eval e roda sob uma Content-Security-Policy estrita.

Motor Clássico (jsonpath-plus, eval Desativado)

O motor Clássico (Goessner) é o jsonpath-plus, fixado numa versão corrigida (>= 10.4.0) e construído com a opção eval explicitamente definida como false. Isso mantém a compatibilidade com o dialeto de Goessner enquanto fecha os vetores de execução remota de código rastreados como CVE-2024-21534 e CVE-2025-1302, que afetavam o caminho de filtro baseado em eval padrão da biblioteca.

Geração de Caminhos Normalizados

Cada correspondência é informada com seu caminho normalizado do RFC 9535 — uma forma canônica usando notação de colchetes com aspas simples ($['store']['book'][0]['title']) e índices de array como inteiros puros. Os caminhos normalizados são estáveis e únicos por nó, então expressões equivalentes produzem caminhos idênticos, dos quais as vistas Caminhos e Ambos dependem para uma identificação inequívoca de resultados.

Chunks de Motor Carregados sob Demanda

Ambos os motores são carregados como chunks de JavaScript separados apenas quando selecionados pela primeira vez, então a página inicial permanece leve e o motor que você não usa nunca é baixado. Trocar de motor reavalia a expressão atual contra o documento atual imediatamente, sem recarregar a página.

Leitura de Arquivos Locais e Formatação de JSON

O botão Enviar usa a API FileReader do navegador para ler um arquivo .json ou .txt na entrada inteiramente no lado do cliente — o arquivo nunca é transmitido. Formatar JSON analisa e reserializa a entrada com indentação de dois espaços, exibindo erros de análise em linha para que JSON malformado seja detectado antes da avaliação.

Permalinks via Fragmento de URL (Nunca Transmitidos)

O estado de compartilhamento é codificado no fragmento location.hash, carregando o JSON, a expressão, o motor ativo e a vista de resultado. Os navegadores nunca incluem o fragmento nas requisições HTTP, então os servidores do go-tools.org recebem zero dados quando um permalink é aberto; a hidratação acontece inteiramente no dispositivo do destinatário.

Boas Práticas de JSONPath

Escolha o Motor que Corresponde ao Seu Alvo

Se o seu sistema downstream anuncia conformidade com o RFC 9535, escreva e valide contra o motor RFC 9535. Se você está reproduzindo ou mantendo uma expressão de uma ferramenta ou biblioteca mais antiga, use Clássico (Goessner). Validar contra o dialeto errado é o motivo mais comum de um caminho que funcionou no testador falhar em produção.

Verifique com a Vista Caminhos, Não Apenas Valores

A vista Valores diz o que correspondeu; a vista Caminhos diz onde. Quando uma consulta retorna valores de aparência correta, ela ainda pode estar selecionando-os da localização errada — uma descida recursiva perdida ou um curinga amplo demais. Confira os caminhos normalizados para confirmar que a expressão atinge exatamente os nós que você pretende.

Atente para o Fim Exclusivo de uma Fatia

[0:2] seleciona os índices 0 e 1, não 0 até 2 — o limite final é exclusivo, assim como no Python e no JavaScript. Erros de fatia por um são o bug de JSONPath mais frequente. Use a vista Caminhos para ler o índice exato de cada elemento selecionado e confirmar o limite antes de entregar.

Prefira um Caminho Explícito à Descida Recursiva Quando Puder

$..price é conveniente, mas corresponde a todo price em qualquer ponto do documento, inclusive os que você não pretendia. Quando você conhece a estrutura, soletre o caminho ($.store.book[*].price) para que a consulta permaneça precisa e previsível à medida que os dados crescem. Reserve o .. para formatos genuinamente irregulares ou desconhecidos.

Mantenha Espaços em Branco e Aspas Consistentes nos Filtros

O RFC 9535 segue sua gramática exatamente para expressões de filtro, enquanto o dialeto clássico é mais permissivo. Escreva filtros de forma limpa — coloque literais de string entre aspas simples ('fiction'), mantenha os operadores espaçados e evite depender de análise leniente — para que a mesma expressão seja avaliada da mesma forma, independentemente de qual motor ou biblioteca acabe executando-a.

Perguntas Frequentes