[html5] r991 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2007-08-08 17:51:04 -0700 (Wed, 08 Aug 2007)
New Revision: 991

Modified:
   index
   source
Log:
[o] (2) Clarify that postMessage() is synchronous.

Modified: index
===================================================================
--- index	2007-08-09 00:45:06 UTC (rev 990)
+++ index	2007-08-09 00:51:04 UTC (rev 991)
@@ -32208,6 +32208,12 @@
    that is the <a href="#active">active document</a> of the <code><a
    href="#window">Window</a></code> object on which the method was invoked.
 
+  <p>The <code title=dom-window-postMessage><a
+   href="#postmessage">postMessage()</a></code> method must only return once
+   the event dispatch has been completely processed by the target document
+   (i.e. all three of the capture, target, and bubble phases have been done,
+   and event listeners have been executed as appropriate).
+
   <p class=warning>Authors should check the <code
    title=dom-MessageEvent-domain><a href="#domain2">domain</a></code>
    attribute to ensure that messages are only accepted from domains that they

Modified: source
===================================================================
--- source	2007-08-09 00:45:06 UTC (rev 990)
+++ source	2007-08-09 00:51:04 UTC (rev 991)
@@ -29650,6 +29650,12 @@
   object that is the <span>active document</span> of the
   <code>Window</code> object on which the method was invoked.</p>
 
+  <p>The <code title="dom-window-postMessage">postMessage()</code>
+  method must only return once the event dispatch has been completely
+  processed by the target document (i.e. all three of the capture,
+  target, and bubble phases have been done, and event listeners have
+  been executed as appropriate).</p>
+
   <p class="warning">Authors should check the <code
   title="dom-MessageEvent-domain">domain</code> attribute to ensure
   that messages are only accepted from domains that they expect to