JSONPath — Um fork do JSONPath de http://goessner.net/articles/JsonPath/ | Kitploit

### ESM (Navegadores modernos)

Você também pode usar imports de módulos ES6 (para navegadores modernos):```html
<script type="module">

import {
    JSONPath
} from './node_modules/jsonpath-plus/dist/index-browser-esm.js';

const result = JSONPath({path: '...', json: {}});

</script>

path (obrigatório) - A expressão JSONPath como uma (normalizada ou não normalizada) string ou array
json (obrigatório) - O objeto JSON a avaliar (seja do tipo null, boolean, number, string, object ou array).
autostart (padrão: true) - Se isto for fornecido como false, pode-se chamar o método evaluate manualmente.
flatten (padrão: false) - Indica se o array de resultados retornado será achatado para um array de uma única dimensão.
resultType (padrão: "value") - Pode ser a forma sem diferenciar maiúsculas de minúsculas de "value", "path", "pointer", "parent" ou "parentProperty" para determinar respectivamente se os resultados devem ser retornados como os valores dos itens encontrados, como seus caminhos absolutos, como JSON Pointers para os caminhos absolutos, como seus objetos pai, ou como o nome da propriedade do pai. Se definido como "all", todos esses tipos serão retornados em um objeto com o tipo como nome da chave.
sandbox (padrão: {}) - Mapa chave-valor de variáveis que estarão disponíveis para avaliações de código, como expressões de filtro. (Observe que o caminho e o valor atuais também estarão disponíveis para essas expressões; consulte a seção Sintaxe para detalhes.)
wrap (padrão: true) - Indica se os resultados devem ou não ser envolvidos em um array. Se wrap for definido como false e nenhum resultado for encontrado, undefined será retornado (em vez de um array vazio quando wrap for definido como true). Se wrap for definido como false e um único resultado não-array for encontrado, esse resultado será o único item retornado (não dentro de um array). Um array ainda será retornado se vários resultados forem encontrados, no entanto. Para evitar ambiguidades (no caso em que seja necessário distinguir entre um resultado que é uma falha e um que é um array vazio), é recomendável alterar o padrão para false.
eval (padrão: "safe") - Método de avaliação de script. safe: No navegador, usará um mecanismo de script mínimo que não usa eval nem Function e satisfaz a Política de Segurança de Conteúdo. No NodeJS, não tem efeito e é equivalente ao native, pois scripting é seguro lá. native: usa os recursos nativos de scripting. Ou seja, eval ou Function inseguros no navegador e vm.Script no nodejs. false: Desabilita as expressões de avaliação de JavaScript e lança exceções quando tais expressões são tentadas. callback [ (code, context) => value]: Uma implementação personalizada que é chamada com code e context como argumentos para retornar o valor avaliado. class: Uma classe criada com code como argumento do construtor e o código é avaliado chamando com . ``
ignoreEvalErrors (padrão: false) - Ignora erros encontrados durante a avaliação do script.
parent (padrão: null) - No caso de uma consulta poder ser feita para retornar o nó raiz, isto permite que o pai desse nó raiz seja retornado nos resultados.
parentProperty (padrão: null) - No caso de uma consulta poder ser feita para retornar o nó raiz, isto permite que o parentProperty desse nó raiz seja retornado nos resultados. Pode ser um nome de propriedade do tipo string ou um índice numérico de array.
callback (padrão: (nenhum)) - Se fornecido, um callback será chamado imediatamente após a recuperação de um valor de ponto final. Os três argumentos fornecidos serão o valor do payload (de acordo com resultType), o tipo do payload (se é um "value" normal ou um "property" name), e um objeto de payload completo (com todos os resultTypes).
otherTypeCallback (padrão: <Uma função que lança um erro quando @other() é encontrado>) - Na atual ausência de suporte a JSON Schema, pode-se determinar tipos além dos tipos embutidos adicionando o operador @other() ao final de sua consulta. Se tal caminho for encontrado, o otherTypeCallback será invocado com o valor do item, seu caminho, seu pai e o nome da propriedade de seu pai, e deve retornar um booleano indicando se o valor fornecido pertence ou não ao tipo "other" (ou pode lidar com transformações e retornar false).

e a seguinte representação XML:```xml
<store>
    <book>
        <category>reference</category>
        <author>Nigel Rees</author>
        <title>Sayings of the Century</title>
        <price>8.95</price>
    </book>
    <book>
        <category>fiction</category>
        <author>Evelyn Waugh</author>
        <title>Sword of Honour</title>
        <price>12.99</price>
    </book>
    <book>
        <category>fiction</category>
        <author>Herman Melville</author>
        <title>Moby Dick</title>
        <isbn>0-553-21311-3</isbn>
        <price>8.99</price>
    </book>
    <book>
        <category>fiction</category>
        <author>J. R. R. Tolkien</author>
        <title>The Lord of the Rings</title>
        <isbn>0-395-19395-8</isbn>
        <price>22.99</price>
    </book>
    <bicycle>
        <color>red</color>
        <price>19.95</price>
    </bicycle>
