Construye cadenas de consulta a partir de objetos JSON planos. Los valores de matriz emiten claves repetidas; las propiedades null y undefined se omiten. La salida no incluye el signo de interrogación inicial para que lo añadas al montar URL completas para clientes HTTP, pruebas y envoltorios fetch de agentes.
Cómo funciona
Se recorre el objeto JSON raíz clave a clave. Los valores escalares se codifican con la codificación estándar de parámetros URL (encodeURIComponent). Los valores de matriz producen varios pares key=value con el mismo nombre de clave. Las entradas null y undefined se omiten por completo. Los pares se unen con & en el orden estable de inserción de claves del objeto analizado.
Cuándo usarlo
- Construir URL de peticiones GET en clientes HTTP de agentes y pruebas de integración
- Serializar campos de formulario para mocks sin escapar a mano espacios o símbolos
- Hacer ida y vuelta con la herramienta parse-query-string para verificar el comportamiento de codificación
- Crear URL de callback de webhooks firmados a partir de objetos de configuración estructurados
Ejemplo
{"q":"hello world","page":2} se serializa como q=hello+world&page=2 (los espacios pueden aparecer como + o %20 según el codificador). Matrices como {"tag":["a","b"]} se convierten en tag=a&tag=b.
Limitaciones
El valor JSON raíz debe ser un objeto—no una matriz ni una cadena suelta. Los objetos anidados no se aplanan automáticamente; convierte a cadena las estructuras anidadas antes de codificar si necesitas un valor por clave. El procesamiento se ejecuta en el navegador; objetos muy grandes pueden ser lentos de serializar.