Thu, 22 Jan 2015 13:21:57 +0100
Incorporate requested changes from Mozilla in review:
https://bugzilla.mozilla.org/show_bug.cgi?id=1123480#c6
1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2 /* This Source Code Form is subject to the terms of the Mozilla Public
3 * License, v. 2.0. If a copy of the MPL was not distributed with this
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
5 *
6 * For more information on this interface, please see
7 * http://www.whatwg.org/specs/web-apps/current-work/#messageevent
8 */
10 interface WindowProxy;
12 [Constructor(DOMString type, optional MessageEventInit eventInitDict)]
13 interface MessageEvent : Event {
14 /**
15 * Custom data associated with this event.
16 */
17 [GetterThrows]
18 readonly attribute any data;
20 /**
21 * The origin of the site from which this event originated, which is the
22 * scheme, ":", and if the URI has a host, "//" followed by the
23 * host, and if the port is not the default for the given scheme,
24 * ":" followed by that port. This value does not have a trailing slash.
25 */
26 readonly attribute DOMString origin;
28 /**
29 * The last event ID string of the event source, for server-sent DOM events; this
30 * value is the empty string for cross-origin messaging.
31 */
32 readonly attribute DOMString lastEventId;
34 /**
35 * The window or the port which originated this event.
36 */
37 readonly attribute (WindowProxy or MessagePort)? source;
39 /**
40 * Initializes this event with the given data, in a manner analogous to
41 * the similarly-named method on the nsIDOMEvent interface, also setting the
42 * data, origin, source, and lastEventId attributes of this appropriately.
43 */
44 readonly attribute MessagePortList? ports;
45 };
47 dictionary MessageEventInit : EventInit {
48 any data;
49 DOMString origin;
50 DOMString lastEventId;
51 (WindowProxy or MessagePort)? source = null;
52 sequence<MessagePort>? ports;
53 };