From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../fr/web/api/urlsearchparams/entries/index.html | 67 +++++++ files/fr/web/api/urlsearchparams/index.html | 220 +++++++++++++++++++++ 2 files changed, 287 insertions(+) create mode 100644 files/fr/web/api/urlsearchparams/entries/index.html create mode 100644 files/fr/web/api/urlsearchparams/index.html (limited to 'files/fr/web/api/urlsearchparams') diff --git a/files/fr/web/api/urlsearchparams/entries/index.html b/files/fr/web/api/urlsearchparams/entries/index.html new file mode 100644 index 0000000000..af1a117d18 --- /dev/null +++ b/files/fr/web/api/urlsearchparams/entries/index.html @@ -0,0 +1,67 @@ +--- +title: URLSearchParams.entries() +slug: Web/API/URLSearchParams/entries +translation_of: Web/API/URLSearchParams/entries +--- +

{{APIRef("URL API")}}{{SeeCompatTable}}

+ +

La méthode URLSearchParams.entries() retourne  un itérateur( {{jsxref("Iteration_protocols",'iterator')}}) permettant de parcourir les paires de clé/valeur contenues dans cet objet. La clé et la valeur de chaque paire est un objet  {{domxref("USVString")}} .

+ +
+

Note: This method is available in Web Workers.

+
+ +

Syntax

+ +
searchParams.entries();
+ +

Return value

+ +

Returns an {{jsxref("Iteration_protocols","iterator")}}.

+ +

Example

+ +
// Create a test URLSearchParams object
+var searchParams = new URLSearchParams("key1=value1&key2=value2");
+
+// Display the key/value pairs
+for(var pair of searchParams.entries()) {
+   console.log(pair[0]+ ', '+ pair[1]);
+}
+
+ +

The result is:

+ +
key1, value1
+key2, value2
+ +

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('URL', '#urlsearchparams','entries() (as iterator<>)')}}{{Spec2('URL')}}Initial definition
+ +

Browser compatibility

+ +
+ + +

{{Compat("api.URLSearchParams.entries")}}

+
+ +

See also

+ + diff --git a/files/fr/web/api/urlsearchparams/index.html b/files/fr/web/api/urlsearchparams/index.html new file mode 100644 index 0000000000..d5dd97ba18 --- /dev/null +++ b/files/fr/web/api/urlsearchparams/index.html @@ -0,0 +1,220 @@ +--- +title: URLSearchParams +slug: Web/API/URLSearchParams +translation_of: Web/API/URLSearchParams +--- +

{{ApiRef("URL API")}}

+ +

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 {{jsxref("Statements/for...of", "for...of")}}, au lieu de {{domxref('URLSearchParams.entries()', 'entries()')}} : for (var p of mySearchParams) ou son équivalent for (var p of mySearchParams.entries()).

+ +

Constructeur

+ +
+
{{domxref("URLSearchParams.URLSearchParams", '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.

+ +
+
{{domxref("URLSearchParams.append()")}}
+
Ajoute une paire clé / valeur spécifiée en tant que nouveau paramètre de recherche.
+
{{domxref("URLSearchParams.delete()")}}
+
Supprime le paramètre de recherche donné et sa valeur associée de la liste de tous les paramètres de recherche.
+
{{domxref("URLSearchParams.entries()")}}
+
Retourne un {{jsxref("Iteration_protocols","iterator")}} permettant de parcourir toutes les paires clé / valeur contenues dans cet objet.
+
{{domxref("URLSearchParams.get()")}}
+
Retourne la première valeur associée au paramètre de recherche donné.
+
{{domxref("URLSearchParams.getAll()")}}
+
Retourne toutes les valeurs associées au paramètre de recherche donné.
+
{{domxref("URLSearchParams.has()")}}
+
Retourne un {{jsxref("Boolean")}} indiquant si un tel paramètre de recherche existe.
+
{{domxref("URLSearchParams.keys()")}}
+
Retourne un {{jsxref("Iteration_protocols", "iterator")}} permettant de parcourir toutes les clés des paires clé / valeur contenues dans cet objet.
+
{{domxref("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.
+
{{domxref("URLSearchParams.sort()")}}
+
Trie toutes les paires clé / valeur, s’il y en a, par leurs clés.
+
{{domxref("URLSearchParams.toString()")}}
+
Retourne une chaîne contenant une chaîne de requête pouvant être utilisée dans une URL.
+
{{domxref("URLSearchParams.values()")}}
+
Retourne un {{jsxref("Iteration_protocols", "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écificationStatutCommentaire
{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}{{Spec2('URL')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

{{ CompatibilityTable() }}

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéChromeFirefox (Gecko)Internet ExplorerOperaSafari
Support de base{{CompatChrome(49)}}{{CompatGeckoDesktop("29.0")}}[1]{{CompatNo}}{{CompatOpera(36)}}10.1
entries(), keys(), values(), et support de for...of{{CompatChrome(49)}}{{CompatGeckoDesktop("44.0")}}{{CompatNo}}{{CompatOpera(36)}}{{CompatUnknown}}
USVString comme argument init du constructeur{{CompatChrome(61)}}{{CompatGeckoDesktop("53.0")}}{{CompatNo}}{{CompatOpera(48)}}{{CompatUnknown}}
Objet littéral comme argument init du constructeur{{CompatChrome(61)}}{{CompatGeckoDesktop("54.0")}}{{CompatNo}}{{CompatOpera(48)}}{{CompatUnknown}}
sort(){{CompatChrome(61)}}{{CompatUnknown}}{{CompatNo}}{{CompatOpera(48)}}{{CompatUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FonctionnalitéAndroid WebviewChrome pour AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Support de base{{CompatChrome(49)}}{{CompatChrome(49)}}{{CompatGeckoMobile("29.0")}}[1]{{CompatNo}}{{CompatOperaMobile(36)}}{{CompatNo}}
entries(), keys(), values(), et support de for...of{{CompatChrome(49)}}{{CompatChrome(49)}}{{CompatGeckoMobile("44.0")}}{{CompatNo}}{{CompatOperaMobile(36)}}{{CompatNo}}
USVString comme argument init du constructeur{{CompatChrome(61)}}{{CompatChrome(61)}}{{CompatGeckoMobile("53.0")}}{{CompatNo}}{{CompatOperaMobile(48)}}{{CompatUnknown}}
Objet littéral comme argument init du constructeur{{CompatChrome(61)}}{{CompatChrome(61)}}{{CompatGeckoMobile("54.0")}}{{CompatNo}}{{CompatOperaMobile(48)}}{{CompatUnknown}}
sort(){{CompatChrome(61)}}{{CompatChrome(61)}}{{CompatUnknown}}{{CompatNo}}{{CompatOperaMobile(48)}}{{CompatNo}}
+
+ +

[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

+ + -- cgit v1.2.3-54-g00ecf