- From: poot <cvsmail@w3.org>
- Date: Fri, 09 Sep 2011 21:26:20 -0400
- To: public-html-diffs@w3.org
postmsg; hixie: Update Event interfaces to use constructors instead of init*Event methods; remove some typedefs. (whatwg r6551) http://dev.w3.org/cvsweb/html5/postmsg/Overview.html?r1=1.95&r2=1.96&f=h http://html5.org/tools/web-apps-tracker?from=6550&to=6551 =================================================================== RCS file: /sources/public/html5/postmsg/Overview.html,v retrieving revision 1.95 retrieving revision 1.96 diff -u -d -r1.95 -r1.96 --- Overview.html 17 Aug 2011 23:33:21 -0000 1.95 +++ Overview.html 10 Sep 2011 01:26:10 -0000 1.96 @@ -214,7 +214,7 @@ <h1>HTML5 Web Messaging</h1> - <h2 class="no-num no-toc" id="editor-s-draft-17-august-2011">Editor's Draft 17 August 2011</h2> + <h2 class="no-num no-toc" id="editor-s-draft-10-september-2011">Editor's Draft 10 September 2011</h2> <dl><dt>Latest Published Version:</dt> <dd><a href="http://www.w3.org/TR/webmessaging/">http://www.w3.org/TR/webmessaging/</a></dd> <dt>Latest Editor's Draft:</dt> @@ -316,7 +316,7 @@ </dl><p>The W3C <a href="http://www.w3.org/2008/webapps/">Web Applications Working Group</a> is the W3C working group responsible for this specification's progress along the W3C Recommendation track. - This specification is the 17 August 2011 Editor's Draft. + This specification is the 10 September 2011 Editor's Draft. </p><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/42538/status" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables @@ -410,13 +410,21 @@ <a href="#refsEVENTSOURCE">[EVENTSOURCE]</a> <a href="#refsWEBSOCKET">[WEBSOCKET]</a> - <p>The following interface is defined for this event:<pre class="idl">interface <dfn id="messageevent">MessageEvent</dfn> : <span>Event</span> { + <p>The following interface is defined for this event:<pre class="idl">[Constructor(DOMString type, optional <a href="#messageeventinit">MessageEventInit</a> eventInitDict)] +interface <dfn id="messageevent">MessageEvent</dfn> : <span>Event</span> { readonly attribute any <a href="#dom-messageevent-data" title="dom-MessageEvent-data">data</a>; readonly attribute DOMString <a href="#dom-messageevent-origin" title="dom-MessageEvent-origin">origin</a>; readonly attribute DOMString <a href="#dom-messageevent-lasteventid" title="dom-MessageEvent-lastEventId">lastEventId</a>; readonly attribute <span>WindowProxy</span>? <a href="#dom-messageevent-source" title="dom-MessageEvent-source">source</a>; - readonly attribute <a href="#messageport">MessagePort</a>[] <a href="#dom-messageevent-ports" title="dom-MessageEvent-ports">ports</a>; - void <a href="#dom-messageevent-initmessageevent" title="dom-MessageEvent-initMessageEvent">initMessageEvent</a>(DOMString typeArg, boolean canBubbleArg, boolean cancelableArg, any dataArg, DOMString originArg, DOMString lastEventIdArg, <span>WindowProxy</span>? sourceArg, sequence<<a href="#messageport">MessagePort</a>> portsArg); + readonly attribute <a href="#messageport">MessagePort</a>[]? <a href="#dom-messageevent-ports" title="dom-MessageEvent-ports">ports</a>; +}; + +dictionary <dfn id="messageeventinit">MessageEventInit</dfn> : <span>EventInit</span> { + any data; + DOMString origin; + DOMString lastEventId; + <span>WindowProxy</span>? source; + <a href="#messageport">MessagePort</a>[]? ports; };</pre><dl class="domintro"><dt><var title="">event</var> . <code title="dom-MessageEvent-data"><a href="#dom-messageevent-data">data</a></code></dt> <dd> @@ -464,14 +472,14 @@ </dl><div class="impl"> - <p>The <dfn id="dom-messageevent-initmessageevent" title="dom-MessageEvent-initMessageEvent"><code>initMessageEvent()</code></dfn> - method must initialize the event in a manner analogous to the - similarly-named method in the DOM Events interfaces. <a href="#refsDOMEVENTS">[DOMEVENTS]</a></p> - <p>The <dfn id="dom-messageevent-data" title="dom-MessageEvent-data"><code>data</code></dfn> - attribute represents the message being sent.</p> + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to null. It + represents the message being sent.</p> <p>The <dfn id="dom-messageevent-origin" title="dom-MessageEvent-origin"><code>origin</code></dfn> attribute + must return the value it was initialized to. When the object is + created, this attribute must be initialized to the empty string. It represents, in <span>server-sent events</span> and <a href="#web-messaging">cross-document messaging</a>, the <span>origin</span> of the document that sent the message (typically the scheme, hostname, @@ -479,27 +487,25 @@ identifier).</p> <p>The <dfn id="dom-messageevent-lasteventid" title="dom-MessageEvent-lastEventId"><code>lastEventId</code></dfn> - attribute represents, in <span>server-sent events</span>, the <span title="concept-event-stream-last-event-id">last event ID + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to the empty + string. It represents, in <span>server-sent events</span>, the <span title="concept-event-stream-last-event-id">last event ID string</span> of the event source.</p> <p>The <dfn id="dom-messageevent-source" title="dom-MessageEvent-source"><code>source</code></dfn> attribute - represents, in <a href="#web-messaging">cross-document messaging</a>, the + must return the value it was initialized to. When the object is + created, this attribute must be initialized to null. It represents, + in <a href="#web-messaging">cross-document messaging</a>, the <code>WindowProxy</code> of the <span>browsing context</span> of the <code>Window</code> object from which the message came.</p> <p>The <dfn id="dom-messageevent-ports" title="dom-MessageEvent-ports"><code>ports</code></dfn> - attribute represents, in <a href="#web-messaging">cross-document messaging</a> and + attribute must return the value it was initialized to. When the + object is created, this attribute must be initialized to null. + It represents, in <a href="#web-messaging">cross-document messaging</a> and <a href="#channel-messaging">channel messaging</a> the <code><a href="#messageport">MessagePort</a></code> array being sent, if any.</p> - <p>Except where otherwise specified, when the user agent creates and - dispatches a <code title="event-message"><a href="#event-message">message</a></code> event in the - algorithms described in the following sections, the <code title="dom-MessageEvent-lastEventId"><a href="#dom-messageevent-lasteventid">lastEventId</a></code> attribute - must be the empty string, the <code title="dom-MessageEvent-origin"><a href="#dom-messageevent-origin">origin</a></code> attribute must be the - empty string, the <code title="dom-MessageEvent-source"><a href="#dom-messageevent-source">source</a></code> attribute must be - null, and the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code> - attribute must be null.</p> - </div><h2 id="web-messaging"><span class="secno">4 </span><dfn id="crossDocumentMessages">Cross-document messaging</dfn></h2><p>Web browsers, for security and privacy reasons, prevent documents in different domains from affecting each other; that is, cross-site scripting is disallowed.<p>While this is an important security feature, it prevents pages @@ -713,14 +719,15 @@ <p>Create an event that uses the <code><a href="#messageevent">MessageEvent</a></code> interface, with the event name <code title="event-message"><a href="#event-message">message</a></code>, which does not bubble, is - not cancelable, and has no default action. The <code title="dom-MessageEvent-data"><a href="#dom-messageevent-data">data</a></code> attribute must be set to - the value of <var title="">message clone</var>, the <code title="dom-MessageEvent-origin"><a href="#dom-messageevent-origin">origin</a></code> attribute must be - set to the <span title="Unicode serialization of an + not cancelable, and has no default action. The <code title="dom-MessageEvent-data"><a href="#dom-messageevent-data">data</a></code> attribute must be + initialized to the value of <var title="">message clone</var>, the + <code title="dom-MessageEvent-origin"><a href="#dom-messageevent-origin">origin</a></code> attribute must + be initialized to the <span title="Unicode serialization of an origin">Unicode serialization</span> of the <span>origin</span> of the script that invoked the method, the <code title="dom-MessageEvent-source"><a href="#dom-messageevent-source">source</a></code> attribute must be - set to the <span>script's global object</span>'s - <code>WindowProxy</code> object, and the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code> attribute must be set - to the <var title="">new ports</var> array.</p> + initialized to the <span>script's global object</span>'s + <code>WindowProxy</code> object, and the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code> attribute must be + initialized to the <var title="">new ports</var> array.</p> </li> <li> @@ -1000,20 +1007,19 @@ </li> + <li><p>If there is no <var title="">target port</var> (i.e. if <var title="">source port</var> is not entangled), then abort these + steps.</li> <li><p>Create an event that uses the <code><a href="#messageevent">MessageEvent</a></code> interface, with the name <code title="event-message"><a href="#event-message">message</a></code>, which does not bubble, is not cancelable, and has no default action.</li> <li><p>Let the <code title="dom-MessageEvent-data"><a href="#dom-messageevent-data">data</a></code> - attribute of the event have the value of <var title="">message - clone</var>.</li> + attribute of the event be initialized to the value of <var title="">message clone</var>.</li> <li><p>Let the <code title="dom-MessageEvent-ports"><a href="#dom-messageevent-ports">ports</a></code> - attribute of the event be the <var title="">new ports</var> - array.</li> + attribute of the event be initialized to the <var title="">new + ports</var> array.</li> - <li><p>If there is no <var title="">target port</var> (i.e. if <var title="">source port</var> is not entangled), then abort these - steps.</li> <li><p>Add the event to the <a href="#port-message-queue">port message queue</a> of <var title="">target port</var>.</li> </ol><hr><p>The <dfn id="dom-messageport-start" title="dom-MessagePort-start"><code>start()</code></dfn> @@ -1084,11 +1090,6 @@ memory usage.<h2 class="no-num" id="references">References</h2><p>All references are normative unless marked "Non-normative".</p><dl><dt id="refsDOMCORE">[DOMCORE]</dt> <dd><cite><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html">Web DOM Core</a></cite>, A. van Kesteren. W3C.</dd> - <dt id="refsDOMEVENTS">[DOMEVENTS]</dt> - <dd><cite><a href="http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html">Document - Object Model (DOM) Level 3 Events Specification</a></cite>, - D. Schepers. W3C.</dd> - <dt id="refsEVENTSOURCE">[EVENTSOURCE]</dt> <dd><cite><a href="http://dev.w3.org/html5/eventsource/">Server-Sent Events</a></cite>, I. Hickson. W3C.</dd>
Received on Saturday, 10 September 2011 01:26:23 UTC