L’interface URLSearchParams définit des méthodes utilitaires pour travailler avec la chaîne de requête (les paramètres GET) d’une URL.

Un objet implémentant URLSearchParams peut être directement utilisé dans une structure for...of, au lieu de entries() : for (var p of mySearchParams) ou son équivalent for (var p of mySearchParams.entries()).

Constructeur

URLSearchParams()
Constructeur renvoyant un objet URLSearchParams.

Propriétés

Cette interface n’hérite d’aucune propriété.

Méthodes

Cette interface n’hérite d’aucune méthode.

URLSearchParams.append()
Ajoute une paire clé / valeur spécifiée en tant que nouveau paramètre de recherche.
URLSearchParams.delete()
Supprime le paramètre de recherche donné et sa valeur associée de la liste de tous les paramètres de recherche.
URLSearchParams.entries()
Retourne un iterator permettant de parcourir toutes les paires clé / valeur contenues dans cet objet.
URLSearchParams.get()
Retourne la première valeur associée au paramètre de recherche donné.
URLSearchParams.getAll()
Retourne toutes les valeurs associées au paramètre de recherche donné.
URLSearchParams.has()
Retourne un Boolean indiquant si un tel paramètre de recherche existe.
URLSearchParams.keys()
Retourne un iterator permettant de parcourir toutes les clés des paires clé / valeur contenues dans cet objet.
URLSearchParams.set()
Définit la valeur associée à un paramètre de recherche donné à la valeur donnée. S’il y avait plusieurs valeurs, les autres sont supprimées.
URLSearchParams.sort()
Trie toutes les paires clé / valeur, s’il y en a, par leurs clés.
URLSearchParams.toString()
Retourne une chaîne contenant une chaîne de requête pouvant être utilisée dans une URL.
URLSearchParams.values()
Retourne un iterator permettant de parcourir toutes les valeurs des paires clé / valeur contenues dans cet objet.

Exemple

var paramsString = "q=URLUtils.searchParams&topic=api";
var searchParams = new URLSearchParams(paramsString);

// Itère sur les paramètres de recherche.
for (let p of searchParams) {
  console.log(p);
}

searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === null; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

Spécifications

Spécification Statut Commentaire
URL
La définition de 'URLSearchParams' dans cette spécification.
Standard évolutif Définition initiale.

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support de base 49 29.0 (29.0)[1] Pas de support 36 10.1
entries(), keys(), values(), et support de for...of 49 44.0 (44.0) Pas de support 36 ?
USVString comme argument init du constructeur 61 53.0 (53.0) Pas de support 48 ?
Objet littéral comme argument init du constructeur 61 54.0 (54.0) Pas de support 48 ?
sort() 61 ? Pas de support 48 ?
Fonctionnalité Android Webview Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base 49 49 29.0 (29.0)[1] Pas de support 36 Pas de support
entries(), keys(), values(), et support de for...of 49 49 44.0 (44.0) Pas de support 36 Pas de support
USVString comme argument init du constructeur 61 61 53.0 (53.0) Pas de support 48 ?
Objet littéral comme argument init du constructeur 61 61 54.0 (54.0) Pas de support 48 ?
sort() 61 61 ? Pas de support 48 Pas de support

[1] Firefox a un bug qui fait que les guillemets simples contenus dans les URLs sont échappés quand on y accède via les API d’URL (bug 1386683). Cela a été corrigé à partir de Firefox 57.

Voir également

Étiquettes et contributeurs liés au document

Contributeurs à cette page : Watilin, cdelamarre
Dernière mise à jour par : Watilin,