RabbitJsonAyuda y referencia

INICIO RÁPIDO

Guía de rutas JSON y expresiones de plantillas

Aprende a extraer arrays de JSON y convertir cada elemento en texto con formato. Sigue los ejemplos y pruébalos en RabbitJson.

Extraer un array

Pega JSON e introduce una ruta como data.books. Los elementos aparecen en «Array extraído». Si la raíz es un array, usa $.

Convertir en texto

Escribe una plantilla como ${name}. Revisa el resultado y pulsa Copiar. Para probar datos de muestra, pulsa Cargar ejemplo en la herramienta.

Modos de conversión

Automático

El array y el texto se actualizan automáticamente al editar.

Manual

Pulsa Extraer array, introduce una plantilla y pulsa Convertir texto. Puedes extraer sin plantilla.

Al cambiar los datos

Editar la plantilla conserva el array. En modo Manual, cambiar el JSON o la ruta requiere extraer de nuevo. Los resultados anteriores se borran para evitar copiar texto desactualizado.

Trabajar con JSON grande

Las entradas grandes se muestran sin números de línea. Se procesan todos los datos. La vista previa muestra hasta 200 líneas o 12 000 caracteres y puede cortar un elemento. Copiar o descargar incluye el resultado completo.

El borrador permanece en la pestaña actual. Si no se guarda, deja la página abierta o guarda los datos fuera antes de recargar. Cambiar de idioma conserva el borrador si el almacenamiento está disponible.

Extraer arrays JSON mediante rutas

Usa puntos para campos y corchetes para índices: data.books o items[0].tags. Las claves con puntos o espacios necesitan comillas: data["book.list"]. Usa $ para un array raíz. El valor final debe ser un array.

Solo se sugieren rutas a arrays. Usa ↑↓ para elegir, Tab o Intro para insertar y Esc para cerrar.

EJEMPLO 1

Propiedad simple

Selecciona un array en el nivel superior.

JSON de entrada

{
  "books": [
    {
      "name": "Book A",
      "price": 10
    },
    {
      "name": "Book B",
      "price": 20
    }
  ]
}

Expresión de ruta

books

Array extraído

[
  {
    "name": "Book A",
    "price": 10
  },
  {
    "name": "Book B",
    "price": 20
  }
]

EJEMPLO 2

Ruta anidada

Usa un punto para acceder a un objeto.

JSON de entrada

{
  "data": {
    "books": [
      {
        "name": "Book A",
        "price": 10
      },
      {
        "name": "Book B",
        "price": 20
      }
    ]
  }
}

Expresión de ruta

data.books

Array extraído

[
  {
    "name": "Book A",
    "price": 10
  },
  {
    "name": "Book B",
    "price": 20
  }
]

EJEMPLO 3

Índice de array

Los índices empiezan en cero.

JSON de entrada

{
  "items": [
    {
      "id": 1,
      "tags": [
        "a",
        "b"
      ]
    },
    {
      "id": 2,
      "tags": [
        "c",
        "d"
      ]
    }
  ]
}

Expresión de ruta

items[0].tags

Array extraído

[
  "a",
  "b"
]

Convertir elementos de arrays JSON en texto con plantillas

Escribe un campo o una expresión dentro de ${…}. Aparecerán sugerencias al escribir entre las llaves.

El texto fuera de ${…} se conserva. Los resultados se unen con saltos de línea. Las sugerencias admiten campos anidados e indican su disponibilidad.

Dentro de una expresión, usa ↑↓ para elegir un campo, Tab o Intro para insertar y Esc para cerrar.

Elemento actual e índice

${$item} es el elemento actual; ${$index} empieza en 0. Usa ${$index + 1} para numerar desde 1. Los campos admiten ${name} y ${$item.name}. Para claves reservadas, usa ${$item["$item"]} o ${$item["$index"]}. ${JSON.stringify($item)} muestra el objeto completo como JSON.

EJEMPLO 1

Array JSON a lista Markdown

Para este array raíz, usa $ como ruta. La plantilla genera una viñeta Markdown por elemento; después copia el resultado.

Array extraído

[
  {
    "name": "Alice"
  },
  {
    "name": "Bob"
  }
]

Plantilla de texto

- ${name}

Resultado de la conversión

- Alice
- Bob

EJEMPLO 2

Arrays de cadenas

Usa $item para la cadena actual y $index + 1 para numerar.

Array extraído

[
  "admin",
  "editor"
]

Plantilla de texto

${$index + 1}. Role: ${$item}

Resultado de la conversión

1. Role: admin
2. Role: editor

EJEMPLO 3

Arrays de números

Usa el número actual directamente en los cálculos.

Array extraído

Plantilla de texto

${$item} × 2 = ${$item * 2}

Resultado de la conversión

10 × 2 = 20
20 × 2 = 40
30 × 2 = 60

EJEMPLO 4

Arrays de objetos

Accede a los campos mediante $item o su nombre abreviado.

Array extraído

[
  {
    "name": "Alice"
  },
  {
    "name": "Bob"
  }
]

Plantilla de texto

${$index + 1}. ${$item.name} / ${name}

Resultado de la conversión

1. Alice / Alice
2. Bob / Bob

EJEMPLO 5

Sustitución de variables

Inserta un campo de cada elemento del array.

Array extraído

[
  {
    "name": "Book A",
    "author": "Author 1"
  },
  {
    "name": "Book B",
    "author": "Author 2"
  }
]

Plantilla de texto

Book: ${name} by ${author}

Resultado de la conversión

Book: Book A by Author 1
Book: Book B by Author 2

EJEMPLO 6

Operaciones matemáticas

Calcula un valor dentro de una expresión.

Array extraído

[
  {
    "name": "Product A",
    "price": 100
  },
  {
    "name": "Product B",
    "price": 200
  }
]

Plantilla de texto

${name}: $${price} (with tax: $${(price * 1.1).toFixed(2)})

Resultado de la conversión

Product A: $100 (with tax: $110.00)
Product B: $200 (with tax: $220.00)

EJEMPLO 7

Expresiones combinadas

Combina campos, cálculos y texto.

Array extraído

[
  {
    "item": "Item A",
    "price": 100,
    "qty": 2
  },
  {
    "item": "Item B",
    "price": 50,
    "qty": 3
  }
]

Plantilla de texto

${item}: ${qty} x $${price} = $${price * qty}

Resultado de la conversión

Item A: 2 x $100 = $200
Item B: 3 x $50 = $150

Revisar campos y formato numérico

El azul indica variables integradas y campos reconocidos; el violeta, delimitadores; el naranja, operadores; y el turquesa, números. Una línea ondulada roja señala campos ausentes. Usa toFixed(2) para dos decimales.