The WindowEventHandlers mixin describes the event handlers common to several interfaces like Window, or HTMLBodyElement and HTMLFrameSetElement. Each of these interfaces can implement additional specific event handlers.
Note: WindowEventHandlers is a mixin and not an interface; you can't actually create an object of type WindowEventHandlers.
Properties
The events properties, of the form onXYZ, are defined on the WindowEventHandlers, and implemented by Window, and WorkerGlobalScope for Web Workers.
WindowEventHandlers.onafterprint- Is an
EventHandlerrepresenting the code to be called when theafterprintevent is raised. WindowEventHandlers.onbeforeprint- Is an
EventHandlerrepresenting the code to be called when thebeforeprintevent is raised. WindowEventHandlers.onbeforeunload- Is an
EventHandlerrepresenting the code to be called when thebeforeunloadevent is raised. WindowEventHandlers.onhashchange- Is an
EventHandlerrepresenting the code to be called when thehashchangeevent is raised. WindowEventHandlers.onlanguagechange- Is an
EventHandlerrepresenting the code to be called when thelanguagechangeevent is raised. WindowEventHandlers.onmessage- Is an
EventHandlerrepresenting the code to be called when themessageevent is raised. WindowEventHandlers.onmessageerror- Is an
EventHandlerrepresenting the code to be called when theMessageErrorevent is raised. WindowEventHandlers.onoffline- Is an
EventHandlerrepresenting the code to be called when theofflineevent is raised. WindowEventHandlers.ononline- Is an
EventHandlerrepresenting the code to be called when theonlineevent is raised. WindowEventHandlers.onpagehide- Is an
EventHandlerrepresenting the code to be called when thepagehideevent is raised. WindowEventHandlers.onpageshow- Is an
EventHandlerrepresenting the code to be called when thepageshowevent is raised. WindowEventHandlers.onpopstate- Is an
EventHandlerrepresenting the code to be called when thepopstateevent is raised. WindowEventHandlers.onstorage- Is an
EventHandlerrepresenting the code to be called when thestorageevent is raised. WindowEventHandlers.onunhandledrejection- An event handler for unhandled
Promiserejection events. WindowEventHandlers.onunload- Is an
EventHandlerrepresenting the code to be called when theunloadevent is raised.
Methods
This interface defines no method.
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of 'GlobalEventHandlers' in that specification. |
Living Standard | No change since the latest snapshot, HTML 5.1. |
| HTML 5.1 The definition of 'GlobalEventHandlers' in that specification. |
Recommendation | Snapshot of HTML Living Standard. Added onlanguage since the HTML5 snapshot. |
| HTML5 The definition of 'GlobalEventHandlers' in that specification. |
Recommendation | Snapshot of HTML Living Standard. Creation of WindowEventHandlers (properties where on the target before it). |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | Yes | ? | Yes | ? | Yes | ? |
onafterprint | 63 | Yes | 6 | Yes | 50 | No |
onbeforeprint | 63 | Yes | 6 | Yes | 50 | No |
onbeforeunload | 1 | Yes | 1 | 4 | 12 | 3 |
onhashchange | 5 | Yes | 3.6 | 8 | 10 | 5 |
onlanguagechange | 37 | ? | 32 | No | 24 | ? |
onmessage | 60 | ? | ? | ? | 47 | ? |
onmessageerror | 60 | ? | 57 | ? | 47 | ? |
onpopstate | 5 | 12 | 4 | 10 | 11.5 | 6 |
onrejectionhandled | 49 | ? | No2 | No | No | No |
onstorage | ? | Yes | 45 | ? | ? | ? |
onunhandledrejection | 49 | Yes | No2 | No | No | No |
onunload | Yes | Yes | Yes | Yes | Yes | Yes |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | Yes | Yes | ? | Yes | Yes | ? | ? |
onafterprint | 63 | 63 | Yes | ? | 50 | ? | ? |
onbeforeprint | 63 | 63 | Yes | ? | 50 | ? | ? |
onbeforeunload | Yes | Yes | Yes | ? | Yes | No1 | ? |
onhashchange | Yes | Yes | Yes | 4 | 11 | 5 | ? |
onlanguagechange | 37 | 37 | ? | 4 | 24 | ? | ? |
onmessage | 60 | 60 | ? | ? | 47 | ? | ? |
onmessageerror | 60 | 60 | ? | 57 | 47 | ? | ? |
onpopstate | ? | 18 | ? | 4 | 12 | 5.1 | ? |
onrejectionhandled | No | No | ? | No2 | No | No | ? |
onstorage | No | No | Yes | 45 | ? | ? | ? |
onunhandledrejection | No | No | Yes | No2 | No | No | ? |
onunload | Yes | Yes | Yes | Yes | Yes | Yes | ? |
1. Implementation seems defect.
2. Firefox implements the PromiseRejectionEvent interface if you go to about:config and set the dom.promise_rejection_events.enabled pref to true. However, Firefox doesn't yet actually send the unhandledrejection or understand rejectionhandled events. Completing the implementation will be addressed in bug 1362272.