| history | NN 2 IE 3 DOM s.o. | |||
Lors d'une session, le navigateur utilise l'objet history pour conserver la liste des adresses URL visitées par l'utilisateur. Cette liste (stockée sous forme de tableau) permet de faciliter la navigation à l'aide des boutons Précédente et Suivante. Certaines informations privées stockées dans l'objet history pouvant être de nature confidentielle, tous les détails ne sont pas exposés aux scripts qui pourraient les enregistrer et les envoyer subrepticement au serveur. Dans les versions récentes des navigateurs, chaque fenêtre gère son propre objet history. |
||||
Pour répondre à une question fréquemment posée: non, vous ne pouvez pas bloquer ou annuler l´action du bouton Précédente. Au mieux, vous pouvez empêcher que la page courante soit entrée dans l´historique du navigateur lorsqu´un utilisateur clique sur un lien à partir de la page. Pour ce faire, définissez les liens par script avec la méthode de navigation location.replace(). Navigator 4 et les versions ultérieures (avec des scripts signés et l´accord explicite de l´utilisateur) peuvent supprimer la barre d´outils de la fenêtre du navigateur (reportez-vous à la section consacrée à l´objet locationbar). Vous pouvez aussi ouvrir une nouvelle fenêtre sans la barre d´outils (reportez-vous à la méthode window.open()). |
||||
| Référence de modèle d'objet | ||||
[window.]history |
||||
| Propriétés spécifiques à l´objet | ||||
|
||||
| Méthodes spécifiques à l´objet | ||||
|
||||
| Propriétés de gestionnaire d´événements spécifiques à l´objet | ||||
Aucune. |
||||
| current, next, previous | NN 4 IE s.o. DOM s.o. |
| Lecture seule | |
Adresses URL courante, suivante et précédente conservées dans le tableau history. Ces informations privées ne peuvent être récupérées dans Navigator 4 (et les versions ultérieures) qu'avec des scripts signés et moyennant l´accord de l'utilisateur. Les scripts signés dépassent la portée de ce manuel, mais vous trouverez toutes les informations nécessaires sur la création et la programmation de scripts signés dans un bon manuel JavaScript. |
|
| Exemple | |
netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead");
var prevURL = parent.otherFrame.history.previous;
netscape.security.PrivilegeManager.revertPrivilege("UniversalBrowserRead");
|
|
| Valeur | |
Chaîne URL. |
|
| Par défaut | |
Aucune. |
|
| length | NN 2 IE 3 DOM s.o. |
| Lecture seule | |
Nombre d'éléments présents dans l'historique. Dans Navigator 4 (et les versions postérieures), vous ne pouvez extraire une entrée d'historique particulière qu'à l'aide de scripts signés et avec l'autorisation de l'utilisateur. |
|
| Exemple | |
if (history.length > 4) {
...
}
|
|
| Valeur | |
Nombre entier. |
|
| Par défaut | |
Aucune. |
|
| back() | NN 2 IE 3 DOM s.o. |
Cette simple action, équivalant à un clic sur le bouton Précédente du navigateur, permet de rappeler le dernier document affiché. Cependant, Navigator 4 et les versions ultérieures permettent de diriger la méthode back() vers une fenêtre ou un cadre particulier, en contournant ainsi le comportement par défaut du bouton Précédente. Par exemple, des appels répétés à parent.otherFrame.history.back() risquent de dépasser la capacité de l'historique et de gêner toute action future. Par contre, des appels répétés à top.history.back() équivalent au fait de cliquer sur le bouton Précédente et permettent, en principe, de remonter entièrement dans le jeu de cadres si vous ne vous trouvez pas au niveau du premier document chargé dans la session courante. |
|
| Paramètres | |
Aucune. |
|
| Valeur renvoyée | |
Aucune. |
|
| forward() | NN 2 IE 3 DOM s.o. |
Cette action permet de se diriger vers la même adresse URL que celle à laquelle mène le bouton Suivante du navigateur (s'il est actif). Veillez à vous entourer des mêmes précautions que pour l'utilisation de la méthode history.back(). |
|
| Paramètres | |
Aucune. |
|
| Valeur renvoyée | |
Aucune. |
|
| go() | NN 2 IE 3 DOM s.o. |
go(nombre_étapes| "adresse_URL") | |
Navigation vers un emplacement particulier de l'historique. |
|
| Paramètres | |
|
|
| Valeur renvoyée | |
Aucune. |
|
| item() | NN 4 IE s.o. DOM s.o. |
item(itemNumber) | |
Ramène l´URL à un emplacement particulier de l'historique. Pour récupérer ces informations privées, les scripts signés de Netscape et l´accord explicite de l´utilisateur sont nécessaires. |
|
| Paramètres | |
|
|
| Valeur renvoyée | |
Chaîne URL. |
|