From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/urlsearchparams/entries/index.md | 64 ++++------ files/fr/web/api/urlsearchparams/index.md | 146 ++++++++++------------ 2 files changed, 87 insertions(+), 123 deletions(-) (limited to 'files/fr/web/api/urlsearchparams') diff --git a/files/fr/web/api/urlsearchparams/entries/index.md b/files/fr/web/api/urlsearchparams/entries/index.md index 4f10b1bb12..e7b812241b 100644 --- a/files/fr/web/api/urlsearchparams/entries/index.md +++ b/files/fr/web/api/urlsearchparams/entries/index.md @@ -3,65 +3,47 @@ title: URLSearchParams.entries() slug: Web/API/URLSearchParams/entries translation_of: Web/API/URLSearchParams/entries --- -

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

+{{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")}} .

+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.

-
+> **Note :** This method is available in [Web Workers](/en-US/docs/Web/API/Web_Workers_API). -

Syntax

+## Syntax -
searchParams.entries();
+ searchParams.entries(); -

Return value

+### Return value -

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

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

Example

+## Example -
// Create a test URLSearchParams object
-var searchParams = new URLSearchParams("key1=value1&key2=value2");
+```js
+// 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:

+The result is: -
key1, value1
-key2, value2
+ key1, value1 + key2, value2 -

Specifications

+## Specifications - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('URL', '#urlsearchparams','entries() (as iterator<>)')}}{{Spec2('URL')}}Initial definition
+| Specification | Status | Comment | +| ------------------------------------------------------------------------------------------------ | -------------------- | ------------------ | +| {{SpecName('URL', '#urlsearchparams','entries() (as iterator<>)')}} | {{Spec2('URL')}} | Initial definition | -

Browser compatibility

+## Browser compatibility -
+{{Compat("api.URLSearchParams.entries")}} +## See also -

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

-
- -

See also

- - +- Other URL-related interfaces: {{domxref("URL")}}, {{domxref("URLUtils")}}. diff --git a/files/fr/web/api/urlsearchparams/index.md b/files/fr/web/api/urlsearchparams/index.md index 92747ec561..27c7e479d8 100644 --- a/files/fr/web/api/urlsearchparams/index.md +++ b/files/fr/web/api/urlsearchparams/index.md @@ -3,55 +3,52 @@ 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";
+{{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
+
+```js
+var paramsString = "q=URLUtils.searchParams&topic=api";
 var searchParams = new URLSearchParams(paramsString);
 
 // Itère sur les paramètres de recherche.
@@ -64,39 +61,24 @@ 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.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
 searchParams.set("topic", "More webdev");
-searchParams.toString(); // "q=URLUtils.searchParams&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

- -

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

- -

Voir aussi

- - +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| ---------------------------------------------------------------------------- | -------------------- | -------------------- | +| {{SpecName('URL', '#urlsearchparams', "URLSearchParams")}} | {{Spec2('URL')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.URLSearchParams")}} + +## Voir aussi + +- Autres interfaces liées aux URL : {{domxref("URL")}}, {{domxref("URLUtils")}}. +- [Google Developers: Easy URL manipulation with URLSearchParams](https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en) -- cgit v1.2.3-54-g00ecf