O que é o Localizador de Caminho JSON?

O Localizador de Caminho JSON é uma ferramenta interativa que ajuda você a navegar e consultar estruturas de dados JSON. Seja você um desenvolvedor trabalhando com APIs, um engenheiro de QA testando endpoints, ou um analista de dados explorando conjuntos de dados, esta ferramenta facilita encontrar o caminho exato para qualquer dado no seu JSON.

O que é JSONPath?

JSONPath é uma linguagem de consulta para JSON, similar ao XPath para XML. Ela permite que você especifique caminhos para elementos dentro de um documento JSON usando uma sintaxe de expressão simples. Por exemplo, $.store.book[0].title refere-se ao título do primeiro livro em um objeto de loja.

Dois Modos Poderosos

Encontrar Caminho

Clique em qualquer nó na árvore visual para ver instantaneamente sua expressão JSONPath. Perfeito para identificar rapidamente o caminho que você precisa.

Avaliar

Digite uma expressão JSONPath e veja os resultados correspondentes imediatamente. Ótimo para testar consultas antes de usá-las no seu código.

Seus Dados Permanecem Privados

Processamento 100% no Cliente: Todo o processamento acontece no seu navegador. Seus dados JSON nunca saem do seu dispositivo, e não coletamos ou armazenamos nenhuma informação que você inserir.

Sem uploads — Seus dados JSON nunca saem do seu dispositivo
Sem rastreamento — Não coletamos ou armazenamos nenhum dado que você inserir
Privacidade completa — Tudo funciona localmente no seu navegador

Como Usar o Localizador de Caminho JSON

Começando

Carregue Seus Dados JSON

Cole seus dados JSON no painel de entrada à esquerda, ou clique no botão Exemplo para carregar dados de exemplo. Você também pode usar o botão Carregar para carregar um arquivo .json do seu dispositivo.

Visualize a Estrutura da Árvore

A visualização de árvore à direita exibirá automaticamente a estrutura JSON analisada com tipos de dados com código de cores e nós recolhíveis.

Clique para Obter Caminhos

Clique em qualquer chave, valor ou elemento de matriz na visualização de árvore. A barra de caminho mostrará a expressão JSONPath para esse nó, pronta para copiar.

Encontrando Caminhos (Modo Encontrar Caminho)

O modo Encontrar Caminho é perfeito para descobrir expressões JSONPath através de exploração visual:

Certifique-se de que o modo Encontrar Caminho está selecionado na barra de ferramentas
Clique em qualquer chave, valor ou elemento de matriz na visualização de árvore
A barra de caminho mostrará a expressão JSONPath para esse nó
Clique em Copiar para copiar o caminho para sua área de transferência

Avaliando Expressões (Modo Avaliar)

O modo Avaliar permite que você teste consultas JSONPath e veja resultados em tempo real:

Alterne para o modo Avaliar usando o botão de alternância da barra de ferramentas
Digite uma expressão JSONPath no campo de entrada (ex: $.store.book[?(@.price < 10)])
Pressione Enter ou clique no botão Executar
Visualize os resultados correspondentes abaixo, incluindo o número de correspondências
Clique em Copiar para copiar os resultados

Dica Profissional: Use o botão de alternância Ponto / Colchete para alternar entre estilos de notação. A notação de ponto ($.store.book[0].title) é mais limpa, enquanto a notação de colchete ($['store']['book'][0]['title']) funciona com caracteres especiais em chaves.

Recursos

Visualização de Árvore Interativa

Seu JSON é exibido como uma árvore recolhível com tipos de dados com código de cores para fácil navegação.

Objetos com crachás roxos (contagem de chaves)
Matrizes com crachás verdes (contagem de elementos)
Cores distintas para strings, números, booleanos e nulo
Controles de expandir/recolher para estruturas grandes

Clique para Obter Caminho

Simplesmente clique em qualquer nó da árvore para obter instantaneamente sua expressão JSONPath.

Atualizações de caminho em tempo real
Cópia com um clique para a área de transferência
Funciona com estruturas aninhadas
Suporta ambos os estilos de notação

Avaliador JSONPath

Teste expressões JSONPath e veja resultados imediatamente com suporte completo de sintaxe.

Acesso a filhos e curingas
Indexação e fatiamento de matriz
Busca recursiva
Filtragem avançada

Sintaxe JSONPath Suportada

O avaliador suporta uma gama abrangente de recursos JSONPath:

