Pular para o conteúdo
SPCX Tools

Testador JSONPath

Avalie e teste expressões JSONPath nos seus dados JSON instantaneamente pelo navegador.

Roda localmente — os arquivos não saem do seu dispositivo

Carregando ferramenta…

Como usar: Testador JSONPath

  1. 1Cole ou digite seus dados JSON no painel da esquerda, ou clique em "Sample" para carregar dados de exemplo.
  2. 2Insira sua expressão JSONPath no campo de entrada no topo da página.
  3. 3Clique em qualquer botão de exemplo rápido abaixo do campo para ver padrões comuns de consulta na prática.
  4. 4Veja os resultados, o total de correspondências e os caminhos exatos dos elementos encontrados no painel da direita.

Um testador de JSONPath rápido e privado

Ao trabalhar com dados JSON grandes ou muito aninhados, extrair a informação exata que você precisa pode ser trabalhoso. Este testador de JSONPath oferece um ambiente em tempo real para escrever, testar e depurar suas consultas. Conforme você digita sua expressão, a ferramenta a avalia instantaneamente no seu payload JSON, mostrando tanto os valores extraídos quanto os caminhos exatos onde foram encontrados.

Como este é um avaliador de JSONPath totalmente client-side, todo o processamento ocorre localmente no seu dispositivo. Seus dados JSON nunca são enviados para um servidor. Isso significa que você pode colar com segurança payloads de APIs de produção, exports de banco de dados ou arquivos de configuração sensíveis, sem se preocupar com vazamento de dados ou violações de privacidade.

Principais recursos para desenvolvedores

  • Avaliação em tempo real: Os resultados são atualizados imediatamente ao modificar seus dados JSON ou sua consulta. Não é preciso clicar em botões de envio ou aguardar a resposta do servidor.
  • Parsing seguro: A ferramenta usa um motor de avaliação seguro (eval: 'safe') para processar suas consultas, evitando a execução de códigos maliciosos, mas mantendo suporte total a expressões de filtro complexas.
  • Extração de caminhos: Além de exibir os valores encontrados, a ferramenta gera os caminhos absolutos para cada correspondência. Isso é muito útil se você precisar atualizar esses nós específicos programaticamente depois.
  • Exemplos integrados: Se você não tem familiaridade com a sintaxe, pode carregar um dataset de exemplo e testar várias expressões prontas para ver como os diferentes operadores funcionam.

Como escrever uma consulta JSONPath

O JSONPath usa uma sintaxe específica para navegar por objetos e arrays JSON. Se você deseja testar a lógica de uma expressão JSONPath, é útil entender os operadores fundamentais:

  • $ representa o objeto ou array raiz. Toda expressão JSONPath absoluta começa com este símbolo.
  • @ representa o nó atual sendo processado. É usado principalmente dentro de expressões de filtro.
  • . ou [] são operadores filhos usados para selecionar propriedades. Por exemplo, $.store.book e $['store']['book'] fazem a mesma coisa.
  • .. é o operador de descida recursiva. Ele busca por uma chave específica em qualquer lugar da árvore JSON, independentemente do nível de aninhamento (ex.: $..price encontra todos os preços).
  • * é um curinga que corresponde a todos os elementos em um objeto ou array. Por exemplo, $.store.* seleciona tudo diretamente dentro do objeto store.
  • [?()] aplica uma expressão de filtro. Você pode usar operadores lógicos padrão dentro dela. Por exemplo, $..book[?(@.author == 'Nigel Rees')] encontrará todos os livros escritos por esse autor específico.
  • [start:end:step] permite fatiar arrays, de forma semelhante ao Python. $.store.book[-1:] seleciona o último livro do array.

Casos de uso comuns

Desenvolvimento e depuração de APIs. APIs REST e GraphQL modernas costumam retornar payloads JSON gigantescos. Em vez de escrever códigos temporários para analisar e inspecionar a resposta, você pode colar o payload nesta ferramenta online de JSONPath para verificar rapidamente se a estrutura de dados está correta e se suas consultas extraem os campos certos.

Testes automatizados. Ao escrever testes de integração ou testes end-to-end (usando ferramentas como Postman, RestAssured ou Playwright), frequentemente é necessário validar se valores específicos existem em uma resposta JSON. Usar um testador de JSONPath ajuda a aperfeiçoar a string de consulta antes de fixá-la no código da sua suíte de testes.

Extração e transformação de dados. Se você está migrando dados ou criando pipelines de ETL (Extract, Transform, Load), muitas vezes precisa isolar arrays ou objetos específicos. Você pode usar esta ferramenta para descobrir os caminhos exatos necessários para extrair os dados desejados. Se os dados de origem estiverem em XML, você pode usar primeiro o conversor de XML para JSON, e se precisar formatar dados minificados antes de inspecioná-los, o Formatador de JSON pode ajudar. Você também pode usar a ferramenta Comparar JSON para ver como seus dados mudam antes e depois das transformações.

Perguntas frequentes

O que é JSONPath?
JSONPath é uma linguagem de consulta para dados JSON, semelhante ao uso do XPath para XML. Ele permite selecionar e extrair nós, arrays ou valores específicos de uma estrutura JSON complexa usando uma expressão de string compacta.
Meus dados JSON estão seguros?
Sim. Esta ferramenta funciona de forma totalmente local no seu navegador. Seus dados JSON e consultas nunca são enviados para nenhum servidor, tornando-a perfeitamente segura para testar respostas sensíveis de APIs, arquivos de configuração ou dados proprietários.
Como faço para filtrar dados com base em uma condição específica?
Você pode usar uma expressão de filtro com a sintaxe [?(@.property == 'value')]. Por exemplo, $.store.book[?(@.price < 10)] retornará todos os livros no array store que tenham um preço estritamente menor que 10.
Posso ver a localização exata dos elementos encontrados?
Sim. Abaixo do resultado principal, há uma seção expansível "Paths". Ao abri-la, você verá o JSONPath exato e absoluto de cada elemento encontrado nos seus resultados.
Por que estou recebendo o erro "Invalid JSON"?
O JSON exige uma formatação rigorosa. Certifique-se de que todas as chaves e valores de string estejam entre aspas duplas (não aspas simples) e que não haja vírgula após o último item em um objeto ou array.
Qual especificação JSONPath esta ferramenta usa?
Esta ferramenta usa a popular biblioteca jsonpath-plus, que suporta totalmente a especificação original do JSONPath, além de adicionar alguns recursos estendidos e seguros para consultas mais complexas. Ela avalia expressões com segurança, sem usar a função eval() do JavaScript.

Ferramentas relacionadas

Formatador e Validador de JSONFormate, minifique e valide JSON instantaneamente, com localização clara de erros.Comparar JSONEncontre rapidamente as diferenças entre dois objetos JSON com uma comparação detalhada por path.XML para JSONConverta dados entre os formatos XML e JSON instantaneamente, com controle total sobre atributos e tipos de dados.Codificar e Decodificar Base64Converta textos e arquivos para Base64 e vice-versa, com suporte total a UTF-8 e Base64URL.Base64 para ImagemDecodifique strings Base64 e Data URIs de volta em imagens visíveis e prontas para download instantaneamente no seu navegador.Calculadora ChmodConverta entre caixas de seleção, números octais como 755 e permissões simbólicas como rwxr-xr-x.