JavaScript : l'objet location

La position des objets history et location est particulière, car ils n'ont pas d'impact sur le contenu du document (revoir la structure hiérarchique des objets).

L'objet location est tout simplement l'URL (l'adresse) d'un document, il n'est pas le document lui-même. Il est donc possible d'accéder aux différentes propriétés, mais celle que nous utiliserons le plus souvent sera location.href.La propriété href permet d'effectuer un lien vers d'autres pages, ou d'autres fichiers.

Objet location : Propriétés

Nous pouvons accéder à différentes propriétés de l'objet JavaScript location pour obtenir ou manipuler certaines informations relatives à l'adresse du document.

Propriétés de l'objet location 
Propriété | Description | Exemple |
hash | le lien vers une partie spécifique du document (la partie de l'adresse qui suit le symbole #). | #javascript-location-properties |
host | Le nom de l'hôte (généralement une adresse IP ou un nom de domaine), et le numéro de port (sauf s'il s'agit du port par défaut, le port 80). | www.gaudry.be:8080 |
hostname | Le nom de l'hôte sans le numéro de port. | www.gaudry.be |
href | L'adresse en entier | https://www.gaudry.be/en/javascript-location.html?test=toto#javascript-location-properties |
origin | Le protocole, suivi de la valeur de host | https://www.gaudry.be:8080 |
pathname | Le chemin relatif à l'hôte | javascript-location.html |
port | Le numéro de port1 | 8080 |
protocol | La partie protocole de l'URL. | https |
search | La partie de la requête envoyée dans l'URL (partie qui suit le point d'interrogation). | ?test=toto |

Objet location : Méthodes

Méthodes de l'objet location 
Propriété | Description | Exemple |
assign() | Charge le document qui se trouve à l'adresse spécifiée | location.assign("https://www.gaudry.be/en/infobrol.html"); |
reload() | Recharge le document actuel. Selon la valeur de l'argument, true recharge depuis le serveur; false recharge depuis le cache dans le navigateur. | location.reload(false); |
replace() | Remplace le document actuel par celui à l'adresse spécifiée. La différence avec assign() est que replace() n'enregistre pas le changement dans l'historique de navigation. | location.replace("https://www.gaudry.be/en/infobrol.html"); |
toString() | Renvoie l'URL sous forme de chaîne de caractères. | location.toString() |

Contents Haut

English translation

You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.

If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.

Thank you in advance.

Document created the 19/03/2002, last modified the 01/01/1970
Source of the printed document:https://www.gaudry.be/en/javascript-window-location.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

Notes

  1.  location.port=80 : Si l'URL utilise le port par défaut (le port 80), une chaîne de caractères vide est renvoyée.

Contents Haut