[html5] r6752 - [giow] (0) Add commentary on PING and PONG frames. Fixing http://www.w3.org/Bugs [...]

whatwg at whatwg.org whatwg at whatwg.org
Mon Oct 24 21:35:04 PDT 2011


Author: ianh
Date: 2011-10-24 21:35:03 -0700 (Mon, 24 Oct 2011)
New Revision: 6752

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Add commentary on PING and PONG frames.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=13104

Modified: complete.html
===================================================================
--- complete.html	2011-10-25 04:22:06 UTC (rev 6751)
+++ complete.html	2011-10-25 04:35:03 UTC (rev 6752)
@@ -1065,11 +1065,11 @@
     <ol>
      <li><a href=#network-intro><span class=secno>11.3.1 </span>Introduction</a></li>
      <li><a href=#the-websocket-interface><span class=secno>11.3.2 </span>The <code>WebSocket</code> interface</a></li>
-     <li><a href=#feedback-from-the-protocol><span class=secno>11.3.3 </span>Feedback from the protocol</a>
-      <ol>
-       <li><a href=#parsing-websocket-urls><span class=secno>11.3.3.1 </span>Parsing WebSocket URLs</a></li>
-       <li><a href=#event-definitions-3><span class=secno>11.3.3.2 </span>Event definitions</a></li>
-       <li><a href=#garbage-collection-2><span class=secno>11.3.3.3 </span>Garbage collection</a></ol></ol></li>
+     <li><a href=#feedback-from-the-protocol><span class=secno>11.3.3 </span>Feedback from the protocol</a></li>
+     <li><a href=#ping-and-pong-frames><span class=secno>11.3.4 </span>Ping and Pong frames</a></li>
+     <li><a href=#parsing-websocket-urls><span class=secno>11.3.5 </span>Parsing WebSocket URLs</a></li>
+     <li><a href=#event-definitions-3><span class=secno>11.3.6 </span>Event definitions</a></li>
+     <li><a href=#garbage-collection-2><span class=secno>11.3.7 </span>Garbage collection</a></ol></li>
    <li><a href=#web-messaging><span class=secno>11.4 </span>Cross-document messaging</a>
     <ol>
      <li><a href=#introduction-14><span class=secno>11.4.1 </span>Introduction</a></li>
@@ -81312,8 +81312,23 @@
   source</dfn>.</p>
 
 
-  <h5 id=parsing-websocket-urls><span class=secno>11.3.3.1 </span>Parsing WebSocket URLs</h5>
+  <h4 id=ping-and-pong-frames><span class=secno>11.3.4 </span>Ping and Pong frames</h4>
 
+  <p>The WebSocket protocol specification defines Ping and Pong frames
+  that can be used for keep-alive, heart-beats, network status
+  probing, latency instrumentation, and so forth. These are not
+  currently exposed in the API.</p>
+
+  <p>User agents may send ping and unsolicited pong frames as desired,
+  for example in an attempt to maintain local network NAT mappings, to
+  detect failed connections, or to display latency metrics to the
+  user. User agents must not use pings or unsolicited pongs to aid the
+  server; it is assumed that servers will send solicit pongs whenever
+  appropriate for the server's needs.</p>
+
+
+  <h4 id=parsing-websocket-urls><span class=secno>11.3.5 </span>Parsing WebSocket URLs</h4>
+
   <p>The steps to <dfn id="parse-a-websocket-url's-components">parse a WebSocket URL's components</dfn> from
   a string <var title="">url</var> are as follows. These steps return
   either a <var title="">host</var>, a <var title="">port</var>, a
@@ -81374,7 +81389,7 @@
    <li><p>Return <var title="">host</var>, <var title="">port</var>,
    <var title="">resource name</var>, and <var title="">secure</var>.</li>
 
