Objet Location
Objet Location
L'objet Location contient des informations sur l'URL actuelle.
L'objet Location fait partie de l'objet Window et peut être accédé via l'attribut window.location.
Exemple
Attributs de l'objet Location
Attribut | Description |
---|---|
hash | Définir ou retourner la partie de l'URL à partir du dièse (#). |
host | Définir ou retourner le nom d'hôte et le port de l'URL actuelle. |
hostname | Définir ou retourner le nom d'hôte de l'URL actuelle. |
href | Définir ou retourner l'URL complet. |
pathname | Définir ou retourner la partie de l'URL du chemin. |
port | Définir ou retourner le port de l'URL actuelle. |
protocol | Définir ou retourner le protocole de l'URL actuelle. |
search | Définir ou retourner la partie de l'URL à partir du point d'interrogation (?). |
Méthode de l'objet Location
Attribut | Description |
---|---|
assign() | Charger un nouveau document. |
reload() | Recharger le document actuel. |
replace() | Remplacer 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 affiché dans cette fenêtre. Il s'agit de Attribut hrefIl s'agit de l'URL complet du document, d'autres attributs décrivent respectivement les différentes parties de l'URL. Ces attributs sont très similaires à l'attribut URL de l'objet Anchor (ou de l'objet Area). Lorsque l'objet Location est converti en chaîne de caractères, la valeur de l'attribut href est retournée. Cela signifie que vous pouvez utiliser l'expression location pour remplacer 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é actuellement par 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 une chaîne de caractères contenant une URL est assignée à l'objet Location ou à sa propriété href, le navigateur chargera et affichera le document pointé par la nouvelle URL.
En plus de remplacer l'URL actuelle par une URL complète en utilisant location ou location.href, il est possible de modifier une partie de l'URL, il suffit deassigner des valeurs aux autres propriétés de l'objet Location. Cela crée une nouvelle URL, dont une partie est différente de l'URL originale, le navigateur la chargera et l'affichera. Par exemple, si l'objet Location propriété hashalors le navigateur se déplace vers une position spécifiée dans le document actuel. De même, si 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 est possible de recharger le document actuel,replace() Il est possible de charger un nouveau document sans avoir à créer un nouveau historique, c'est-à-dire que dans la liste d'historique du navigateur, le nouveau document remplacera le document actuel.