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