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

CKTIS / JavaScript

Event.stopPropagation() — arrêter la propagation d’un événement

stopPropagation() arrête la propagation de l’événement, sans annuler l’action par défaut ni empêcher l’exécution des autres écouteurs lors de l’invocation en cours.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.stopPropagation()

event.stopPropagation() est une méthode de la DOM Web API, et non une fonction ECMAScript. Elle renvoie undefined. Elle arrête la propagation ultérieure pendant la capture comme pendant le bouillonnement ; elle n’annule pas les écouteurs déjà exécutés. Appelée sur un ancêtre pendant la capture, elle peut empêcher l’événement d’atteindre sa cible.

Elle n’interrompt ni le callback en cours ni les autres écouteurs de l’invocation en cours sur le même objet. stopImmediatePropagation() arrête également ces autres écouteurs. preventDefault() a un autre rôle : cette méthode annule l’action par défaut lorsque l’événement et les conditions de l’invocation le permettent.

Dans l’exemple, la capture sur parent a lieu en premier. Le premier écouteur de child bloque le bouillonnement vers parent, mais le second s’exécute quand même. defaultPrevented reste false. Exécutez le code dans un navigateur ; la présence de Node 24 ne prouve pas la prise en charge du DOM du navigateur.

Exemples

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

parent.addEventListener('demo', () => log.push('parent capture'), true);
parent.addEventListener('demo', () => log.push('parent bubble'));
child.addEventListener('demo', (event) => {
  log.push('child first');
  event.stopPropagation();
});
child.addEventListener('demo', () => log.push('child second'));

const event = new Event('demo', { bubbles: true, cancelable: true });
child.dispatchEvent(event);
log.push(`defaultPrevented: ${event.defaultPrevented}`);
console.log(log.join('\n'));

Résultat

parent capture
child first
child second
defaultPrevented: 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