Location

L'interface Location représente l'emplacement de l'objet auquel elle est liée. Les changements effectués dessus sont reflétés sur l'objet lié. Les deux interfaces Document et Window sont liées à une Location, accessible via Document.location et Window.location respectivement.

Propriétés

L'interface Location n'hérite d'aucune propriété, mais implémente celles de URLUtils.

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, un ':', et le numéro de 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é avant le nom de domaine.
URLUtils.password
Une DOMString contenant le mot de passe spécifié avant le nom de domaine.
URLUtils.origin Lecture seule
Retourne une DOMString contenant la forme canonique de l'origine de la location.

Méthodes

L'interface Location n'hérite d'aucune méthode, mais implémente celles de URLUtils.

Location.assign()
Charge la ressource située à l'URL passée en paramètre.
Location.reload()
Recharge la ressource depuis l'URL actuelle. Son unique paramètre facultatif est un Boolean, qui, s'il est true, implique que la page est toujours rechargée depuis le serveur. Si ce paramètre est false ou non spécifié, le navigateur peut éventuellement recharger la page depuis son cache.
Location.replace()
Remplace la ressource actuelle par celle à l'URL passée en paramètre. la différence avec la méthode assign() est que, après avoir utilisé replace(), la page actuelle ne sera pas enregistrée dans l'historique de session History, ce qui signifie que l'utilisateur ne pourra pas utiliser le bouton précédent pour y revenir.
URLUtils.toString()
Retourne une DOMString contenant l'URL entière. C'est un synonyme de URLUtils.href, sauf que toString() ne peut être utilisée pour modifier la valeur.

Spécifications

Spécification Statut Commentaires
WHATWG HTML Living Standard
La définition de 'Location' dans cette spécification.
Living Standard Pas de différence avec HTML5.
HTML5
La définition de 'Location' dans cette spécification.
Candidate Recommendation Définition initiale.

Compatibilité

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support basique (Oui) (Oui) (Oui) (Oui) (Oui)
origin sur Window.location ? 21 (21) ? ? ?
origin sur tous les objets location ? 26 (26) ? ? ?
username et password ? 26 (26) ? ? ?
Fonctionnalité Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support basique (Oui) (Oui) (Oui) (Oui) (Oui)
origin sur Windows.location ? 21.0 (21) ? ? ?
origin sur tous les objets location ? 26.0 (26) ? ? ?
username et password ? 26.0 (26) ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : Goofy, Watilin
 Dernière mise à jour par : Goofy,