JavaScript
Partie 3 sur 4
7Les objets du navigateur
7.1La hiérarchie
Lorsqu’il ouvre une page, le navigateur crée des objets prédéfinis qui décrivent la page et l’état du navigateur. Ils forment une hiérarchie, au sommet de laquelle se trouve l’objet window, la fenêtre ou l’onglet :
window: la fenêtre elle-même, parent de tous les autres objets ; ses propriétésparent,selfettopdésignaient les fenêtres englobantes, etframesle tableau des cadres, chacun accessible parwindow.frames[i]ou par son nom ;navigator: des informations sur le navigateur ;location: l’adresse de la page ; modifierlocation.hrefcharge une autre page ;history: l’historique de l’onglet ;document: le contenu de la page, avec les anciennes collectionsimages,forms,linksetanchorspour accéder aux images, formulaires, liens et ancres.
On accède à un objet en parcourant la hiérarchie depuis le sommet, en séparant les niveaux par des points : window.document.forms[0], par exemple ; le préfixe window peut être omis. Certaines propriétés sont modifiables, d’autres en lecture seule. Ces objets dépendent du contenu de la page, à l’exception de navigator, fixe pour un visiteur donné.
7.2Le DOM
Aujourd’hui, on n’accède plus aux éléments par les vieilles collections, mais par le DOM, pour Document Object Model, « modèle objet du document », l’arbre des éléments que le navigateur construit à partir du HTML. Ses fonctions permettent de trouver un élément, de lire ou modifier son texte, ses attributs, ses classes, d’en créer de nouveaux :
const titre = document.querySelector("h1"); // premier élément h1
titre.textContent = "Nouveau titre"; // modifier le texte
document.querySelector("#menu").classList.add("ouvert");
const item = document.createElement("li"); // créer un élément
item.textContent = "Article ajouté";
document.querySelector("ul").append(item);
C’est ce qu’on appelait le DHTML, pour HTML dynamique : une page dont les éléments peuvent être modifiés, déplacés ou animés après son chargement. Il fallait alors écrire un code différent pour Netscape 4 et Internet Explorer 4, qui avaient chacun leur propre modèle ; le DOM, normalisé, a mis fin à ces incompatibilités.
7.3Les boîtes de dialogue
L’objet window propose trois boîtes de dialogue, qui s’affichent au premier plan et bloquent la page jusqu’à ce que l’utilisateur réponde :
alert("message")avertit l’utilisateur, avec un seul bouton OK ;confirm("question")lui demande de choisir entre OK et Annuler, et renvoietrueoufalse;prompt("question", "valeur par défaut")ouvre une boîte d’invite où il peut saisir un texte, renvoyé par la fonction ; elle renvoie null si l’utilisateur annule.
Le paramètre est une chaîne de caractères, que l’on peut composer par concaténation avec l’opérateur + : alert("Bonjour " + nom). Certains caractères s’écrivent précédés d’un antislash : \n pour un retour à la ligne, \' pour une apostrophe dans une chaîne délimitée par des apostrophes. On conseille de les utiliser avec parcimonie, car elles obligent l’utilisateur à agir et deviennent vite énervantes ; elles restent pratiques pour déboguer, c’est-à-dire repérer les erreurs, même si la console des outils de développement, avec console.log(), est bien plus commode. Une boîte d’alerte affichée dès le chargement de la page montre d’ailleurs surtout ce que l’abus de JavaScript peut donner : à utiliser avec modération. Les sites utilisent aujourd’hui des fenêtres dessinées en HTML, comme l’élément <dialog>. Enfin, les navigateurs signalent que ces boîtes viennent de la page et non du système, pour limiter l’usurpation : un site malveillant pourrait sinon se faire passer pour Windows ou pour le fournisseur d’accès et demander un mot de passe (coin cyber).
7.4Les fenêtres
L’objet window a des propriétés, dont name, le nom de la fenêtre, length, le nombre de cadres, et status et defaultStatus, qui affichaient un message dans la barre d’état ; ces deux dernières n’ont plus d’effet, car les navigateurs empêchaient ainsi les pages de masquer l’adresse réelle des liens. La méthode open() ouvre une nouvelle fenêtre :
window.open("aide.html", "aide", "width=400,height=300");
Ses options, séparées par des virgules sans espace, réglaient la présence des barres : directories, location, menubar, scrollbars, status, toolbar, ainsi que resizable, width et height. Les navigateurs actuels ignorent la plupart d’entre elles et affichent toujours la barre d’adresse, pour que l’internaute sache où il se trouve. Après les abus des années 2000, ils bloquent aussi les fenêtres surgissantes qui ne font pas suite à un clic. La méthode close(), enfin, ne prend pas de paramètre, contrairement à ce qu’on lit parfois, et un script ne peut fermer que les fenêtres qu’il a lui-même ouvertes. Pour les liens écrits dans des attributs, on remplace les guillemets doubles par des simples ou par l’entité ", et l’apostrophe par \'.
7.5L’historique et l’adresse
L’objet history donne accès à l’historique de l’onglet, la liste des URL visitées. On en fait parfois une propriété de document : c’est en réalité window.history. Sa propriété length indique le nombre de pages de l’historique ; back() et forward() équivalent aux boutons précédent et suivant ; go(n) se déplace de n pages, en avant si n est positif, en arrière s’il est négatif. Pour des raisons de sécurité, un script ne peut pas lire les adresses des pages visitées ; la possibilité de passer une chaîne de caractères à go() a disparu. Les applications modernes utilisent en revanche history.pushState() pour modifier l’adresse affichée sans recharger la page, ce qui permet aux applications d’une seule page de conserver le fonctionnement du bouton précédent.
7.6L’objet navigator
L’objet navigator renseigne sur le navigateur du visiteur. Toutes ses propriétés sont en lecture seule. Autrefois, il servait surtout à détecter le navigateur, car Netscape et Internet Explorer n’interprétaient pas toutes les balises et instructions de la même manière, et chacun avait ses balises propriétaires. En voici la liste :
| Élément | Rôle | Aujourd’hui |
|---|---|---|
appCodeName | nom de code du navigateur | vaut « Mozilla » dans tous les navigateurs |
appName | nom du navigateur | vaut « Netscape » dans tous les navigateurs actuels, pour compatibilité |
appVersion, userAgent | version, chaîne d’identification complète | chaînes de plus en plus simplifiées, peu fiables |
navigator.language | langue de l’interface du navigateur | toujours utile, avec languages |
platform | système d’exploitation | déconseillée |
mimeTypes, plugins, plugins.refresh() | types de fichiers et modules externes gérés | ne renvoient plus que des listes fixes, les modules externes ayant disparu |
javaEnabled() | applets Java activées ? | renvoie toujours faux |
preference(), savePreferences(), taintEnabled() | préférences du navigateur, protection des données | propres à Netscape, disparues |
On recommandait autrefois de commencer chaque script par un test du nom et de la version du navigateur, avec un tableau des valeurs renvoyées par Netscape 2 à 4 et Internet Explorer 3 à 5, dont l’identifiant contenait la mention « MSIE ». Cette pratique, appelée détection du navigateur, est aujourd’hui proscrite : les navigateurs mentent tous sur leur identité, par compatibilité, et un test sur le nom exclut les navigateurs inconnus. On pratique la détection des fonctionnalités : vérifier directement que la fonction dont on a besoin existe.
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(afficherCarte);
} else {
afficherFormulaireAdresse();
}
Pour s’exercer
Exercice 3 : moderniser un ancien script
Réécrivez ce code dans un style actuel : <a href="javascript:;" onClick="if (confirm('Supprimer ?')) document.forms[0].submit();">Supprimer</a>.
Voir la réponse
En HTML, un vrai bouton dans le formulaire : <button type="submit" id="supprimer">Supprimer</button>. En JavaScript, dans un fichier séparé : document.querySelector("#supprimer").addEventListener("click", (e) => { if (!confirm("Supprimer ?")) e.preventDefault(); });. Le bouton fonctionne au clavier et sans souris, l’action n’est plus cachée dans une adresse javascript:, le code est séparé du contenu et compatible avec une politique de sécurité stricte. preventDefault() annule l’envoi si l’utilisateur répond non. Côté serveur, la suppression doit bien sûr vérifier les droits de l’utilisateur.
Exercice 4 : détecter, pas deviner
Un ancien script contient : if (navigator.appName == "Netscape") { … } else { … }. Que se passe-t-il dans les navigateurs actuels ? Par quoi le remplacer ?
Voir la réponse
Tous les navigateurs actuels renvoient « Netscape » pour appName, par compatibilité : Chrome, Safari, Edge et Firefox exécuteraient tous la première branche, prévue pour Netscape 4, avec des fonctions qui n’existent plus. On remplace ce test par une détection des fonctionnalités : on vérifie la présence de la fonction utilisée, par exemple if ("IntersectionObserver" in window), et l’on prévoit un comportement de repli sinon. Ainsi, le script fonctionnera aussi dans les navigateurs futurs.
8Les événements
8.1Le principe
Un événement est ce qui se produit dans la page, le plus souvent à l’initiative de l’utilisateur : un clic de souris, une touche enfoncée, un champ modifié, mais aussi la fin d’un chargement ou une erreur. Les gestionnaires d’événements, ou écouteurs, associent une action à un événement : quand il survient, le navigateur appelle la fonction prévue (figure 1).
Autrefois, on écrivait le gestionnaire dans un attribut de la balise, de la forme onEvenement="action", par exemple onclick ou onmouseover. On utilise aujourd’hui la méthode addEventListener(), comme dans la figure 1 : elle sépare le comportement du contenu, permet d’associer plusieurs fonctions à un même événement, et reste compatible avec les politiques de sécurité strictes. La fonction reçoit un objet qui décrit l’événement : l’élément visé, la touche enfoncée, la position de la souris.
8.2Les principaux événements
Chaque événement s’applique à certains objets : un événement de modification ne concerne pas un lien, par exemple. Le tableau 6 en donne la liste.
| Événement | Se produit quand… | Aujourd’hui |
|---|---|---|
click, dblclick | l’utilisateur clique, double-clique | toujours là ; click est aussi déclenché au clavier et au doigt |
mousedown, mouseup, mousemove | bouton enfoncé, relâché, souris déplacée | remplacés avantageusement par les événements de pointeur, communs à la souris, au stylet et au doigt |
mouseover, mouseout | la souris entre sur un élément, en sort | toujours là ; les effets de survol se font plutôt en CSS |
focus, blur | un élément devient actif, perd le focus | toujours là |
change, select | le contenu d’un champ a été modifié ; du texte est sélectionné dans un champ | toujours là, complétés par input, déclenché à chaque frappe |
keydown, keyup | touche enfoncée, relâchée | toujours là ; on associe parfois par erreur keyup à onKeypress |
keypress | touche produisant un caractère | obsolète |
submit, reset | envoi, remise à zéro d’un formulaire | toujours là |
load, error, abort | chargement terminé, erreur, chargement interrompu, d’une page ou d’une image | toujours là ; DOMContentLoaded signale que le HTML est prêt, sans attendre les images |
unload | l’utilisateur quitte la page | déconseillé, peu fiable ; on utilise pagehide ou visibilitychange |
resize, move | fenêtre redimensionnée, déplacée | resize reste ; move a disparu |
dragdrop | glisser-déposer sur la fenêtre | propre à Netscape ; remplacé par dragstart, dragover et drop |
On associait aussi autrefois les événements à des objets comme Button, Checkbox, FileUpload, Password, Image, Link, Area ou Layer, ce dernier n’existant que dans Netscape 4. Dans le DOM moderne, presque tous les événements peuvent être écoutés sur presque tous les éléments, et ils se propagent dans l’arbre : un clic sur un bouton est aussi un clic sur son paragraphe, sur le corps de la page, puis sur le document. On peut ainsi écouter, sur une liste, les clics de tous ses articles, présents ou futurs : c’est la délégation d’événements.
8.3Deux exemples, revus
Prenons deux exemples. Le premier ouvre une boîte de dialogue par un lien <a href="javascript:;" onclick="window.alert('…')">. On écrit aujourd’hui un vrai bouton, <button type="button">, accessible au clavier et annoncé correctement par les lecteurs d’écran, et non un lien qui ne mène nulle part ; les adresses javascript: sont à éviter. On lit aussi qu’un attribut href vide risquerait de « révéler le contenu de votre répertoire » : c’est une confusion, un lien vide recharge simplement la page en cours ; l’affichage de la liste des fichiers d’un répertoire dépend de la configuration du serveur, qu’il faut d’ailleurs désactiver. Le second crée un rollover, une image qui change au survol, avec onmouseover et onmouseout : la pseudo-classe CSS :hover fait aujourd’hui la même chose, sans aucun script. Une règle de courtoisie reste valable : ne pas copier les scripts d’autrui sans accord, et citer sa source, en respectant la licence du code.