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.