Structure et analyse des chaînes de requête

Une chaîne de requête est la partie d'une URL située après le ?, utilisée pour transmettre des informations supplémentaires à une page. Dans https://example.com/search?q=book&page=2, la chaîne de requête est q=book&page=2.

Les règles

Une chaîne de requête est constituée de paires key=value reliées par &.

• ? — marque le début de la chaîne de requête
• = — sépare une clé de sa valeur
• & — sépare plusieurs paires
• # — termine la chaîne de requête (ce qui suit est le fragment/hash)

Quand une valeur contient des caractères spéciaux

Si une valeur contient & ou =, elle entre en conflit avec les séparateurs : la valeur doit donc être encodée avec encodeURIComponent. Un terme de recherche a&b doit être écrit q=a%26b pour que le paramètre reste intact. Un espace est représenté par %20 ou + selon l'encodage, et les analyseurs reconvertissent souvent le + en espace.

Analyser sans risque

Les navigateurs fournissent URLSearchParams pour manipuler les chaînes de requête sans risque. Y recourir plutôt que de découper vous-même sur & gère automatiquement l'encodage, les clés en double et les valeurs vides.

L'onglet Analyseur de requête de ce site décompose une URL collée en ses composants et affiche côte à côte la valeur brute et la valeur décodée de chaque paramètre.