locationNN 2 IE 3 DOM s.o.

Chaque fenêtre ou cadre contient un objet location. Cet objet stocke toutes les informations sur l'adresse URL du document en cours de chargement dans la fenêtre ou le cadre. En affectant une nouvelle adresse URL à la propriété href de l'objet location, vous indiquez au navigateur qu'il doit charger une nouvelle page dans cette fenêtre ou ce cadre. Voici la principale méthode pour charger une nouvelle page par script:

location.href = "newPage.html";
 

Pour charger un nouveau document dans un autre cadre, un script de cadre peut faire référence à l'objet location contenu dans cet autre cadre:

parent.otherFrameName.location.href = "newPage.html";
 

Pour des raisons de sécurité, un script de cadre ne peut pas accéder aux informations de l'objet location d'un autre cadre si le document présent dans ce dernier ne provient pas du même domaine (et du même serveur, à moins que les propriétés document.domain des deux documents correspondent) que le document du script en question. De cette façon, le script ne peut pas surveiller la navigation, à partir d'un autre cadre, vers des sites Web externes. Dans Navigator 4 et les versions ultérieures, vous pouvez utiliser des scripts signés pour contourner ces restrictions de sécurité, mais l'utilisateur doit toujours donner son autorisation pour permettre à un script d'accéder aux informations relatives à l'objet location, situées en dehors du domaine du script.

 

En tant qu´objet ayant trait aux fenêtres, l´objet location ne fait pas partie des spécifications du DOM W3C DOM niveau 1 ou 2 (les fenêtres seront donc à traiter dans les versions futures). Mais l´objet location et ses propriétés sont bien enracinées dans la création de scripts et devrait être pris en charge pendant encore longtemps.

 
Référence de modèle d'objet
 
[windowRef.]location
 
Propriétés spécifiques à l´objet
 
hashhosthostnamehrefpathnameportprotocolsearch
 
Méthodes spécifiques à l´objet
 
assign()reload()replace()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

hashNN 2 IE 3 DOM s.o.

Lecture/écriture

Indique la partie de l'adresse URL suivant le symbole #, qui désigne l'emplacement d'une ancre dans un document. Cette propriété ne contient de données que si l'utilisateur a volontairement cliqué sur une ancre, au lieu de se déplacer vers celle-ci. N'insérez pas le symbole # lorsque vous définissez la propriété.

 
Exemple
 
location.hash = "section3";
 
Valeur

Chaîne.

 
Par défaut

Aucune.

hostNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit la combinaison du nom d'hôte et du port du serveur (s'il existe) qui héberge le document courant. Si le port fait explicitement partie de l'adresse URL, le nom d'hôte et le port sont séparés par le signe deux points, tout comme dans l'adresse URL.

 
Exemple
 
if (location.host == "www.megacorp.com:80") {
    ...
}
 
Valeur

Chaîne du nom d'hôte, éventuellement suivie par deux points et le numéro du port.

 
Par défaut

Dépend du serveur.

hostnameNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit la combinaison du nom d'hôte du serveur (par exemple une adresse « à deux points » comprenant le nom du serveur et le domaine) qui héberge le document courant. La propriété hostname ne comporte pas le numéro de port.

 
Exemple
 
if (location.hostname == "www.megacorp.com") {
    ...
}
 
Valeur

Chaîne du nom d'hôte (serveur et domaine).

 
Par défaut

Dépend du serveur.

hrefNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit l´adresse URL complète du document chargé dans la fenêtre ou le cadre. En affectant une adresse URL à cette propriété, vous créez un script indiquant comment naviguer pour charger un nouveau document dans la fenêtre ou le cadre (pour ce faire, Internet Explorer permet également d'utiliser la méthode window.navigate()).

 
Exemple
 
location.href = "http://www.megacorp.com";
 
Valeur

Chaîne d'une adresse URL complète ou relative.

 
Par défaut

Aucune.

pathnameNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit le composant de nom de chemin de l'adresse URL. Il comprend toutes les données de l'adresse URL qui suivent le dernier caractère du nom de domaine, y compris la barre oblique initiale.

 
Exemple
 
location.pathname = "/images/logoHiRes.gif";
 
Valeur

Chaîne.

 
Par défaut

Aucune.

portNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit le composant de port de l'adresse URL, s'il existe. Il se compose de tous les éléments de l'adresse URL qui suivent le signe deux points après le dernier caractère du nom de domaine. Le signe deux points ne fait pas partie de la valeur de la propriété port.

 
Exemple
 
location.port = "80";
 
Valeur

Chaîne (valeur numérique sous forme de chaîne).

 
Par défaut

Aucune.

protocolNN 2 IE 3 DOM s.o.

Lecture/écriture

Fournit le composant du protocole de l'adresse URL. Il comprend tous les éléments de l'adresse URL jusqu'au premier signe deux points inclus. Quelques valeurs types: "http:", "file:", "ftp:" et "mailto:".

 
Exemple
 
if (location.protocol == "file:") {
    // statements for treating document as local file
}
 
Valeur

Chaîne.

 
Par défaut

Aucune.

assign()NN 2 IE 3 DOM s.o.

assign("adresse_URL")

A l'origine, cette méthode était censée être masquée à la vue des auteurs de script, mais elle est toujours disponible pour le moment. Elle produit le même effet que lorsque vous affectez une adresse URL à la propriété location.href. La méthode assign() est mentionnée ici à titre d'informations et ne devrait pas être utilisée.

 
Paramètres
 
  • Valeur, sous forme de chaîne, représentant l'adresse URL complète ou relative d'un document à charger dans une fenêtre ou un cadre.
 
Valeur renvoyée

Aucune.

reload()NN 3 IE 4 DOM s.o.

reload([inconditionnel])

Recharge complètement le document associé à l'objet location. Lors de cette opération, les valeurs par défaut des éléments de formulaires sont rétablies (pour un rechargement partiel, utilisez history.go(0)). Par défaut, la méthode reload() exécute une action get conditionnelle; le fichier est dès lors récupéré dans la mémoire cache du navigateur s'il s'y trouve encore (et si la mémoire cache est activée). Pour forcer un rechargement depuis le serveur, exécutez une action get inconditionnelle en ajoutant le paramètre booléen true.

 
Paramètres
 
  • Valeur booléenne facultative. Lorsque la valeur est true, le navigateur exécute une action get inconditionnelle pour que le rechargement du document s'effectue depuis le serveur plutôt que depuis la mémoire cache du navigateur.
 
Valeur renvoyée

Aucune.

replace()NN 3 IE 4 DOM s.o.

replace("adresse_URL")

Charge un nouveau document dans la fenêtre de référence et remplace l'entrée du document dans la liste d'historique du navigateur par l'entrée du nouveau document. De cette façon, les pages intermédiaires que vous ne souhaitez pas garder dans l'historique (afin que le bouton Précédente n'y revienne plus) peuvent être supprimées de l´historique et remplacées par l'entrée du nouveau document chargé.

 
Paramètres
 
  • Valeur, sous forme de chaîne, représentant l'adresse URL complète ou relative d'un document à charger dans une fenêtre ou un cadre.
 
Valeur renvoyée

Aucune.