-  </ol><h5 id=event-definitions-3><span class=secno>11.3.3.2 </span>Event definitions</h5>
+  </ol><h4 id=event-definitions-3><span class=secno>11.3.6 </span>Event definitions</h4>
 
   <pre class=idl>[Constructor(DOMString type, optional <a href=#closeeventinit>CloseEventInit</a> eventInitDict)]
 interface <dfn id=closeevent>CloseEvent</dfn> : <a href=#event>Event</a> {
@@ -81408,7 +81423,7 @@
 
 
 
-  <h5 id=garbage-collection-2><span class=secno>11.3.3.3 </span>Garbage collection</h5>
+  <h4 id=garbage-collection-2><span class=secno>11.3.7 </span>Garbage collection</h4>
 
   <p>A <code><a href=#websocket>WebSocket</a></code> object whose <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> attribute's value
   was set to <code title=dom-WebSocket-CONNECTING><a href=#dom-websocket-connecting>CONNECTING</a></code>

Modified: index
===================================================================
--- index	2011-10-25 04:22:06 UTC (rev 6751)
+++ index	2011-10-25 04:35:03 UTC (rev 6752)
@@ -1065,11 +1065,11 @@
     <ol>
      <li><a href=#network-intro><span class=secno>11.3.1 </span>Introduction</a></li>
      <li><a href=#the-websocket-interface><span class=secno>11.3.2 </span>The <code>WebSocket</code> interface</a></li>
-     <li><a href=#feedback-from-the-protocol><span class=secno>11.3.3 </span>Feedback from the protocol</a>
-      <ol>
-       <li><a href=#parsing-websocket-urls><span class=secno>11.3.3.1 </span>Parsing WebSocket URLs</a></li>
-       <li><a href=#event-definitions-3><span class=secno>11.3.3.2 </span>Event definitions</a></li>
-       <li><a href=#garbage-collection-2><span class=secno>11.3.3.3 </span>Garbage collection</a></ol></ol></li>
+     <li><a href=#feedback-from-the-protocol><span class=secno>11.3.3 </span>Feedback from the protocol</a></li>
+     <li><a href=#ping-and-pong-frames><span class=secno>11.3.4 </span>Ping and Pong frames</a></li>
+     <li><a href=#parsing-websocket-urls><span class=secno>11.3.5 </span>Parsing WebSocket URLs</a></li>
+     <li><a href=#event-definitions-3><span class=secno>11.3.6 </span>Event definitions</a></li>
+     <li><a href=#garbage-collection-2><span class=secno>11.3.7 </span>Garbage collection</a></ol></li>
    <li><a href=#web-messaging><span class=secno>11.4 </span>Cross-document messaging</a>
     <ol>
      <li><a href=#introduction-14><span class=secno>11.4.1 </span>Introduction</a></li>
@@ -81312,8 +81312,23 @@
   source</dfn>.</p>
 
 
-  <h5 id=parsing-websocket-urls><span class=secno>11.3.3.1 </span>Parsing WebSocket URLs</h5>
+  <h4 id=ping-and-pong-frames><span class=secno>11.3.4 </span>Ping and Pong frames</h4>
 
+  <p>The WebSocket protocol specification defines Ping and Pong frames
+  that can be used for keep-alive, heart-beats, network status
+  probing, latency instrumentation, and so forth. These are not
+  currently exposed in the API.</p>
+
+  <p>User agents may send ping and unsolicited pong frames as desired,
+  for example in an attempt to maintain local network NAT mappings, to
+  detect failed connections, or to display latency metrics to the
+  user. User agents must not use pings or unsolicited pongs to aid the
+  server; it is assumed that servers will send solicit pongs whenever
+  appropriate for the server's needs.</p>
+
+
+  <h4 id=parsing-websocket-urls><span class=secno>11.3.5 </span>Parsing WebSocket URLs</h4>
+
   <p>The steps to <dfn id="parse-a-websocket-url's-components">parse a WebSocket URL's components</dfn> from
   a string <var title="">url</var> are as follows. These steps return
   either a <var title="">host</var>, a <var title="">port</var>, a
@@ -81374,7 +81389,7 @@
    <li><p>Return <var title="">host</var>, <var title="">port</var>,
    <var title="">resource name</var>, and <var title="">secure</var>.</li>
 
-  </ol><h5 id=event-definitions-3><span class=secno>11.3.3.2 </span>Event definitions</h5>
+  </ol><h4 id=event-definitions-3><span class=secno>11.3.6 </span>Event definitions</h4>
 
   <pre class=idl>[Constructor(DOMString type, optional <a href=#closeeventinit>CloseEventInit</a> eventInitDict)]
 interface <dfn id=closeevent>CloseEvent</dfn> : <a href=#event>Event</a> {
@@ -81408,7 +81423,7 @@
 
 
 
-  <h5 id=garbage-collection-2><span class=secno>11.3.3.3 </span>Garbage collection</h5>
+  <h4 id=garbage-collection-2><span class=secno>11.3.7 </span>Garbage collection</h4>
 
   <p>A <code><a href=#websocket>WebSocket</a></code> object whose <code title=dom-WebSocket-readyState><a href=#dom-websocket-readystate>readyState</a></code> attribute's value
   was set to <code title=dom-WebSocket-CONNECTING><a href=#dom-websocket-connecting>CONNECTING</a></code>

Modified: source
===================================================================
--- source	2011-10-25 04:22:06 UTC (rev 6751)
+++ source	2011-10-25 04:35:03 UTC (rev 6752)
@@ -92108,8 +92108,23 @@
   source</dfn>.</p>
 
 
-  <h5>Parsing WebSocket URLs</h5>
+  <h4>Ping and Pong frames</h4>
 
+  <p>The WebSocket protocol specification defines Ping and Pong frames
+  that can be used for keep-alive, heart-beats, network status
+  probing, latency instrumentation, and so forth. These are not
+  currently exposed in the API.</p>
+
+  <p>User agents may send ping and unsolicited pong frames as desired,
+  for example in an attempt to maintain local network NAT mappings, to
+  detect failed connections, or to display latency metrics to the
+  user. User agents must not use pings or unsolicited pongs to aid the
+  server; it is assumed that servers will send solicit pongs whenever
+  appropriate for the server's needs.</p>
+
+
+  <h4>Parsing WebSocket URLs</h4>
+
   <p>The steps to <dfn>parse a WebSocket URL's components</dfn> from
   a string <var title="">url</var> are as follows. These steps return
   either a <var title="">host</var>, a <var title="">port</var>, a
@@ -92189,7 +92204,7 @@
   </ol>
 
 
-  <h5>Event definitions</h5>
+  <h4>Event definitions</h4>
 
   <pre class="idl">[Constructor(DOMString type, optional <span>CloseEventInit</span> eventInitDict)]
 interface <dfn>CloseEvent</dfn> : <span>Event</span> {
@@ -92224,7 +92239,7 @@
 
 
 
-  <h5>Garbage collection</h5>
+  <h4>Garbage collection</h4>
 
   <p>A <code>WebSocket</code> object whose <code
   title="dom-WebSocket-readyState">readyState</code> attribute's value




More information about the Commit-Watchers mailing list