Recurso	Sintaxe	Exemplo
Acesso a Filhos	`$.key` ou `$['key']`	`$.store.name`
Indexação de Matriz	`$[index]`	`$.book[0]`, `$.book[-1]`
Curingas	`$.` ou `$[]`	`$.store.`, `$.book[]`
Busca Recursiva	`$..`	`$..author`
Fatiamento de Matriz	`$[start:end:step]`	`$.book[0:3]`, `$.book[0:6:2]`
Filtros	`[?(@.field operator value)]`	`$.book[?(@.price < 10)]`

Ferramentas Adicionais

Botão de Alternância de Notação

Alterne entre notação de ponto e notação de colchete com um único clique. Escolha o estilo que funciona melhor para seu caso de uso.

Cola de Referência JSONPath

Clique no botão ? para abrir uma tabela de referência rápida com expressões JSONPath comuns e suas descrições.

Controles de Árvore Inteligentes

Use os botões Expandir Tudo e Recolher Tudo para navegar rapidamente em estruturas JSON grandes.

Perguntas Frequentes

O que é uma expressão JSONPath?

Uma expressão JSONPath é uma string que descreve um caminho para um ou mais elementos em um documento JSON. Ela sempre começa com $ (o elemento raiz) e usa pontos ou colchetes para navegar mais profundamente na estrutura.

Exemplo: $.users[0].name obtém o nome do primeiro usuário na matriz de usuários.

Qual é a diferença entre notação de ponto e colchete?

Notação de Ponto

$.store.name

Mais curta e fácil de ler
Funciona apenas com chaves alfanuméricas simples
Não consegue lidar com caracteres especiais

Notação de Colchete

$['store']['name']

Funciona com qualquer chave
Lida com caracteres especiais, espaços, hífens
Mais verbosa, mas mais flexível

Como faço para filtrar elementos de matriz?

Use a sintaxe de filtro [?(@.field operator value)] onde @ representa o elemento atual sendo avaliado.

Exemplos de filtro comuns:

$.products[?(@.price < 50)] — produtos mais baratos que 50
$.users[?(@.active == true)] — apenas usuários ativos
$.items[?(@.category == 'electronics')] — itens em uma categoria específica
$.orders[?(@.quantity >= 10)] — pedidos com 10 ou mais itens

O que o operador .. faz?

O duplo-ponto (..) realiza uma busca recursiva em toda a estrutura JSON, examinando cada nível de aninhamento.

Exemplo: $..name encontra todos os valores com a chave "name" independentemente de onde apareçam na hierarquia — seja no nível raiz, aninhados em objetos, ou profundamente dentro de matrizes.

Nota de Desempenho: Buscas recursivas podem ser lentas em documentos JSON muito grandes, pois examinam cada nó da árvore.

Posso usar índices de matriz negativos?

Sim. Índices negativos contam a partir do final da matriz, facilitando o acesso a elementos de trás para frente sem saber o comprimento da matriz.

$.array[-1] retorna o último elemento
$.array[-2] retorna o penúltimo elemento
$.array[-3] retorna o terceiro elemento do final

Meus dados estão seguros?

Absolutamente. Toda a análise JSON e avaliação JSONPath acontece inteiramente no seu navegador usando JavaScript. Seus dados nunca saem do seu dispositivo.

Sem uploads de servidor — tudo funciona no lado do cliente
Sem armazenamento de dados — nada é salvo após você fechar a página
Sem rastreamento ou análise do seu conteúdo JSON
Privacidade e segurança completas

Qual é o tamanho máximo de JSON suportado?

Não há limite rígido imposto pela ferramenta, mas arquivos JSON muito grandes podem impactar o desempenho do navegador devido à renderização de árvore e manipulação do DOM.

Desempenho Ideal < 1 MB

Pode Ficar Lento 1-10 MB

Problemas de Desempenho > 10 MB

Recomendação: Para melhor desempenho, mantenha seu JSON com alguns megabytes. Se você estiver trabalhando com arquivos muito grandes, considere extrair e testar seções menores.

Expressão	Descrição
`$`	Objeto raiz
`$.key`	Propriedade filha
`$..key`	Busca recursiva
`$.arr[0]`	Índice do array
`$.arr[-1]`	Último elemento
`$.arr[*]`	Todos os elementos
`$.arr[0:3]`	Fatia do array
`$.arr[?(@.price<10)]`	Expressão de filtro
`$.obj.*`	Todos os valores