Event

L'interface Event représente tout événement qui a lieu dans le DOM ; certains sont générés par l'utilisateur (tels que des événements de souris ou de clavier), tandis que d'autres sont générés par des API (par exemple, des événements indiquant qu'une animation est terminée, qu'une vidéo a été suspendue, etc.). Il existe plusieurs types d'événements, dont certains utilisent d'autres interfaces basées sur l'interface principale Event. Event elle-même contient les propriétés et méthodes communes à tous les événements.

Interfaces basées sur Event

 Voici une liste d'interfaces basées sur l'interface principale Event , avec des liens vers leur documentation respective dans la référence de l'API MDN. Notez que toutes les interfaces d'événements ont des noms qui se terminent par "Event".

Constructeur

L'interface DOM <code>event</code> est exposée dans les objets <code>event</code> qui sont passés aux gestionnaires d'évènements sur divers éléments du DOM.

Event()
Crée un objet Event le retournant à l'appelant.

Propriétés

Event.bubbles Lecture seule
un booléen indiquant si l'évènement se propage vers le haut dans le DOM ou non.
Event.cancelBubble
un alias historique de Event.stopPropagation (). Définir sa valeur sur true, avant qu'elle revienne d'un gestionnaire d'événements, empêche la propagation de l'événement.
Event.cancelable Lecture seule
Un booléen indiquant si l'évènement est annulable.
Event.composed Lecture seule
Un booléen indiquant si l'événement peut ou non traverser la frontière entre le DOM shadow et le DOM normal.
Event.currentTarget Lecture seule
Une référence à la cible actuellement enregistrée pour l'événement. C'est l'objet auquel l'événement doit actuellement être envoyé ; il est possible que cela ait été modifié au cours du reciblage.
Event.deepPath 
Un Array (tableau) de Node  DOM à travers lesquels l'event a été propagé.
Event.defaultPrevented Lecture seule
indique si event.preventDefault() a été appelé ou non dans l'événement.
Event.eventPhase Lecture seule
indique dans quelle phase de l'évènement on se trouve actuellement.
Event.explicitOriginalTarget Lecture seule
La cible explicite originale de l'évènement (spécifique à Mozilla).
Event.originalTarget Lecture seule
La cible originale de l'évènement, avant toute modification de celle-ci (spécifique à Mozilla).
Event.returnValue
une alternative non standard (de versions anciennes de MS IE) de Event.preventDefault() et Event.defaultPrevented.
Event.srcElement
Un alias non standard (d'anciennes versions de MS IE) pour Event.target.
Event.target Lecture seule
une référence à la cible vers laquelle l'évènement était originellement destiné.
Event.timeStamp Lecture seule
Le moment de création de l'évènement, en millisecondes. Par spécification, cette valeur est le temps écoulé depuis le moment, mais en réalité les définitions des navigateurs varient ; en outre, le travail est en cours pour le changer en  DOMHighResTimeStamp.
Event.type Lecture seule
Le nom de l'évènement (insensible à la casse).
Event.isTrusted Lecture seule
indique si l'évènement est initié par le navigateur ou non (après un click d'utilisateur ou par un script utilisant une méthode de création d'évènement comme event.initEvent)

Propriétés obsolètes

Event.scoped Lecture seule
un Boolean indiquant si l'événement donné peut être propagé à travers la racine shadow dans le DOM standard. Cette propriété a été renommée composed.

Méthodes

Event.createEvent() 
Crée un nouvel Event (évènement) qui doit alors être initialisé par l'appel à la méthode initEvent().
Event.composedPath()
Renvoie le chemin de l'événement (objets sur lesquels les écouteurs seront appelés). Cela n'inclut pas les noeuds dans les arbres shadow si la racine shadow a été créée avec son ShadowRoot.mode fermé.
Event.initEvent()
initialise la valeur d'un évènement créé. Si l'évènement a déjà été propagé, la méthode ne produit rien.
Event.preventDefault()
Annule l'évènement (s'il est annulable).
Event.stopImmediatePropagation()
Pour cet évènement particulier, aucun autre écouteur ne peut être appelé.  Ni ceux attachés au même élément, ni ceux attachés aux éléments qui seront traversés plus tard (en phase de capture, par exemple)
Event.stopPropagation()
Arrête la propagation ultérieure d'évènements dans le DOM.

Méthodes obsolètes

