Verificar um campo de uma resposta API
Selecione um valor como $.user.id antes de implementar a extração na aplicação. O testador não contacta o servidor nem verifica a atualidade da resposta colada.
Testador JSONPath
Consulte dados JSON com uma expressão JSONPath simples. O processamento é efetuado diretamente no navegador.
- Área de transferência
- Exportar
Dados não enviados
Expressão
JSON inválido ou caminho não suportado. Use nomes de propriedades, chaves entre aspas ou índices inteiros não negativos; filtros, curingas e pesquisa recursiva não são suportados.
Resultado
Esta ferramenta foi útil?
Como funciona esta ferramenta?
Este testador seleciona um valor num documento JSON através de um caminho simples. Permite encontrar um campo aninhado, verificar um índice de array ou compreender a ausência de uma propriedade numa resposta API copiada. O resultado é apresentado como JSON: os objetos mantêm a estrutura, as strings conservam as aspas e null continua distinto da ausência de correspondências. A avaliação acontece no navegador. A ferramenta não consulta um URL de API nem envia o documento para um serviço de pesquisas.
Comece o caminho com $, que representa o documento completo. A notação com pontos seleciona propriedades simples, como $.user.name. Um inteiro entre parênteses retos seleciona uma entrada do array, começando em zero. Apenas são aceites índices inteiros não negativos: um array com três elementos tem as posições 0, 1 e 2.
Escreva as chaves com espaços, pontos ou hífenes entre aspas dentro de parênteses retos. $["a.b"] seleciona o nome literal a.b, enquanto $.a.b seleciona b dentro de a. São aceites aspas simples e duplas. Os caracteres especiais exigem as sequências de escape reconhecidas pelo seletor.
É um subconjunto de navegação, não uma implementação completa de RFC 9535. Filtros, curingas, intervalos de arrays, índices negativos e pesquisa recursiva são rejeitados explicitamente. Substitua $..name por um caminho exato: a expressão não desencadeia uma pesquisa global. Um caminho suportado seleciona, no máximo, um valor, não uma lista normalizada de nós.
O navegador analisa o documento com os tipos JSON de JavaScript. Números fora da precisão disponível podem ser arredondados durante a leitura e a serialização do resultado. Represente grandes identificadores como strings. Só são percorridas propriedades próprias do documento: um nome herdado como constructor não produz uma correspondência artificial.
Como usar esta ferramenta
Forneça JSON válido
Cole o corpo JSON completo, sem cabeçalhos HTTP nem delimitadores Markdown. Arrays na raiz são aceites e podem ser percorridos diretamente com $[0].
Construa um caminho exato
Comece por $, adicione propriedades gradualmente e use parênteses retos para índices ou chaves especiais. Filtros copiados de outro motor não são compatíveis aqui.
Interprete a seleção
Execute a expressão e verifique o valor e o tipo JSON. Alterar o documento ou o caminho oculta o resultado anterior para evitar reutilizar uma seleção desatualizada.
Casos de uso
Confirmar posições de um array
Selecione a primeira entrada com [0] e depois outro índice conhecido. Uma posição fora dos limites devolve ausência de correspondência, sem criar uma entrada substituta.
Investigar um nome com ponto
Compare a notação com pontos e uma chave entre aspas para distinguir objetos aninhados de uma única propriedade cujo nome contém realmente o separador.
Exemplos
Selecionar uma chave com ponto e outra com espaço
O primeiro par de parênteses retos seleciona o nome completo a.b; [0] escolhe o primeiro objeto e o último seleciona quoted key. A saída é uma string JSON válida, incluindo as aspas.
Entrada
{"a.b":[{"quoted key":"Ada"}]}
$["a.b"][0]['quoted key']Resultado
"Ada"Excluir uma propriedade herdada
O documento vazio não tem constructor como propriedade própria. O testador devolve o marcador de ausência, embora os objetos JavaScript normalmente herdem esse nome através do protótipo.
Entrada
{}
$.constructorResultado
[]Dicas e boas práticas
- Verifique primeiro o documento inteiro com $ e adicione um segmento de cada vez para identificar o passo exato em que desaparece a correspondência.
- [] pode representar ausência de correspondências ou um array vazio selecionado. Examine o elemento pai quando precisar de distinguir os casos.
- null é um valor presente; um caminho inexistente não seleciona nada. Mantenha estas situações separadas nas regras de validação.
- Use XPath para consultar XML. Mudar a extensão de um ficheiro não transforma XML numa estrutura JSON.
Fontes e referências
- RFC 9535 — JSONPath: Query Expressions for JSON (abre num novo separador), RFC EditorPágina em inglês
Perguntas frequentes
Porque é rejeitado o meu filtro ou curinga JSONPath?
O testador implementa apenas caminhos exatos com propriedades e índices. Rejeita a sintaxe não suportada em vez de apresentar resultados incompletos como conformes com toda a norma.
Como seleciono uma propriedade com um ponto no nome?
Escreva a chave completa entre aspas dentro de parênteses retos, por exemplo $["a.b"]. A expressão $.a.b descreve dois níveis de objetos e não seleciona essa mesma chave literal.
Os índices dos arrays começam em um ou em zero?
Em zero. [0] seleciona a primeira entrada e [1] a segunda. Índices negativos, fracionários e intervalos não estão disponíveis; uma posição inexistente produz o marcador de ausência [].
Porque inclui aspas a string selecionada?
A saída preserva o tipo JSON: "Ada" é uma string JSON válida, enquanto Ada sem aspas não é JSON válido. Objetos e arrays são serializados com indentação para facilitar a leitura.
Ferramentas relacionadas
Continue com estas ferramentas
Ferramentas semelhantes ou complementares a esta.
Ferramentas semelhantes
Formate, minifique e valide um documento JSON para o tornar mais legível ou compacto.
DesenvolvimentoEm destaqueUtilizar esta ferramenta
Valide um documento JSON com um esquema e localize precisamente cada erro.
DesenvolvimentoEm destaqueUtilizar esta ferramenta
Teste uma expressão XPath num documento XML e inspecione imediatamente os resultados correspondentes.
DesenvolvimentoUtilizar esta ferramenta