Objet Location Window

Objet Location Window

L'objet Location contient des informations sur l'URL actuelle.

L'objet Location est une propriété de l'objet fenêtre.

L'objet Location peut être accédé de la manière suivante :

window.location ou simplement location

Exemple

let origin = window.location.origin;

Essayez-le vous-même

let origin = location.origin;

Essayez-le vous-même

Attributs de l'objet Location

Attribut Description
hash Définissez ou retournez la partie ancre de l'URL (#).
host Définissez ou retournez le nom d'hôte et le port de l'URL.
hostname Définissez ou retournez le nom d'hôte de l'URL.
href Définissez ou retournez l'URL complète.
origin Retournez le protocole, le nom d'hôte et le port de l'URL.
pathname Définissez ou retournez le nom de chemin de l'URL.
port Définissez ou retournez le port de l'URL.
protocol Définissez ou retournez le protocole de l'URL.
search Définissez ou retournez la partie de la requête de l'URL.

Méthodes de l'objet Location

Méthode Description
assign() Chargez un nouveau document.
reload() Rechargez le document actuel.
replace() Remplacez le document actuel par un nouveau document.

Description de l'objet Location

L'objet Location est stocké dans l'attribut Location de l'objet Window, représentant l'adresse Web du document actuellement affiché dans cette fenêtre. Son attribut hrefcontient l'URL complète du document, les autres attributs décrivant les différentes parties de l'URL. Ces attributs sont très similaires à l'attribut URL de l'objet Anchor (ou Area). Lorsque l'objet Location est converti en chaîne, la valeur de l'attribut href est retournée. Cela signifie que vous pouvez utiliser l'expression location à la place de location.href.

Cependant, l'objet Anchor représente un lien hypertexte dans le document, tandis que l'objet Location représente l'URL (ou la position) du document actuellement affiché dans le navigateur. Cependant, l'objet Location peut faire bien plus que cela, il peut également contrôler la position du document affiché par le navigateur. Si vous affectez une chaîne contenant une URL à l'objet Location ou à son attribut href, le navigateur charge le document pointé par la nouvelle URL et le montre.

En plus de remplacer l'URL actuelle par une URL complète en utilisant location ou location.href, vous pouvez modifier une partie de l'URL, il suffit d'affecter d'autres attributs de l'objet Location. Cela crée une nouvelle URL, une partie de laquelle est différente de l'URL originale, le navigateur la charge et la montre. Par exemple, si vous définissez l'objet Location attribut hashalors le navigateur se déplace vers une position spécifique dans le document actuel. De même, si vous définissez attribut searchAlors, le navigateur recharge l'URL avec la nouvelle chaîne de requête ajoutée.

En plus de la propriété URL, l'objet Location]} Méthode reload()Peut recharger le document actuel,replace() Peut charger un nouveau document sans créer un nouvel historique, c'est-à-dire que dans la liste d'historique du navigateur, le nouveau document remplacera le document actuel.