Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
L'interface URLUtils définit des méthodes utilitaires pour travailler avec les URL.
il n'y a pas d'objets de ce type, mais quelques objets l'implémentent, comme Location, URL, HTMLAnchorElement, et HTMLAreaElement.
Propriétés
Cette interface n'hérite d'aucune propriété.
-
URLUtils.href -
Une
DOMStringcontenant l'URL entière. -
URLUtils.protocol -
Une
DOMStringcontenant le schéma de protocole de l'URL, incluant le':'final. -
URLUtils.host -
Une
DOMStringcontenant l'hôte, c'est-à-dire le domaine, et, si le port 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':', et le port de l'URL. -
URLUtils.hostname -
Une
DOMStringcontenant le domaine de l'URL. -
URLUtils.port -
Une
DOMStringcontenant le numéro de port de l'URL. -
URLUtils.pathname -
Une
DOMStringcontenant un'/'initial suivi du chemin de l'URL. -
URLUtils.search -
Une
DOMStringcontenant un'?'suivi des paramètres de l'URL. -
URLUtils.hash -
Une
DOMStringcontenant un'#'suivi de l'identifiant de fragment de l'URL. -
URLUtils.username -
Une
DOMStringcontenant le nom d'utilisateur spécifié devant le nom de domaine. -
URLUtils.password -
Une
DOMStringcontenant le mot de passe spécifié devant le nom de domaine. -
URLUtils.originLecture seule -
Retourne une
DOMStringcontenant l'origine de l'URL, c'est-à-dire son schéma, son domaine et son port. -
URLUtils.searchParams -
Retourne un objet
URLSearchParamspermettant d'accéder aux arguments de requête GET contenus dans l'URL.
Méthodes
Cette interface n'hérite d'aucune méthode.
-
URLUtils.toString() -
Retourne une
DOMStringcontenant l'URL entière. C'est un synonyme deURLUtils.href, sauf qu'il ne peut être utilisé pour modifier la valeur.
Spécifications
| Spécification | Statut | Commentaires |
|---|---|---|
| URL La définition de 'URLUtils' dans cette spécification. |
Living Standard | Définition initiale |
Compatibilité
| Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Support de base | Pas de support [1] | 22 (22) [1] | Pas de support [1] | Pas de support [1] | Pas de support [1] |
| searchParams | ? | 29 (29) | Pas de support | ? | ? |
username et password |
? | 26 (26) | Pas de support | ? | ? |
origin |
? | 26 (26) | ? | ? | ? |
origin sur Window.location |
? | 21 (21) | ? | ? | ? |
| Fonctionnalité | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support de base | Pas de support [1] | Pas de support [1] | 22.0 (22) [1] | Pas de support [1] | Pas de support [1] | Pas de support [1] |
| searchParams | ? | ? | Pas de support | Pas de support | ? | ? |
username et password |
? | ? | 26.0 (26) | Pas de support | ? | ? |
origin |
? | ? | 26.0 (26) | ? | ? | ? |
origin sur Window.location |
? | ? | 21.0 (21) | ? | ? | ? |
[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.
Voir aussi
- Autres interfaces associées aux URL :
URL,URLUtils, etURLSearchParams. - Interfaces qui implémentent celle-ci :
Location,HTMLAnchorElement,HTMLAreaElement.