Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Événements du navigateur et propagation

Les événements permettent de réagir aux actions de l’utilisateur et aux changements d’état de la page. Découvrez la capture, la cible et la remontée, la différence entre annuler l’action par défaut et arrêter la propagation, ainsi que les événements de cycle de vie, de visibilité, de défilement, de redimensionnement et de saisie.

Version : Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.

Syntaxe

target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);

Modèle et portée

Les événements du navigateur relèvent des API de l’environnement hôte, pas de la syntaxe ECMAScript. La norme DOM définit le modèle d’événements, leur distribution, leur propagation et les options des écouteurs. La norme HTML précise notamment quand se déclenchent DOMContentLoaded, load et les événements input et change des contrôles de formulaire. Ne rattachez pas ces API à une édition d’ECMAScript. Node 24 ne prouve pas la prise en charge des API du navigateur. Vérifiez leur compatibilité avec les navigateurs cibles.

Propagation et annulation

addEventListener(type, handler, options) inscrit un gestionnaire. L’événement passe par la capture chez les ancêtres, la cible puis, si bubbles est vrai, remonte chez les ancêtres. target désigne la cible, currentTarget l’objet de l’écouteur actif. stopPropagation() arrête la propagation sans empêcher l’appel des écouteurs restants dans la série en cours. Toutefois, si un écouteur de capture sur la cible appelle stopPropagation(), la série distincte d’appels aux écouteurs sans capture sur cette même cible n’a pas lieu. stopImmediatePropagation() empêche aussi l’appel des écouteurs restants dans la série en cours. preventDefault() annule l’action par défaut si l’événement est annulable et l’écouteur non passif. Il n’arrête pas la propagation.

Cycle de vie et visibilité

DOMContentLoaded sur document : l’analyse et les scripts qui le retardent sont terminés, pas forcément le chargement des ressources. load sur window attend aussi les ressources qui le retardent. pageshow et pagehide couvrent le cache de navigation arrière/avant : vérifiez persisted. À visibilitychange sur document, lisez document.visibilityState. Masquée ne veut pas dire fermée ; unload ne garantit pas une sauvegarde finale.

Défilement, taille et saisie

scroll concerne la cible défilée ; resize sur window, la taille de la zone d’affichage. Tout ne remonte pas. Gardez les gestionnaires fréquents légers. input signale une édition par l’utilisateur, change sa validation selon le contrôle ; affecter .value ne déclenche ni l’un ni l’autre. Distinguez keydown, les événements de pointeur et le click sémantique. Ne comptez pas que sur la souris.

Gestion des écouteurs

once retire l’écouteur avant le premier appel de son gestionnaire. Si ce gestionnaire déclenche de façon synchrone un autre événement du même type, l’écouteur retiré ne le traite pas. passive rend preventDefault() inopérant ; signal permet le retrait par interruption. Pour removeEventListener, gardez le type, la référence de fonction et la valeur de capture. Dans l’exemple synchrone, dispatchEvent() renvoie false pour une annulation, pas un arrêt de propagation.

Identifiants de référence couverts par cette entrée : Page lifecycle, visibility, scroll/resize and input events.

Exemples

(() => {
  const parent = document.createElement('div');
  const child = document.createElement('button');
  parent.append(child);
  const log = [];

  parent.addEventListener('demo', () => log.push('capture'), { capture: true });
  child.addEventListener('demo', event => {
    log.push('target');
    event.preventDefault();
  });
  parent.addEventListener('demo', () => log.push('bubble'));

  const accepted = child.dispatchEvent(new Event('demo', {
    bubbles: true,
    cancelable: true
  }));
  console.log(log.join(' > '));
  console.log(accepted);
})();

Résultat

capture > target > bubble
false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources