DiagramPreview
Analisador básicoNo AILocal previewDebuggingExport

Testador de filtro jq

Cole conteúdo para Testador de filtro jq e gere uma prévia local revisável para depurar configurações, respostas de API, arquivos de SEO e snippets gerados por AI.

Exemplos
Filtered JSONPronto
Your preview will appear here.

Continue com uma ferramenta relacionada

Leve esta prévia para um fluxo próximo para converter, depurar ou exportar.

SQL to ER Diagram

Convert CREATE TABLE SQL into a Mermaid ER diagram.

Abrir
JSON Schema Visualizer

Inspect JSON Schema properties, types, required fields, and composition groups.

Abrir
Prévia de formulário JSON Schema

Prévia de formulário JSON Schema: Pré-visualize e depure esta fonte em uma superfície local para documentação técnica.

Abrir

Como usar

  1. 1Put the jq filter on the first line, then add --- and the JSON payload.
  2. 2Start with simple selectors such as .items[] before adding maps, pipes, or object construction.
  3. 3Check the filtered result and rows before copying the expression into scripts or docs.
  4. 4Verify complex filters with real jq when they will run in CI or production automation.

Casos de uso

API JSON filteringSupport script reviewCI snippet validationAI jq output checkingDocumentation examples

FAQ

Why does the input use ---?

The separator keeps the jq filter separate from the JSON document being inspected.

Is this full jq?

No. It covers common preview cases. Use jq itself for advanced functions, modules, streaming, and production automation.

How should I debug a jq filter?

Start with the smallest selector that returns data, then add pipes and mapping one step at a time.

jq Filter Tester previews common jq-style filters against JSON so you can inspect API payloads and generated JSON without switching tools.

It is useful for support scripts, CI checks, documentation examples, and AI-generated JSON transformations that need quick verification.

The preview shows filtered output and result rows for common filters; final production behavior should still be verified with jq in your runtime environment.

Demo: extract failed API checks from JSON

jq filters are easiest to review when the input includes both matching and non-matching rows. That makes it clear whether the filter is too broad or too narrow.

  • Start with .checks[] to inspect item shape.
  • Add select(.status != "ok") only after confirming the field name.
  • Build a small output object when the result will become a report.
.checks[] | select(.status != "ok") | {name, status, duration}
---
{
  "checks": [
    {"name": "db", "status": "ok", "duration": 32},
    {"name": "api", "status": "failed", "duration": 914}
  ]
}

Debug pattern: build jq filters in small steps

Most jq mistakes come from jumping straight to a dense one-liner. For logs, API payloads, and CI artifacts, build the filter one pipe at a time and check the intermediate shape.

  • Start with keys, length, or a single array selector before adding conditions.
  • Use select(...) only after confirming the field path exists.
  • Return compact objects for reporting instead of dumping entire nested records.
.checks[]
| select(.status == "failed")
| {name, status, duration_ms, owner: .labels.team}

Checklist de revisão para Testador de filtro jq

Use Testador de filtro jq para inspecionar visualmente conteúdo de origem antes de publicar documentação, notas de PR, incidentes ou handoffs. Testador de filtro jq: Pré-visualize e depure esta fonte localmente.

Antes de exportar, confira legibilidade, relações, dados sensíveis e se a prévia ainda faz sentido após editar a entrada.

Limites e solução de problemas

Se a prévia falhar, reduza a entrada ao menor exemplo completo, valide a sintaxe e adicione as partes de volta aos poucos.

Trate a prévia como superfície de revisão, não como fonte de verdade. Resultados críticos ainda exigem validação humana.

Entradas de exemplo

  • Extract emails: .users[].email --- { "users": [ {"id": 1, "email": "ada@example.com"}, {"id": 2, "email": "lin@example.com"} ] }
  • First order total: .orders[0].total --- {"orders":[{"id":"ord_1","total":49.9},{"id":"ord_2","total":19.5}]}
  • Map field: map(.name) --- [{"name":"api"},{"name":"worker"},{"name":"web"}]

Maturidade da ferramenta

Analisador básico

Analisador básico

Esta ferramenta prioriza inspeção rápida de estrutura. Use para revisão e depuração, depois valide resultados críticos.

O rótulo indica se a ferramenta é melhor para exportação estável, depuração, análise rápida ou geração com AI.