diff options
Diffstat (limited to 'files/fr/web/api/htmlhyperlinkelementutils/index.html')
-rw-r--r-- | files/fr/web/api/htmlhyperlinkelementutils/index.html | 213 |
1 files changed, 213 insertions, 0 deletions
diff --git a/files/fr/web/api/htmlhyperlinkelementutils/index.html b/files/fr/web/api/htmlhyperlinkelementutils/index.html new file mode 100644 index 0000000000..7bbe88b470 --- /dev/null +++ b/files/fr/web/api/htmlhyperlinkelementutils/index.html @@ -0,0 +1,213 @@ +--- +title: URLUtils +slug: Web/API/URLUtils +tags: + - API + - Experimental + - JavaScript + - Reference + - URL +translation_of: Web/API/HTMLHyperlinkElementUtils +--- +<p>{{APIRef}}{{SeeCompatTable}}</p> +<p>L'interface <strong><code>URLUtils</code></strong> définit des méthodes utilitaires pour travailler avec les URL.</p> +<p>il n'y a pas d'objets de ce type, mais quelques objets l'implémentent, comme {{domxref("Location")}}, {{domxref("URL")}}, {{domxref("HTMLAnchorElement")}}, et {{domxref("HTMLAreaElement")}}.</p> +<h2 id="Propriétés">Propriétés</h2> +<p><em>Cette interface n'hérite d'aucune propriété.</em></p> +<dl> + <dt> + {{domxref("URLUtils.href")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant l'URL entière.</dd> + <dt> + {{domxref("URLUtils.protocol")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant le schéma de protocole de l'URL, incluant le <code>':'</code> final.</dd> + <dt> + {{domxref("URLUtils.host")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant <em>l'hôte,</em> c'est-à-dire le <em>domaine</em>, et, si le <em>port</em> de l'URL n'est pas vide (ce qui peut arriver s'il n'a pas été spécifié ou si la valeur spécifiée est celle du port par défaut du schéma de l'URL), un <code>':'</code>, et le <em>port</em> de l'URL.</dd> + <dt> + {{domxref("URLUtils.hostname")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant le domaine de l'URL.</dd> + <dt> + {{domxref("URLUtils.port")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant le numéro de port de l'URL.</dd> + <dt> + {{domxref("URLUtils.pathname")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant un <code>'/'</code> initial suivi du chemin de l'URL.</dd> + <dt> + {{domxref("URLUtils.search")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant un <code>'?'</code> suivi des paramètres de l'URL.</dd> + <dt> + {{domxref("URLUtils.hash")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant un <code>'#'</code> suivi de <em>l'identifiant de fragment</em> de l'URL.</dd> + <dt> + {{domxref("URLUtils.username")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant le nom d'utilisateur spécifié devant le nom de domaine.</dd> + <dt> + {{domxref("URLUtils.password")}}</dt> + <dd> + Une {{domxref("DOMString")}} contenant le mot de passe spécifié devant le nom de domaine.</dd> + <dt> + {{domxref("URLUtils.origin")}} {{readonlyInline}}</dt> + <dd> + Retourne une {{domxref("DOMString")}} contenant l'origine de l'URL, c'est-à-dire son schéma, son domaine et son port.</dd> + <dt> + {{domxref("URLUtils.searchParams")}}</dt> + <dd> + Retourne un objet {{domxref("URLSearchParams")}} permettant d'accéder aux arguments de requête GET contenus dans l'URL.</dd> +</dl> +<h2 id="Méthodes">Méthodes</h2> +<p><em>Cette interface n'hérite d'aucune méthode.</em></p> +<dl> + <dt> + {{domxref("URLUtils.toString()")}}</dt> + <dd> + Retourne une {{domxref("DOMString")}} contenant l'URL entière. C'est un synonyme de {{domxref("URLUtils.href")}}, sauf qu'il ne peut être utilisé pour modifier la valeur.</dd> +</dl> +<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">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('URL', '#urlutils', 'URLUtils')}}</td> + <td>{{Spec2('URL')}}</td> + <td>Définition initiale</td> + </tr> + </tbody> +</table> +<h2 id="Compatibilité">Compatibilité</h2> +<p>{{ CompatibilityTable() }}</p> +<div id="compat-desktop"> + <table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Support de base</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoDesktop("22")}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + <tr> + <td>searchParams</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("29")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>username</code> et <code>password</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("26")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("26")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin</code> sur <code>Window.location</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoDesktop("21")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> + </table> +</div> +<div id="compat-mobile"> + <table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Support de base</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatGeckoMobile("22")}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + <td>{{CompatNo}} [1]</td> + </tr> + <tr> + <td>searchParams</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>username</code> et <code>password</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile("26")}}</td> + <td>{{CompatNo}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile("26")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>origin</code> sur <code>Window.location</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatGeckoMobile("21")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> + </table> +</div> +<p>[1] Bien qu'elles ne soient pas groupées dans une seule interface abstraite, ces méthodes sont directement disponibles sur les interfaces qui les implémentent, si cette interface est supportée.</p> +<h2 id="Voir_aussi">Voir aussi</h2> +<ul> + <li>Autres interfaces associées aux URL : {{domxref("URL")}}, {{domxref("URLUtils")}}, et {{domxref("URLSearchParams")}}.</li> + <li>Interfaces qui implémentent celle-ci : {{domxref("Location")}}, {{domxref("HTMLAnchorElement")}}, {{domxref("HTMLAreaElement")}}.</li> +</ul> |