Event.preventBubble() Obsolète depuis Gecko 24
Empêche l'évènement de se propager. Obsolète, utilisez la méthode event.stopPropagation à la place.
Event.preventCapture() Obsolète depuis Gecko 24
Obsolète, utilisez la méthode event.stopPropagation à la place.
Event.getPreventDefault()
Non standard. Retourne la valeur de Event.defaultPrevented. Utilisez à la place Event.defaultPrevented .

Spécifications

Spécification Statut Commentaire DOM
La définition de 'Event' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
EventChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 6Opera Support complet 4Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0
Event() constructorChrome Support complet 15Edge Support complet ≤18Firefox Support complet 11IE Aucun support NonOpera Support complet 11.6Safari Support complet 6WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet 14Opera Android Support complet 12Safari iOS Support complet 6Samsung Internet Android Support complet 1.0
bubblesChrome Support complet OuiEdge Support complet 12Firefox Support complet OuiIE ? Opera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
cancelableChrome Support complet OuiEdge Support complet 12Firefox Support complet OuiIE ? Opera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet OuiOpera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
cancelBubbleChrome Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 58 and Opera 45, setting this property to false does nothing, as per spec discussion.
Edge Support complet 12Firefox Support complet 53
Notes
Support complet 53
Notes
Notes Prior to Firefox 53, this property was defined on the UIEvent interface. See bug 1298970 for more details.
IE Support complet OuiOpera Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 58 and Opera 45, setting this property to false does nothing, as per spec discussion.
Safari Support complet OuiWebView Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 58 and Opera 45, setting this property to false does nothing, as per spec discussion.
Chrome Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 58 and Opera 45, setting this property to false does nothing, as per spec discussion.
Firefox Android Support complet 53
Notes
Support complet 53
Notes
Notes Prior to Firefox 53, this property was defined on the UIEvent interface. See bug 1298970 for more details.
Opera Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 58 and Opera 45, setting this property to false does nothing, as per spec discussion.
Safari iOS Support complet OuiSamsung Internet Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Samsung Internet 7.0 and Opera 45, setting this property to false does nothing, as per spec discussion.
composedChrome Support complet 53Edge Support complet 79Firefox Support complet 52IE Aucun support NonOpera Support complet 40Safari Support complet OuiWebView Android Support complet 53Chrome Android Support complet 53Firefox Android Support complet 52Opera Android Support complet 41Safari iOS Support complet OuiSamsung Internet Android Support complet 6.0
composedPathChrome Support complet 53
Support complet 53
Aucun support 50 — 53
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
Edge Support complet 79Firefox Support complet 52IE Aucun support NonOpera Support complet 40
Support complet 40
Aucun support 37 — 40
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
Safari Support complet 10WebView Android Support complet 53
Support complet 53
Aucun support 50 — 53
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
Chrome Android Support complet 53
Support complet 53
Aucun support 50 — 53
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
Firefox Android Support complet 52Opera Android Support complet 41
Support complet 41
Aucun support 37 — 41
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
Safari iOS Support complet 10Samsung Internet Android Support complet 6.0
Support complet 6.0
Aucun support 5.0 — 6.0
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : deepPath
currentTargetChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 9
Support complet 9
Aucun support 6 — 9
Notes
Notes On Internet Explorer 6 through 8, the event model is different. Event listeners are attached with the non-standard EventTarget.attachEvent method. In this model, there is no equivalent to event.currentTarget and this is the global object. One solution to emulate the event.currentTarget feature is to wrap your handler in a function calling the handler using Function.prototype.call with the element as a first argument. This way, this will be the expected value.
Opera Support complet 7Safari Support complet 10WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 10Samsung Internet Android Support complet 1.0
defaultPreventedChrome Support complet 18Edge Support complet 12Firefox Support complet 6IE Support complet 9Opera Support complet 11Safari Support complet 5WebView Android Support complet OuiChrome Android Support complet 18Firefox Android Support complet 6Opera Android Support complet 11Safari iOS Support complet 5Samsung Internet Android Support complet 1.0
eventPhaseChrome Support complet 45Edge Support complet 12Firefox Support complet OuiIE Support complet 9Opera Support complet 32Safari Support complet OuiWebView Android Support complet 45Chrome Android Support complet 45Firefox Android Support complet OuiOpera Android Support complet 32Safari iOS Support complet OuiSamsung Internet Android Support complet 5.0
explicitOriginalTarget
Non-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Support complet OuiIE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Support complet OuiOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
getPreventDefault
ObsolèteNon-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support ? — 59
Notes
Aucun support ? — 59
Notes
Notes See bug 691151.
IE ? Opera Aucun support NonSafari ? WebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support ? — 59
Notes
Aucun support ? — 59
Notes
Notes See bug 691151.
Opera Android Aucun support NonSafari iOS ? Samsung Internet Android Aucun support Non
initEvent
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 17
Support complet 17
Aucun support ? — 17
Notes
Notes Before Firefox 17, a call to this method after the dispatching of the event raised an exception instead of doing nothing.
IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17
Support complet 17
Aucun support ? — 17
Notes
Notes Before Firefox 17, a call to this method after the dispatching of the event raised an exception instead of doing nothing.
Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
isTrustedChrome Support complet 46
Notes
Support complet 46
Notes
Notes Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action.
Edge Support complet 12Firefox Support complet OuiIE Aucun support Non
Notes
Aucun support Non
Notes
Notes In Internet Explorer, all events are trusted except those that are created with the createEvent() method.
Opera Support complet 33
Notes
Support complet 33
Notes
Notes Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action.
Safari Support complet 10WebView Android Support complet 46
Notes
Support complet 46
Notes
Notes Starting with version 53, untrusted events do not invoke the default action.
Chrome Android Support complet 46
Notes
Support complet 46
Notes
Notes Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action.
Firefox Android Support complet OuiOpera Android Support complet 33
Notes
Support complet 33
Notes
Notes Starting with Chrome 53 and Opera 40, untrusted events do not invoke the default action.
Safari iOS Support complet 10Samsung Internet Android Support complet 5.0
Notes
Support complet 5.0
Notes
Notes Starting with Samsung Internet 6.0 and Opera 40, untrusted events do not invoke the default action.
originalTarget
Non-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Support complet OuiIE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Support complet OuiOpera Android Aucun support NonSafari iOS Aucun support NonSamsung Internet Android Aucun support Non
preventBubble
ObsolèteNon-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support ? — 24IE ? Opera Aucun support NonSafari ? WebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support ? — 24Opera Android Aucun support NonSafari iOS ? Samsung Internet Android Aucun support Non
preventCapture
ObsolèteNon-standard
Chrome Aucun support NonEdge Aucun support NonFirefox Aucun support ? — 24IE ? Opera Aucun support NonSafari ? WebView Android Aucun support NonChrome Android Aucun support NonFirefox Android Aucun support ? — 24Opera Android Aucun support NonSafari iOS ? Samsung Internet Android Aucun support Non
preventDefaultChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 9Opera Support complet 7Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0
returnValue
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Aucun support Non
Notes
Aucun support Non
Notes
Notes Temporarily added in 63, removed in 64, briefly added in 65, then removed again while related compatibility issues are sorted out (see bug 1520756).
IE Support complet 6Opera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes Temporarily added in 63, removed in 64, briefly added in 65, then removed again while related compatibility issues are sorted out (see bug 1520756).
Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
srcElement
Obsolète
Chrome Support complet OuiEdge Support complet 12Firefox Support complet 62IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 62Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
stopImmediatePropagationChrome Support complet 6Edge Support complet 12Firefox Support complet 10IE Support complet 9Opera Support complet 15Safari Support complet 5WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet 10Opera Android Support complet 14Safari iOS Support complet 5Samsung Internet Android Support complet 1.0
stopPropagationChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 9Opera Support complet 7Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0
targetChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 9Opera Support complet 7Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0
timeStampChrome Support complet 49
Notes
Support complet 49
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Edge Support complet 12Firefox Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
IE Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Opera Support complet 36
Notes
Support complet 36
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Safari Support complet OuiWebView Android Support complet 49
Notes
Support complet 49
Notes
Notes Starting with version 49, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Chrome Android Support complet 49
Notes
Support complet 49
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Firefox Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Opera Android Support complet 36
Notes
Support complet 36
Notes
Notes Starting with Chrome 49, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
Safari iOS Support complet OuiSamsung Internet Android Support complet 5.0
Notes
Support complet 5.0
Notes
Notes Starting with Samsung Internet 5.0, Firefox 54 and Opera 36, this property returns DOMHighResTimeStamp instead of DOMTimeStamp.
typeChrome Support complet 1Edge Support complet 12Firefox Support complet 1IE Support complet 9Opera Support complet 7Safari Support complet 1WebView Android Support complet 1Chrome Android Support complet 18Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 1Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
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.

Voir aussi