L'objet Location

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éfinir ou renvoyer la partie ancre de l'URL (#).
host Définir ou renvoyer le nom d'hôte et le port de l'URL.
hostname Définir ou renvoyer le nom d'hôte de l'URL.
href Définir ou renvoyer l'URL complète.
origin Renvoie le protocole, le nom d'hôte et le port de l'URL.
pathname Définir ou renvoyer le nom de chemin de l'URL.
port Définir ou renvoyer le port de l'URL.
protocol Définir ou renvoyer le protocole de l'URL.
search Définir ou renvoyer 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, et représente l'adresse Web du document affiché dans cette fenêtre. Il l'attribut hrefcontient l'URL complète du document, tandis que les autres attributs décrivent 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 affiché par le navigateur actuel. 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 assignez une chaîne contenant une URL à l'objet Location ou à son attribut href, le navigateur chargera et affichera le document pointé par cette nouvelle URL.

En plus de remplacer l'URL actuelle par une URL complète en utilisant location ou location.href, vous pouvez également modifier une partie de l'URL, ce qui nécessite de donner des valeurs aux autres attributs de l'objet Location. Cela créera une nouvelle URL, une partie de laquelle est différente de l'URL originale, et le navigateur la chargera et l'affichera. Par exemple, supposons que vous ayez configuré l'objet l'attribut hash， alors le navigateur se déplacera vers une position spécifique dans le document actuel. De même, si vous avez configuré propriété searchalors le navigateur recharge l'URL avec une nouvelle chaîne de requête ajoutée.

En plus de la propriété URL, l'objet Location, Méthode reload()Il peut recharger le document actuel,replace() Il 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.