Parámetros array en query string: cómo se leen según el lenguaje

PublicadoHerramientaAnalizador de URL y conversor de query string

Contenido
  1. El problema
  2. La solución
  3. Puntos donde suele atascarse la gente
  4. En resumen
  5. Preguntas frecuentes

Cuando en una URL aparece la misma clave varias veces, como en ?tag=a&tag=b, si se agrupan en un array o se conserva solo el último valor depende de cada lenguaje y framework. Por eso es tan habitual que el backend interprete de forma distinta la query string que envió el frontend y que solo llegue uno de los valores. En este artículo repasamos por qué se dividen esas reglas y cómo comprobar con tus propios ojos qué interpretación se está aplicando.

Resumen ① La query string de una URL no tiene un tipo de dato «array»; que se trate como array es solo una convención de cada lenguaje y framework. ② Hay dos grandes corrientes: repetir la misma clave (tag=a&tag=b) o exigir corchetes para reconocer el array (tag[]=a&tag[]=b). ③ Sea cual sea la regla, puedes comprobarla sin mirar el código: basta con convertir la query string a JSON y ver el resultado.

El problema

Piensa en una pantalla de filtros en la que eliges varias etiquetas con casillas de verificación: el navegador suele enviar los valores con el mismo nombre repetidos, como tag=a&tag=b.

Si el servidor que recibe esa petición está hecho en un lenguaje que solo reconoce los corchetes como array, la cosa cambia. Las claves repetidas sin corchetes no se agrupan en un array: solo queda el último valor.

Al contrario, imagina que consultas la documentación de la API y construyes la petición a mano con la forma tag[]=a&tag[]=b, pero el receptor solo trata las claves repetidas como array. Entonces se leerá mal, como una única clave llamada «tag[]».

Este tipo de fallo no aparece cuando pruebas con un solo valor; estalla únicamente en situaciones en las que la misma clave se repite, como selecciones múltiples o varias etiquetas, y por eso cuesta especialmente dar con la causa.

La solución

Lo primero que hay que tener claro es que la query string de una URL no tiene un tipo de dato «array». Lo que va después del signo de interrogación es simplemente una cadena de pares key=value separados por &, y que eso se agrupe en un array o no es una convención de quien lo lee.

Esa convención se divide en dos grandes ramas: una repite la misma clave tal cual y la otra exige corchetes para reconocer un array.

Claves repetidas frente a corchetes

URLSearchParams, la API estándar del navegador, no agrupa por su cuenta las claves repetidas. get("tag") devuelve solo el primer valor, y para obtenerlos todos hay que llamar explícitamente a getAll("tag").

Tampoco trata los corchetes de forma especial. Si metes tag[]=a&tag[]=b, no lo reconoce como «tag», sino como una única clave llamada «tag[]».

En cambio, los lenguajes y frameworks que usan la notación con corchetes funcionan justo al revés. Si solo repites tag=a&tag=b sin corchetes, no obtienes un array: queda únicamente el último valor, y para recibirlo como array tienes que usar la forma tag[]=a&tag[]=b.

Cómo comprobarlo paso a paso

Cuando los valores se pierden, puedes revisarlo en este orden. Primero comprueba si tu código los envía como claves repetidas o con corchetes.

Después busca en la documentación del servidor cuál es su regla de parseo de la query. Si no coinciden, tendrás que ajustar el formato en el cliente o añadir en el servidor código que agrupe las claves repetidas en un array.

La forma más rápida de salir de dudas es meter una query string real y ver con tus propios ojos si el resultado se agrupa en un array. Pruébalo con el Analizador de URL y conversor de query string.

Analizador de URL y conversor de query string

Pega una URL o una query string y verás al momento en JSON qué parámetros se han agrupado en un array.

Puntos donde suele atascarse la gente

SituaciónCausa
Marcas varias casillas de verificación, pero al servidor solo llega un valorEl servidor solo reconoce como array la notación con corchetes (tag[]=), mientras que el cliente envía claves repetidas (tag=a&tag=b)
Extraes el valor con URLSearchParams.get("tag") y solo obtienes unoget() siempre devuelve el primer valor. Para recibirlos todos tienes que usar getAll("tag")
Conviertes un array de JSON a query string y el servidor no lo leeSe serializó con claves repetidas, pero el servidor solo reconoce como array la notación con corchetes
La misma URL da resultados distintos al cambiar de lenguaje o frameworkNo hay un estándar para la notación de arrays en la query string, así que cada uno aplica sus propias reglas de parseo

En resumen

Cuando la misma clave aparece varias veces en la query string, si se agrupa en un array y qué notación se acepta como array no lo marca un estándar, sino la convención de cada lenguaje y framework.

Los problemas de valores que desaparecen o de los que solo queda uno se deben casi siempre a que la notación que envía el cliente y la que espera el servidor no coinciden. Si dudas de cuál es la convención, lo más fiable es convertir la query string real a JSON y comprobarlo con tus propios ojos.

Analizador de URL y conversor de query string

Pega una URL o una query string y verás al momento en JSON qué parámetros se han agrupado en un array.

Preguntas frecuentes

Si pongo corchetes, como en tag[]=a&tag[]=b, ¿se reconoce como array?

Esta herramienta usa URLSearchParams tal cual, la API estándar del navegador, así que no interpreta los corchetes de forma especial. Si introduces tag[]=a&tag[]=b, se muestra como una clave llamada «tag[]» con dos valores, no como «tag». Cuando trabajes con un backend que usa los corchetes como notación de array, ten en cuenta esta diferencia.

Si convierto un array de JSON a query string, ¿qué formato obtengo?

La pestaña «JSON → query» serializa los valores de tipo array repitiendo la misma clave, no con corchetes. Por ejemplo, {"tag": ["a", "b"]} se convierte en tag=a&tag=b. Si tu servidor necesita la notación con corchetes, tendrás que añadir [] manualmente al resultado.

¿En qué se diferencian las pestañas «Descomponer URL» y «Query → JSON»?

«Descomponer URL» divide la URL completa en protocol, host, port, pathname y hash, y además muestra en JSON la parte de la query que contiene. Si solo tienes la query string que va después del signo de interrogación, basta con pegarla en la pestaña «Query → JSON».

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Reemplazo con regex: $1, $2 y $& explicados con ejemplosAprende en qué se convierten $1, $2 y $& al buscar y reemplazar con regex, por qué $ queda literal sin modo regex y qué cuenta el número de reemplazos.
  2. Expresiones regulares: símbolos, flags y verificar coincidenciasAprende qué significan ^, $, ., * y los flags g, i, m, s, u, y, cómo probar patrones sin código y cómo evitar patrones que bloquean el navegador.
  3. Extraer correos y URLs con regex: patrones y grupos de capturaAprende a extraer correos, URLs, IP, teléfonos y números de cualquier texto con expresiones regulares, y a usar grupos de captura para quedarte solo con una parte.
  4. Expresiones regulares: qué significa cada símbolo y cómo leerlosCómo dividir un regex en anclas, clases de caracteres, grupos y cuantificadores para entender qué hace cada símbolo, y cómo comprobarlo automáticamente.
  5. Eliminar líneas en blanco con regex: guía de saltos de líneaAprende a quitar las líneas vacías de un texto con la expresión regular /^\s*\n/gm, a fusionar las que se repiten y a tratar los saltos CRLF y LF.
  6. Cómo eliminar los saltos de línea de un PDF y unir párrafosAprende a quitar los saltos de línea forzados que se cuelan al copiar de un PDF o un correo y a recomponer los párrafos sin perder el orden del texto.

Herramientas relacionadas