Playground de jq
| Filtro | Descripción |
|---|---|
| Formatear todo el documento | |
| Iterar sobre cada elemento de un array | |
| Leer un valor anidado por ruta | |
| Conservar solo los elementos que cumplen una condición | |
| Transformar cada elemento de un array | |
| Listar las claves de un objeto | |
| Convertir un objeto en pares clave/valor | |
| Agrupar elementos por un campo y contarlos | |
| Ordenar un array por un campo | |
| Contar los elementos de un array | |
| Dar formato CSV a las filas (activa Salida sin formato) | |
| Codificar una cadena en Base64 (activa Salida sin formato) | |
| Listar las rutas de todos los valores numéricos | |
| Recopilar recursivamente todos los números | |
| Sumar valores con reduce | |
| Leer todas las entradas con entrada nula (prueba varios documentos JSON) |
Detalles técnicos
Cómo funciona el playground de jq
Qué hace la herramienta
El playground de jq ejecuta filtros jq reales sobre tu JSON mientras escribes. jq 1.8 se compila a WebAssembly y se ejecuta en un Web Worker, así que los resultados coinciden exactamente con la herramienta de línea de comandos, incluidos los mensajes de error. Pega JSON, escribe un filtro como .users[] | select(.age > 30) | .name y la salida se actualiza tras una breve pausa. Las opciones se corresponden directamente con los flags de jq: salida sin formato (-r), compacto (-c), slurp (-s), entrada nula (-n), claves ordenadas (-S), sangría con tabulación (--tab) y variables --arg con nombre.
Casos de uso habituales
Los desarrolladores lo usan para prototipar filtros antes de ponerlos en scripts de shell, pipelines de CI y one-liners de Kubernetes o AWS CLI, para explorar respuestas grandes de API y líneas de log, para convertir JSON a CSV con @csv, para remodelar payloads con map, group_by y reduce, y para aprender jq con la chuleta integrada de ejemplos en los que se puede hacer clic.
Entradas, salidas y flags
La entrada puede ser un único documento JSON o varios documentos concatenados, como NDJSON; con Slurp se envuelven en un solo array y con Entrada nula los lees tú mismo mediante input e inputs. Cada resultado se imprime en su propia línea. La salida sin formato imprime las cadenas sin comillas, lo que es necesario para la salida de @csv, @tsv, @base64 y @uri. Los valores pasados con --arg están disponibles dentro del filtro como $name y siempre son cadenas.
Errores comunes y límites
La entrada está limitada a 5 MB y una ejecución se detiene tras 10 segundos para que un filtro infinito no pueda congelar la página. Los números se procesan con la semántica de doble precisión de jq, así que los enteros mayores que 2^53 pueden perder precisión. Aquí no hace falta entrecomillar para el shell: en una terminal, envuelve el filtro entre comillas simples. Este playground no admite módulos de jq, importaciones desde archivos ni variables de entorno.