MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-survey

Cette traduction est en cours.

L'interface URLSearchParams définit des méthodes d'utilitaire pour travailler avec la chaîne de requête 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 equivalent for (var p of mySearchParams.entries()).

Constructor

URLSearchParams()
Constructeur renvoyant un objet URLSearchParams .

Properties

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

 

Methods

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()
Renvoie la première valeur associée au paramètre de recherche donné.
URLSearchParams.getAll()
Renvoie toutes les valeurs associées à un paramètre de recherche donné.
URLSearchParams.has()
Renvoie 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, supprimez les autres.
URLSearchParams.sort()
Trie toutes les paires clé / valeur, le cas échéant, par leurs clés.
URLSearchParams.toString()
Renvoie 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.

Example

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

//Iterate the search parameters.
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"

Specifications

Specification Status Comment
URL
La définition de 'URLSearchParams' dans cette spécification.
Standard évolutif Initial definition.

Browser compatibility

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 !

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 49 29.0 (29.0)[1] Pas de support 36 10.1
entries(), keys(), values(), and support of for...of 49 44.0 (44.0) Pas de support 36 ?
USVString for constructor init object 61 53.0 (53.0) Pas de support 48 ?
Record for constructor init object 61 54.0 (54.0) Pas de support 48 ?
sort() 61 ? Pas de support 48 ?
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 49 49 29.0 (29.0)[1] Pas de support 36 Pas de support
entries(), keys(), values(), and support of for...of 49 49 44.0 (44.0) Pas de support 36 Pas de support
USVString for constructor init object 61 61 53.0 (53.0) Pas de support 48 ?
Record for constructor init object 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 des guillemets simples contenus dans des URLs sont échappés quand on y accède via des 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 : cdelamarre
 Dernière mise à jour par : cdelamarre,