</store>

Observe que os exemplos de XPath abaixo não distinguem entre recuperar elementos e seu conteúdo de texto (exceto quando útil para comparações ou para evitar ambiguidade). Nota: para testar os exemplos de XPath (incluindo os 2.0), esta demonstração pode ser útil (defina para xml ou xml-strict).| XPath | JSONPath | Resultado | Observações | |---|---|---|---| | /store/book/author | $.store.book[*].author | Os autores de todos os livros na loja | Também pode ser representado sem o $. como store.book[*].author (embora isso não esteja presente na especificação original); note que alguns literais de caractere ($ e @) exigem escape, no entanto | | //author | $..author | Todos os autores | | | /store/* | $.store.* | Todas as coisas na loja, que são seus livros (um array de livros) e uma bicicleta vermelha (um objeto de bicicleta). | | | /store//price | $.store..price | O preço de tudo na loja. | | | //book[3] | $..book[2] | O terceiro livro (objeto de livro) | | | //book[last()] | $..book[(@.length-1)]
$..book[-1:] | O último livro em ordem. | Para acessar uma propriedade com um caractere especial, utilize [(@['...'])] para o filtro (este recurso específico não está presente na especificação original) | | //book[position()<3] | $..book[0,1]
$..book[:2] | Os dois primeiros livros | | | //book/*[self::category\|self::author] or //book/(category,author) in XPath 2.0 | $..book[0][category,author] | As categorias e autores de todos os livros | | | //book[isbn] | $..book[?(@.isbn)] | Filtrar todos os livros que possuem um número ISBN | Para acessar uma propriedade com um caractere especial, utilize [?@['...']] para o filtro (este recurso específico não está presente na especificação original) | | //book[price<10] | $..book[?(@.price<10)] | Filtrar todos os livros mais baratos que 10 | | | //*[name() = 'price' and . != 8.95] | $..*[?(@property === 'price' && @ !== 8.95)] | Obter todos os valores de propriedade de objetos cuja propriedade é price e que não seja igual a 8.95 | Com @ puro permitindo filtrar objetos por valor de propriedade (não necessariamente dentro de arrays), você pode adicionar ^ após a expressão para obter o objeto que possui as propriedades filtradas | | / | $ | A raiz do objeto JSON (ou seja, o próprio objeto inteiro) | Para obter um $ literal (sozinho ou em qualquer lugar no caminho), você deve usar o escape com crase | | //*/*\|//*/*/text() | $..* | Todos os Elementos (e texto) abaixo da raiz em um documento XML. Todos os membros de uma estrutura JSON abaixo da raiz. | | | //* | $.. | Todos os Elementos em um documento XML. Todos os componentes pais de uma estrutura JSON incluindo a raiz. | Este comportamento não foi especificado diretamente na especificação original | | //*[price>19]/.. | $..[?(@.price>19)]^ | Pai dos itens específicos com preço maior que 19 (ou seja, o valor da loja como pai da bicicleta e o array de livros como pai de um livro individual) | Pai (circunflexo) não está presente na especificação original | | /store/*/name() (in XPath 2.0) | $.store.*~ | Os nomes das propriedades do sub-objeto da loja ("book" e "bicycle"). Útil com propriedades curinga. | Nome de propriedade (til) não está presente na especificação original | | /store/book[not(. is /store/book[1])] (in XPath 2.0) | $.store.book[?(@path !== "$['store']['book'][0]")] | Todos os livros exceto aquele no caminho que aponta para o primeiro | @path não está presente na especificação original | | //book[parent::*/bicycle/color = "red"]/category | $..book[?(@parent.bicycle && @parent.bicycle.color === "red")].category | Obtém todas as categorias de livros onde o objeto pai do livro tem um filho bicicleta cuja cor é vermelha (ou seja, todos os livros) | @parent não está presente na especificação original | | //book/*[name() != 'category'] | $..book.*[?(@property !== "category")] | Obtém todos os filhos de "book" exceto os de "category" | @property não está presente na especificação original | | //book[position() != 1] | $..book[?(@property !== 0)] | Obtém todos os livros cuja propriedade (que, por estarmos alcançando o interior de um array, é o índice numérico) não é 0 | @property não está presente na especificação original | | /store/*/*[name(parent::*) != 'book'] | $.store.*[?(@parentProperty !== "book")] | Obtém os netos da loja cuja propriedade pai não é book (ou seja, os filhos da bicicleta, "color" e "price") | @parentProperty não está presente na especificação original | | //book[count(preceding-sibling::*) != 0]/*/text() | $..book.*[?(@parentProperty !== 0)] | Obter os valores de propriedade de todas as instâncias de livro em que a propriedade pai desses valores (ou seja, o índice do array que contém o objeto pai do item de livro) não é 0 | @parentProperty não está presente na especificação original | | //book[price = /store/book[3]/price] | $..book[?(@.price === @root.store.book[2].price)] | Filtrar todos os livros cujo preço seja igual ao preço do terceiro livro | @root não está presente na especificação original | | //book/../*[. instance of element(*, xs:decimal)] (in XPath 2.0) | $..book..*@number() | Obter os valores numéricos dentro do array de livros | @number(), os outros tipos básicos (@boolean(), @string()), outros tipos derivados de baixo nível (@null(), @object(), @array()), o tipo adicionado pelo JSONSchema, @integer(), o tipo composto @scalar() (que também aceita undefined e números não finitos para objetos JavaScript, bem como todos os tipos básicos não-objeto/não-função), o tipo @other(), a ser usado em conjunto com um callback definido pelo usuário (veja otherTypeCallback) e os seguintes tipos não-JSON que podem, no entanto, ser usados com JSONPath ao consultar objetos JavaScript não-JSON (@undefined(), @function(), @nonFinite()) não estão presentes na especificação original | | //book/*[name() = 'category' and matches(., 'tion$')] (XPath 2.0) | $..book.*[?(@property === "category" && @.match(/TION$/i))] | Todas as categorias de livros que correspondem à regex (terminam em 'TION' sem diferenciar maiúsculas de minúsculas) | @property não está presente na especificação original. | | //book/*[matches(name(), 'bn$')]/parent::* (XPath 2.0) | $..book.*[?(@property.match(/bn$/i))]^ | Todos os livros que possuem uma propriedade que corresponde à regex (terminam em 'TION' sem diferenciar maiúsculas de minúsculas) | @property não está presente na especificação original. Nota: Usa o seletor pai ^ no final da expressão para retornar ao objeto pai; sem o seletor pai, ele corresponde aos dois valores de chave isbn. | | | ` (e.g., `$ para corresponder a uma propriedade literalmente chamada $) | Escapa toda a sequência seguinte (para ser tratada como literal) | ` não está presente na especificação original; para obter uma crase literal, use uma crase adicional para escapar |Quaisquer variáveis adicionais fornecidas como propriedades na opção de objeto opcional "sandbox" também estão disponíveis para avaliações (baseadas em parênteses).

runInNewContext

context

JSONPath

Mais Populares

Recursos

Benchmarking

Instalação```shell

Navegador

ESM (Empacotadores)

Propriedades

Métodos de instância

Propriedades e métodos de classe

Sintaxe através de exemplos

Possíveis fontes de confusão para usuários de XPath

Interface de linha de comando

Ideias

Desenvolvimento

Segurança

Licença