aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/urlsearchparams
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/urlsearchparams
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/urlsearchparams')
-rw-r--r--files/fr/web/api/urlsearchparams/entries/index.md64
-rw-r--r--files/fr/web/api/urlsearchparams/index.md146
2 files changed, 87 insertions, 123 deletions
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
---
-<p>{{APIRef("URL API")}}{{SeeCompatTable}}</p>
+{{APIRef("URL API")}}{{SeeCompatTable}}
-<p>La méthode <code><strong>URLSearchParams.entries()</strong></code> 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")}} .</p>
+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")}} .
-<div class="note">
-<p><strong>Note :</strong> This method is available in <a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers</a>.</p>
-</div>
+> **Note :** This method is available in [Web Workers](/en-US/docs/Web/API/Web_Workers_API).
-<h2 id="Syntax">Syntax</h2>
+## Syntax
-<pre class="syntaxbox">searchParams.entries();</pre>
+ searchParams.entries();
-<h3 id="Return_value">Return value</h3>
+### Return value
-<p>Returns an {{jsxref("Iteration_protocols","iterator")}}.</p>
+Returns an {{jsxref("Iteration_protocols","iterator")}}.
-<h2 id="Example">Example</h2>
+## Example
-<pre class="brush: js">// Create a test URLSearchParams object
-var searchParams = new URLSearchParams("key1=value1&amp;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]);
}
-</pre>
+```
-<p>The result is:</p>
+The result is:
-<pre>key1, value1
-key2, value2</pre>
+ key1, value1
+ key2, value2
-<h2 id="Specifications">Specifications</h2>
+## Specifications
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Specification</th>
- <th scope="col">Status</th>
- <th scope="col">Comment</th>
- </tr>
- <tr>
- <td>{{SpecName('URL', '#urlsearchparams','entries() (as iterator&lt;&gt;)')}}</td>
- <td>{{Spec2('URL')}}</td>
- <td>Initial definition</td>
- </tr>
- </tbody>
-</table>
+| Specification | Status | Comment |
+| ------------------------------------------------------------------------------------------------ | -------------------- | ------------------ |
+| {{SpecName('URL', '#urlsearchparams','entries() (as iterator&lt;&gt;)')}} | {{Spec2('URL')}} | Initial definition |
-<h2 id="Browser_compatibility">Browser compatibility</h2>
+## Browser compatibility
-<div>
+{{Compat("api.URLSearchParams.entries")}}
+## See also
-<p>{{Compat("api.URLSearchParams.entries")}}</p>
-</div>
-
-<h2 id="See_also">See also</h2>
-
-<ul>
- <li>Other URL-related interfaces: {{domxref("URL")}}, {{domxref("URLUtils")}}.</li>
-</ul>
+- 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
---
-<p>{{ApiRef("URL API")}}</p>
-
-<p>L’interface <strong><code>URLSearchParams</code></strong> définit des méthodes utilitaires pour travailler avec la <em>chaîne de requête</em> (les paramètres <code>GET</code>) d’une URL.</p>
-
-<p>Un objet implémentant <code>URLSearchParams</code> peut être directement utilisé dans une structure {{jsxref("Statements/for...of", "for...of")}}, au lieu de {{domxref('URLSearchParams.entries()', 'entries()')}} : <code>for (var p of mySearchParams)</code> ou son équivalent <code>for (var p of mySearchParams.entries())</code>.</p>
-
-<h2 id="Constructeur">Constructeur</h2>
-
-<dl>
- <dt>{{domxref("URLSearchParams.URLSearchParams", 'URLSearchParams()')}}</dt>
- <dd>Constructeur renvoyant un objet <code>URLSearchParams</code>.</dd>
-</dl>
-
-<h2 id="Propriétés">Propriétés</h2>
-
-<p><em>Cette interface n’hérite d’aucune propriété.</em></p>
-
-<h2 id="Méthodes">Méthodes</h2>
-
-<p><em>Cette interface n’hérite d’aucune méthode.</em></p>
-
-<dl>
- <dt>{{domxref("URLSearchParams.append()")}}</dt>
- <dd>Ajoute une paire clé / valeur spécifiée en tant que nouveau paramètre de recherche.</dd>
- <dt>{{domxref("URLSearchParams.delete()")}}</dt>
- <dd>Supprime le paramètre de recherche donné et sa valeur associée de la liste de tous les paramètres de recherche.</dd>
- <dt>{{domxref("URLSearchParams.entries()")}}</dt>
- <dd>Retourne un {{jsxref("Iteration_protocols","iterator")}} permettant de parcourir toutes les paires clé / valeur contenues dans cet objet.</dd>
- <dt>{{domxref("URLSearchParams.get()")}}</dt>
- <dd>Retourne la première valeur associée au paramètre de recherche donné.</dd>
- <dt>{{domxref("URLSearchParams.getAll()")}}</dt>
- <dd>Retourne toutes les valeurs associées au paramètre de recherche donné.</dd>
- <dt>{{domxref("URLSearchParams.has()")}}</dt>
- <dd>Retourne un {{jsxref("Boolean")}} indiquant si un tel paramètre de recherche existe.</dd>
- <dt>{{domxref("URLSearchParams.keys()")}}</dt>
- <dd>Retourne un {{jsxref("Iteration_protocols", "iterator")}} permettant de parcourir toutes les <strong>clés</strong> des paires clé / valeur contenues dans cet objet.</dd>
- <dt>{{domxref("URLSearchParams.set()")}}</dt>
- <dd>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.</dd>
- <dt>{{domxref("URLSearchParams.sort()")}}</dt>
- <dd>Trie toutes les paires clé / valeur, s’il y en a, par leurs clés.</dd>
- <dt>{{domxref("URLSearchParams.toString()")}}</dt>
- <dd>Retourne une chaîne contenant une chaîne de requête pouvant être utilisée dans une URL.</dd>
- <dt>{{domxref("URLSearchParams.values()")}}</dt>
- <dd>Retourne un {{jsxref("Iteration_protocols", "iterator")}} permettant de parcourir toutes les <strong>valeurs</strong> des paires clé / valeur contenues dans cet objet.</dd>
-</dl>
-
-<h2 id="Exemple">Exemple</h2>
-
-<pre class="brush: js">var paramsString = "q=URLUtils.searchParams&amp;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&amp;topic=api&amp;topic=webdev"
+searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
-searchParams.toString(); // "q=URLUtils.searchParams&amp;topic=More+webdev"
+searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"
-</pre>
-
-<h2 id="Spécifications">Spécifications</h2>
-
-<table class="standard-table">
- <thead>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- </thead>
- <tbody>
- <tr>
- <td>{{SpecName('URL', '#urlsearchparams', "URLSearchParams")}}</td>
- <td>{{Spec2('URL')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("api.URLSearchParams")}}</p>
-
-<h2 id="See_also">Voir aussi</h2>
-
-<ul>
- <li>Autres interfaces liées aux URL : {{domxref("URL")}}, {{domxref("URLUtils")}}.</li>
- <li><a href="https://developers.google.com/web/updates/2016/01/urlsearchparams?hl=en">Google Developers: Easy URL manipulation with URLSearchParams</a></li>
-</ul>
+```
+
+## 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)