Localizador de Caminho JSON

Liste todos os caminhos de um JSON em JSONPath, JavaScript ou jq, clique em um caminho para ver o valor ou digite um para consultá-lo. Roda no navegador.

Valor no caminho

Executa totalmente no seu navegador. Seus dados nunca são enviados.

Ferramentas Relacionadas

Ver Todas

O que é Localizador de caminho JSON?

O Localizador de Caminho JSON mostra o caminho de cada valor de um documento JSON e permite buscar um valor pelo caminho. Os caminhos podem ser exibidos na sintaxe JSONPath ($.store.book[0].title), JavaScript (data.store.book[0].title) ou jq (.store.book[0].title), prontos para colar no código.

Como usar Localizador de caminho JSON

  1. Cole o JSON na caixa JSON de entrada (ou clique em Carregar exemplo).
  2. Navegue pela tabela Todos os caminhos; use a caixa de filtro para buscar por caminho ou valor.
  3. Clique em uma linha para colocar o caminho dela na caixa Caminho e mostrar o valor.
  4. Ou digite um caminho como $.store.book[1].title para consultá-lo diretamente.
  5. Troque a Sintaxe do caminho para copiar os caminhos em JavaScript ou jq.

Exemplo

Entrada
{"store":{"book":[{"title":"A","price":8},{"title":"B","price":12}]}}
Path: $.store.book[1].title
Saída
"B"

A tabela de caminhos lista 9 caminhos, de $ a $.store.book[1].price.

Quando usar Localizador de caminho JSON

Use-o para achar o caminho de um campo que você vê em uma resposta de API grande, gerar acessadores para o código ou conferir onde um valor está. Para consultas que retornam vários valores (curingas, filtros, busca recursiva), use a Consulta JSON.

Como funciona Localizador de caminho JSON

O JSON é lido por um parser estrito que mantém os números exatamente como escritos. A árvore é percorrida em profundidade, montando um JSONPath para cada nó: chaves parecidas com identificadores usam a notação com ponto, outras chaves usam a notação com colchetes e aspas ($['first name']) e os itens de array usam [índice]. Os contêineres são listados com seu tamanho. As buscas aceitam JSONPath com ou sem $, pontos iniciais no estilo jq e notação com colchetes; elas resolvem um local exato (sem curingas nem filtros: use a Consulta JSON para isso). A tabela mostra no máximo 500 linhas por vez; use o filtro em documentos grandes.

Casos de Uso Comuns

  • Achar o acessador JavaScript de um campo bem aninhado de uma API
  • Escrever JSONPath para monitoramento ou asserções de teste
  • Explorar uma estrutura JSON desconhecida
  • Obter caminhos jq para scripts de shell

Nota de Segurança

Tudo roda localmente no seu navegador; o código que você cola não é enviado a nenhum servidor.

Perguntas Frequentes

Qual sintaxe de caminho devo usar?

JSONPath para ferramentas que aceitam JSONPath, JavaScript para código e jq para a linha de comando.

Posso usar curingas como [*]?

Aqui não: o localizador resolve um caminho exato. Use a ferramenta Consulta JSON para curingas e filtros.

E se uma chave tiver espaços ou pontos?

Ela é escrita com a notação de colchetes, por exemplo $['first name'].

Próximos passos recomendados

Explore mais categorias