Envoie un Event (évènement) à la EventTarget (cible) spécifiée (synchrone) en appelant les EventListener (écouteurs)  dans l'ordre approprié. Le processus normal de traitement de l'évènement (y compris les phases de capture et l'éventuelle propagation) s'applique aussi aux évènements diffusés manuellement avec dispatchEvent().

Syntaxe

cancelled = !target.dispatchEvent(event)

Paramètres

  • event est un objet Event à envoyer.
  • target (cible) est utilisée pour initialiser la Event.target et déterminer quels écouteurs d'évènements doivent être invoqués.

Valeur retournée

  • La valeur de retour est  false (faux) si l'évènement est annulable et au moins l'un des gestionnaires d'événements qui ont géré cet événement appelé Event.preventDefault (). Sinon, elle est true (vrai).

La méthode dispatchEvent lance une exception UNSPECIFIED_EVENT_TYPE_ERR si le type de l'évènement n'a pas été spécifié par son initialisation avant l'appel de la méthode ou s'il est null ou une chaîne vide. Les exceptions lancées par les gestionnaires d'évènements sont signalées comme exceptions non interceptées ; les gestionnaires d'événements s'exécutent sur une pile d'appels imbriquée : ils bloquent l'appelant jusqu'à ce qu'ils se terminent, mais les exceptions ne se propagent pas à l'appelant.

Notes

Contrairement aux événements "natifs", qui sont déclenchés par le DOM et invoquent les gestionnaires d'événements de manière asynchrone via la boucle des événements, dispatchEvent appelle les gestionnaires d'événements de manière synchrone. Tous les gestionnaires d'événements applicables s'exécuteront et retourneront avant que le code ne continue après l'appel à dispatchEvent.

Comme montré dans l'exemple qui précède, dispatchEvent est la dernière étape du processus création-initialisation-envoi, qui est utilisé pour envoyer des évènements dans le modèle de l'implémentation des évènements. Ceux-ci peuvent être créés en utilisant le constructeur d'évènements.

Voir aussi Objet Event référence.

Exemple

Voir Création et déclenchement d'évènements.

Spécification

Spécification Statut Commentaire
DOM
La définition de 'EventTarget.dispatchEvent()' dans cette spécification.
Standard évolutif Définition initiale dans la spécification DOM 2 Events (évènements)

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
Support simpleChrome Support complet 4Edge Support complet 12Firefox Support complet 2IE Support complet 9
Support complet 9
Aucun support 6 — 11
Notes Autre nom
Notes Older versions of IE supported an equivalent, proprietary EventTarget.fireEvent() method.
Autre nom Cette fonctionnalité utilise le nom non-standard : fireEvent
Opera Support complet 9Safari Support complet 3.2WebView Android Support complet 4Chrome Android Support complet 18Edge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : loella16, Yvain, fscholz, khalid32, teoli, Yukulele, Mgjbot, BenoitL, Fredchat
Dernière mise à jour par : loella16,