Costruisci stringhe di query da oggetti JSON piatti. I valori array emettono chiavi ripetute; le proprietà null e undefined vengono saltate. L’output omette il punto interrogativo iniziale così puoi aggiungerlo quando assemblare URL complete per client HTTP, test e wrapper fetch di agenti.
Come funziona
L’oggetto JSON radice viene percorso chiave per chiave. I valori scalari sono codificati con la codifica standard dei parametri URL (encodeURIComponent). I valori array producono più coppie key=value con lo stesso nome di chiave. Le voci null e undefined sono omesse del tutto. Le coppie sono unite con & nell’ordine stabile di inserimento delle chiavi dell’oggetto analizzato.
Quando usarlo
- Costruire URL di richieste GET in client HTTP di agenti e test di integrazione
- Serializzare campi di form per mock senza escapare a mano spazi o simboli
- Fare round-trip con lo strumento parse-query-string per verificare il comportamento di encoding
- Creare URL di callback webhook firmati da oggetti di configurazione strutturati
Esempio
{"q":"hello world","page":2} si serializza in q=hello+world&page=2 (gli spazi possono apparire come + o %20 a seconda dell’encoder). Array come {"tag":["a","b"]} diventano tag=a&tag=b.
Limitazioni
Il valore JSON radice deve essere un oggetto—non un array né una stringa nuda. Gli oggetti annidati non vengono appiattiti automaticamente; serializza le strutture annidate prima della codifica se ti serve un valore per chiave. L’elaborazione avviene nel browser; oggetti molto grandi possono essere lenti da serializzare.