Analizzare una query URL come oggetto chiave-valore

Decodifica le sequenze percentuali e i segni più dei moduli, conserva i valori vuoti e raccoglie i parametri ripetuti in elenchi rispettandone l’ordine originale. Le sequenze malformate e l’UTF-8 non valido producono un errore esplicito, senza sostituzioni silenziose. Lei può esaminare un collegamento nel browser oppure richiamare l’API deterministica al costo di $0.002 per elemento da applicazioni, test e procedure di acquisizione che richiedono sempre lo stesso risultato.

Scelga il formato di ingresso adatto alla fonte

Lei può inviare un URL assoluto completo, per esempio <code>https://example.com/search?q=red+shoes</code>, una query grezza come <code>q=red+shoes&amp;page=2</code>, oppure la stessa query preceduta da un punto interrogativo. Per un URL assoluto viene analizzata soltanto la componente di query: schema, autorità, percorso e frammento non diventano campi. Un URL senza query restituisce un oggetto dei parametri vuoto. L’ingresso grezzo viene considerato interamente come dati di query, dopo la rimozione di un eventuale punto interrogativo iniziale. Questa forma è utile quando un framework, un registro degli accessi, un webhook o un’API del browser ha già separato la query dal resto dell’indirizzo. Ogni e commerciale apre una nuova coppia, mentre il primo segno uguale divide il nome dal valore. Un nome senza segno uguale viene conservato con una stringa vuota, proprio come un’assegnazione esplicitamente vuota. I segmenti vuoti tra e commerciali consecutive vengono ignorati. Il risultato riporta anche il numero di chiavi distinte e quello delle coppie analizzate, così Lei può distinguere i campi ripetuti da quelli unici senza dover ricontare le proprietà dell’oggetto.

Comprenda la decodifica e le chiavi ripetute

Nomi e valori vengono decodificati separatamente secondo le convenzioni normalmente applicate ai moduli nelle query URL. Un segno più diventa uno spazio, mentre le sequenze <code>%HH</code> vengono interpretate come byte UTF-8. Pertanto <code>city=San+Jos%C3%A9</code> produce testo Unicode leggibile e un separatore codificato come <code>%26</code> resta all’interno di un unico valore, invece di essere scambiato per l’inizio di un altro campo. La decodifica avviene una sola volta: <code>%2520</code> diventa <code>%20</code>, non uno spazio. Quando una chiave compare una volta, il suo valore è una stringa. Se la stessa chiave decodificata ricompare, il valore diventa un elenco contenente tutte le occorrenze nell’ordine della fonte. Questa regola rappresenta gruppi di caselle, filtri, etichette e altre selezioni multiple senza scartare informazioni né inventare proprietà numerate. La ripetizione viene determinata dopo la decodifica, quindi grafie codificate equivalenti dello stesso nome vengono raggruppate. Anche i valori vuoti ripetuti vengono conservati. L’analizzatore non deduce booleani, numeri o date e non interpreta la notazione tra parentesi quadre come oggetti annidati. Tutti i valori scalari restano stringhe, affinché il codice successivo applichi consapevolmente la conversione prevista dal proprio dominio.

Blocchi i dati corrotti prima che entrino nel flusso

Gli analizzatori permissivi possono mantenere un segno di percentuale isolato, accettare una sequenza di una sola cifra oppure inserire un carattere sostitutivo quando i byte codificati non formano UTF-8 valido. Questi comportamenti fanno apparire utilizzabili identificatori danneggiati e creano differenze difficili da diagnosticare tra browser, server e procedure di verifica delle firme. Questa capacità controlla che ogni segno di percentuale sia seguito esattamente da due cifre esadecimali e poi verifica che ogni sequenza di byte decodificata costituisca UTF-8 valido. Se una condizione non è soddisfatta, la richiesta restituisce un errore di ingresso non valido, non un oggetto parziale. L’analisi è pura e deterministica: non accede alla rete, non segue reindirizzamenti, non legge l’orologio, non usa casualità e non conserva stato tra le chiamate. Consideri le stringhe restituite come dati, non come HTML, codice, percorsi di file o espressioni di database affidabili; la decodifica recupera i caratteri, ma non rende sicuro il loro impiego successivo. Nell’automazione, l’API costa $0.002 per elemento e costituisce una fase di normalizzazione stabile prima di validare, instradare, confrontare o archiviare. Nel browser, la stessa logica consente di esaminare rapidamente collegamenti copiati senza contattarne la destinazione.