jq Playground — teste expressões jq online.

É o jq de verdade. A página carrega o jq 1.8.2 compilado para WebAssembly — o programa em C real, 907 KB sem compressão e de 250 a 340 KB pela rede, dependendo de o seu navegador negociar brotli ou gzip — e passa o seu filtro por ele. O selo de versão ao lado das flags é lido desse binário em tempo de execução, não está escrito na página, então não tem como ficar desatualizado. Aqui nada aproxima o comportamento do jq, porque aqui nada o reimplementa: o mesmo código que roda no seu notebook roda na sua aba.

Não. Não existe servidor, nem API, nem log. O jq é baixado uma única vez deste site como arquivo estático e depois roda inteiramente dentro da sua aba — e é exatamente aí que está a diferença em relação a um playground que roda no servidor: no jqplay.org e semelhantes, o JSON que você cola vai para a máquina de outra pessoa para ser avaliado. Aqui você pode colar sem medo saídas de kubectl de produção, respostas de API com tokens dentro e linhas de log com dados de clientes.

Quatro chaves: -r (saída de strings em cru), -s (juntar todo o stream de entrada em um array), -n (rodar uma vez com null como entrada) e -c (compacto, uma linha por resultado). Não estão nesta versão: --arg e --argjson, o carregamento de módulos (-L, include, import — o jq responde "module not found"), --seq, saída colorida, argumentos de arquivo e leitura a partir de uma URL. O --arg pode ser substituído dentro do próprio programa: ("prod") as $ns | … vincula um valor do mesmo jeito.

Quase sempre porque ele usou um builtin que não existe no jq 1.8.2. leaf_paths é o caso clássico — foi removido, e o jq responde "leaf_paths/0 is not defined"; a grafia que funciona é paths(scalars). O mesmo acontece com flags inventadas e com builtins de outras ferramentas (jaq, gojq, JMESPath) que nunca existiram no jq. Um erro de compilação aqui cita a mensagem do próprio jq, com linha, coluna e o trecho com o caret, então você vê exatamente qual token foi rejeitado em vez de adivinhar.

O -s lê todos os valores do stream de entrada em um único array e roda o seu filtro uma vez sobre esse array: 1 2 3 vira [1,2,3]. O -n roda o filtro uma vez com null como entrada e entrega o stream para você pelo gerador inputs, então [inputs] em 1 2 3 também dá [1,2,3] — mas você controla quando cada valor é puxado, e é isso que permite emparelhar valores, pular um registro de cabeçalho ou parar mais cedo. O -s guarda tudo primeiro; o -n com inputs trabalha em stream.

Porque o -r só remove as aspas em volta dos resultados que são strings. Tudo o que não é string — objeto, array, número, booleano ou null — continua sendo impresso como JSON, e é por isso que . em {"a":1} fica idêntico com e sem -r. Se você quer texto a partir de algo que não é string, converta no filtro: tostring, @csv, @tsv, join(",") ou uma string interpolada como "\(.name) → \(.image)".

Monte um array por linha e passe por @csv ou @tsv, e depois ligue o -r para que a linha saia como texto e não como uma string JSON entre aspas. ["web",3] | @csv dá "web",3 — strings entre aspas, números sem nada — e @tsv dá web, depois uma tabulação real, depois 3. Os dois recusam valores aninhados: um array ou objeto dentro de uma linha é erro de execução ("array ([\"a\"]) is not valid in a csv row"), e null vira um campo vazio.

a // b produz a, a menos que a seja false, null, ou não produza saída nenhuma — nesse caso produz b. A pegadinha é que isso não significa "se estiver vazio": no jq o 0 e a string vazia são verdadeiros, então {"a":0} | .a // "fallback" dá 0, e não "fallback". Se você quer mesmo dizer "quando a chave não existe", pergunte isso: if has("a") then .a else "fallback" end.

Não enquanto o valor estiver intocado. O jq 1.8 preserva o literal que você deu, então {"n":9007199254740993} | .n imprime exatamente 9007199254740993 — um número que o JavaScript não consegue representar — e 1.0 continua 1.0 em vez de virar 1. Assim que você faz aritmética, a garantia acaba: .n + 0 vira 9007199254740992, porque a conta passa por um double de 64 bits. Isso é uma propriedade do jq, não do navegador; o jq na linha de comando responde igual.

A entrada é limitada a 2 MB (2.000.000 de bytes) e o painel de resultados mostra as primeiras 200 saídas, sempre com a contagem real ao lado — o "Copy all" continua copiando todas. Um filtro que nunca termina é a única coisa que realmente machuca: o jq roda de forma síncrona nesta aba, então ele trava a página até você recarregar. Se você vai ver um cartão de erro no lugar disso depende da forma. Se o fluxo infinito for coletado — [repeat(1)], [recurse(.a)], length, last —, o jq enche a memória WebAssembly e aborta em um ou dois segundos, e o playground transforma isso em uma mensagem de erro comum. Se ele só fluir, um repeat(1) ou um recurse(.a) pelados continuam rodando: medimos 40 segundos sem nenhum abort. As duas formas para ficar de olho são um repeat sem freio e recurse(.field), que chega em null e depois recursa em null para sempre — escreva recurse(.field?; . != null), ou embrulhe o gerador em limit(n; …).