diff options
Diffstat (limited to 'files/fr/web/api/urlsearchparams')
| -rw-r--r-- | files/fr/web/api/urlsearchparams/entries/index.md | 64 | ||||
| -rw-r--r-- | files/fr/web/api/urlsearchparams/index.md | 146 |
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&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<>)')}}</td> - <td>{{Spec2('URL')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> +| Specification | Status | Comment | +| ------------------------------------------------------------------------------------------------ | -------------------- | ------------------ | +| {{SpecName('URL', '#urlsearchparams','entries() (as iterator<>)')}} | {{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&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" -</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) |