websocket; hixie: Expose selected extensions on WebSocket connections; allow UAs to use compression. (whatwg r6190)

websocket; hixie: Expose selected extensions on WebSocket connections;
allow UAs to use compression. (whatwg r6190)

http://dev.w3.org/cvsweb/html5/websockets/Overview.html?r1=1.220&r2=1.221&f=h
http://html5.org/tools/web-apps-tracker?from=6189&to=6190

===================================================================
RCS file: /sources/public/html5/websockets/Overview.html,v
retrieving revision 1.220
retrieving revision 1.221
diff -u -d -r1.220 -r1.221
--- Overview.html 6 Jun 2011 22:20:42 -0000 1.220
+++ Overview.html 6 Jun 2011 22:28:53 -0000 1.221
@@ -421,6 +421,7 @@
   // networking
            attribute <span>Function</span> <a href="#handler-websocket-onopen" title="handler-WebSocket-onopen">onopen</a>;
            attribute <span>Function</span> <a href="#handler-websocket-onclose" title="handler-WebSocket-onclose">onclose</a>;
+  readonly attribute DOMString <a href="#dom-websocket-extensions" title="dom-WebSocket-extensions">extensions</a>;
   readonly attribute DOMString <a href="#dom-websocket-protocol" title="dom-WebSocket-protocol">protocol</a>;
   void <a href="#dom-websocket-close" title="dom-WebSocket-close">close</a>(in optional unsigned long code, in optional DOMString reason);
 
@@ -490,12 +491,13 @@
    <li>
 
     <p><i>Establish a WebSocket connection</i> given the set (<var title="">host</var>, <var title="">port</var>, <var title="">resource name</var>, <var title="">secure</var>), along
-    with the <var title="">protocols</var> list, an empty list for the
-    extensions, and <var title="">origin</var>. The <i>headers to send
-    appropriate cookies</i> must be a <code title="http-Cookie">Cookie</code> header whose value is the
-    <i>cookie-string</i> computed from the user's cookie store and the
-    URL <var title="">url</var>; for these purposes this is
-    <em>not</em> a "non-HTTP" API. <a href="#refsWSP">[WSP]</a> <a href="#refsCOOKIES">[COOKIES]</a></p>
+    with the <var title="">protocols</var> list, a list containing
+    just "<code title="">deflate-stream</code>" for the extensions,
+    and <var title="">origin</var>. The <i>headers to send appropriate
+    cookies</i> must be a <code title="http-Cookie">Cookie</code>
+    header whose value is the <i>cookie-string</i> computed from the
+    user's cookie store and the URL <var title="">url</var>; for these
+    purposes this is <em>not</em> a "non-HTTP" API. <a href="#refsWSP">[WSP]</a> <a href="#refsCOOKIES">[COOKIES]</a></p>
 
     <p>When the user agent <i title="validate the server's
     response">validates the server's response</i> during the
@@ -545,7 +547,11 @@
    <dd>The connection has been closed or could not be opened.</dd>
 
   </dl><p>When the object is created its <code title="dom-WebSocket-readyState"><a href="#dom-websocket-readystate">readyState</a></code> must be set to
-  <code title="dom-WebSocket-CONNECTING"><a href="#dom-websocket-connecting">CONNECTING</a></code> (0).<p>The <dfn id="dom-websocket-protocol" title="dom-WebSocket-protocol"><code>protocol</code></dfn> attribute
+  <code title="dom-WebSocket-CONNECTING"><a href="#dom-websocket-connecting">CONNECTING</a></code> (0).<p>The <dfn id="dom-websocket-extensions" title="dom-WebSocket-extensions"><code>extensions</code></dfn>
+  attribute must initially return the empty string. After <i>the
+  WebSocket connection is established</i>, its value might change, as
+  defined below.<p class="note">The <code title="dom-WebSocket-extensions"><a href="#dom-websocket-extensions">extensions</a></code> attribute returns
+  the extensions selected by the server, if any.<p>The <dfn id="dom-websocket-protocol" title="dom-WebSocket-protocol"><code>protocol</code></dfn> attribute
   must initially return the empty string. After <i>the WebSocket
   connection is established</i>, its value might change, as defined
   below.<p class="note">The <code title="dom-WebSocket-protocol"><a href="#dom-websocket-protocol">protocol</a></code> attribute returns the
@@ -759,6 +765,9 @@
   agent must <span>queue a task</span> to run these steps:<ol><li><p>Change the <code title="dom-WebSocket-readyState"><a href="#dom-websocket-readystate">readyState</a></code> attribute's
    value to <code title="dom-WebSocket-OPEN"><a href="#dom-websocket-open">OPEN</a></code> (1).</li>
 
+   <li><p>Change the <code title="dom-WebSocket-extensions"><a href="#dom-websocket-extensions">extensions</a></code> attribute's
+   value to the <i>extensions in use</i>, if is not the null value. <a href="#refsWSP">[WSP]</a></li>
+
    <li><p>Change the <code title="dom-WebSocket-protocol"><a href="#dom-websocket-protocol">protocol</a></code> attribute's value to
    the <i>subprotocol in use</i>, if is not the null value. <a href="#refsWSP">[WSP]</a></li>

Received on Friday, 17 June 2011 09:54:41 UTC