Construisez des chaînes de requête à partir d’objets JSON plats. Les valeurs tableaux émettent des clés répétées ; les propriétés null et undefined sont ignorées. La sortie omet le point d’interrogation initial pour que vous puissiez l’ajouter en assemblant des URL complètes pour clients HTTP, tests et wrappers fetch d’agents.
Fonctionnement
L’objet JSON racine est parcouru clé par clé. Les valeurs scalaires sont encodées avec l’encodage standard des paramètres d’URL (encodeURIComponent). Les valeurs tableaux produisent plusieurs paires key=value avec le même nom de clé. Les entrées null et undefined sont entièrement omises. Les paires sont jointes par & dans l’ordre stable d’insertion des clés de l’objet analysé.
Quand l’utiliser
- Construire des URL de requêtes GET dans des clients HTTP d’agents et des tests d’intégration
- SĂ©rialiser des champs de formulaire pour des mocks sans Ă©chapper Ă la main espaces ou symboles
- Faire un aller-retour avec l’outil parse-query-string pour vérifier le comportement d’encodage
- Créer des URL de callback webhook signées à partir d’objets de configuration structurés
Exemple
{"q":"hello world","page":2} se sérialise en q=hello+world&page=2 (les espaces peuvent apparaître en + ou %20 selon l’encodeur). Des tableaux comme {"tag":["a","b"]} deviennent tag=a&tag=b.
Limites
La valeur JSON racine doit être un objet—pas un tableau ni une chaîne nue. Les objets imbriqués ne sont pas aplatis automatiquement ; sérialisez les structures imbriquées avant l’encodage si vous voulez une valeur par clé. Le traitement s’exécute dans le navigateur ; de très gros objets peuvent être lents à sérialiser.