Experimental
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
DOMString
contenant l'URL entière. -
URLUtils.protocol
-
Une
DOMString
contenant le schéma de protocole de l'URL, incluant le':'
final. -
URLUtils.host
-
Une
DOMString
contenant 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
DOMString
contenant le domaine de l'URL. -
URLUtils.port
-
Une
DOMString
contenant le numéro de port de l'URL. -
URLUtils.pathname
-
Une
DOMString
contenant un'/'
initial suivi du chemin de l'URL. -
URLUtils.search
-
Une
DOMString
contenant un'?'
suivi des paramètres de l'URL. -
URLUtils.hash
-
Une
DOMString
contenant un'#'
suivi de l'identifiant de fragment de l'URL. -
URLUtils.username
-
Une
DOMString
contenant le nom d'utilisateur spécifié devant le nom de domaine. -
URLUtils.password
-
Une
DOMString
contenant le mot de passe spécifié devant le nom de domaine. -
URLUtils.origin
Lecture seule -
Retourne une
DOMString
contenant l'origine de l'URL, c'est-à-dire son schéma, son domaine et son port. -
URLUtils.searchParams
-
Retourne un objet
URLSearchParams
permettant 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
DOMString
contenant 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. |
Standard évolutif | 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
.