JSON Path Finder

O subconjunto de JSONPath que esta ferramenta avalia

JSONPath nunca teve uma especificação única na origem, e cada biblioteca implementou um recorte um pouco diferente. Por isso vale dizer exatamente o que é avaliado aqui, em vez de prometer "JSONPath completo". O motor cobre a raiz, o acesso a filhos por ponto e por colchete, índices (inclusive negativos, contados do fim), fatias com passo, curinga, descida recursiva, união e filtros com comparação, existência e operadores lógicos.

Dentro de um filtro, @ é o item sendo testado e $ é a raiz do documento, o que permite comparar um campo com um valor que mora em outro lugar, como em $..book[?(@.price < $.expensive)]. Também funciona @.campo.length para o tamanho de arrays e de strings. Quando a consulta usa algo fora dessa lista, a ferramenta acusa erro com posição em vez de devolver zero resultados silenciosamente.

• Raiz: $
• Filho: .nome, ['nome'] e ["nome"]
• Índice: [0] e [-1] (do fim para o começo)
• Fatia: [1:3], [:2], [2:] e [0:6:2] (passo positivo)
• Curinga: .* e [*]
• Descida recursiva: .. antes de uma chave, de * ou de um colchete
• União: [0,2] e ['nome','outra']
• Filtro: [?(@.preco < 10)] com ==, !=, <, <=, >, >=, &&, ||, ! e parênteses
• Filtro por existência: [?(@.isbn)]
• Dentro do filtro: @, $, @.campo.length, números, textos, true, false e null

Do valor na tela para o caminho no código

Boa parte do trabalho real não é escrever a consulta, é descobrir o endereço de um campo que você está vendo num payload. A árvore resolve isso: ela abre sob demanda, então documentos grandes não travam a aba, e cada nó clicado preenche a consulta com o caminho concreto dele. A busca por chave ou valor faz o mesmo atalho quando você sabe o nome do campo mas não onde ele está enterrado.

Com o nó selecionado, o mesmo caminho aparece em cinco escritas. JSONPath serve para ferramentas de teste e de transformação; a notação de ponto é a usada por utilitários como o _.get; os acessores JavaScript e Python colam direto no código; e a expressão jq serve para a linha de comando. Chaves com espaço, hífen ou símbolo já saem escapadas na forma correta de cada dialeto, que é justamente onde o caminho escrito de cabeça costuma quebrar.

O que não é avaliado, e por quê

Expressões de script, como o clássico [(@.length-1)], não são executadas: avaliar código arbitrário do usuário para resolver um caminho é um risco desnecessário, e o caso de uso quase sempre é "o último item", que aqui se escreve [-1]. Também ficam de fora comparação por expressão regular, funções de agregação e fatia com passo negativo. Em todos esses casos você recebe uma mensagem dizendo o que não é suportado e onde, o que é mais útil do que uma lista vazia.

Vale lembrar que motores diferentes divergem em detalhes reais: alguns aplicam filtro só a arrays, outros também a objetos (aqui, aos dois); alguns ordenam o resultado da descida recursiva de forma diferente; alguns aceitam chaves sem aspas dentro de colchetes (aqui também). Antes de fixar uma consulta em produção, confirme o comportamento na biblioteca que o seu projeto usa. Para manter a página fluida, listas de resultados e de nós têm um teto, sinalizado quando é atingido.