Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[e] (0) Explain one reason you might want to use EventSource.
git-svn-id: http://svn.whatwg.org/webapps@4389 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Dec 1, 2009
1 parent 4824099 commit 1efcf09
Show file tree
Hide file tree
Showing 3 changed files with 26 additions and 3 deletions.
14 changes: 12 additions & 2 deletions complete.html
Expand Up @@ -902,7 +902,7 @@ <h2 class="no-num no-toc" id=status>Status of this document</h2>
<li><a href=#parsing-an-event-stream><span class=secno>10.2.4 </span>Parsing an event stream</a></li>
<li><a href=#event-stream-interpretation><span class=secno>10.2.5 </span>Interpreting an event stream</a></li>
<li><a href=#notes><span class=secno>10.2.6 </span>Notes</a></li>
<li><a href=#connectionless-push-and-other-features><span class=secno>10.2.7 </span>Connectionless push and other features</a></li>
<li><a href=#eventsource-push><span class=secno>10.2.7 </span>Connectionless push and other features</a></li>
<li><a href=#garbage-collection-0><span class=secno>10.2.8 </span>Garbage collection</a></li>
<li><a href=#iana-considerations><span class=secno>10.2.9 </span>IANA considerations</a>
<ol>
Expand Down Expand Up @@ -64482,6 +64482,14 @@ <h4 id=server-sent-events-intro><span class=secno>10.2.1 </span>Introduction</h4

data: This is the third message.</pre>

<p>Using this API rather than emulating it using
<code>XMLHttpRequest</code> or an <code><a href=#the-iframe-element>iframe</a></code> allows the
user agent to make better use of network resources in cases where
the user agent implementor and the network operator are able to
coordinate in advance. Amongst other benefits, this can result in
significant savings in battery life on portable devices. This is
discussed further in the section below on <a href=#eventsource-push>connectionless push</a>.</p>


<h4 id=the-eventsource-interface><span class=secno>10.2.2 </span>The <code><a href=#eventsource>EventSource</a></code> interface</h4>

Expand Down Expand Up @@ -65066,7 +65074,7 @@ <h4 id=notes><span class=secno>10.2.6 </span>Notes</h4>
<code><a href=#eventsource>EventSource</a></code> object using a <a href=#sharedworkerglobalscope title=SharedWorkerGlobalScope>shared worker</a>. <a href=#refsWEBWORKERS>[WEBWORKERS]</a></p>


<h4 id=connectionless-push-and-other-features><span class=secno>10.2.7 </span>Connectionless push and other features</h4>
<h4 id=eventsource-push><span class=secno>10.2.7 </span>Connectionless push and other features</h4>

<p>User agents running in controlled environments, e.g. browsers on
mobile handsets tied to specific carriers, may offload the
Expand Down Expand Up @@ -86207,6 +86215,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
Brian Ryner,
Brian Smith,
Brian Wilson,
Bryan Sullivan,
Bruce D'Arcus,
Bruce Lawson,
Bruce Miller,
Expand Down Expand Up @@ -86512,6 +86521,7 @@ <h3 class="no-num">Reflecting IDL attributes</h3>
Rigo Wenning,
Rikkert Koppes,
Rimantas Liubertas,
Rob Ennals,
Robert Blaut,
Robert Collins,
Robert O'Callahan,
Expand Down
2 changes: 2 additions & 0 deletions index
Expand Up @@ -78196,6 +78196,7 @@ interface <a href=#htmldocument>HTMLDocument</a> {
Brian Ryner,
Brian Smith,
Brian Wilson,
Bryan Sullivan,
Bruce D'Arcus,
Bruce Lawson,
Bruce Miller,
Expand Down Expand Up @@ -78501,6 +78502,7 @@ interface <a href=#htmldocument>HTMLDocument</a> {
Rigo Wenning,
Rikkert Koppes,
Rimantas Liubertas,
Rob Ennals,
Robert Blaut,
Robert Collins,
Robert O'Callahan,
Expand Down
13 changes: 12 additions & 1 deletion source
Expand Up @@ -73519,6 +73519,15 @@ data: has two lines.

data: This is the third message.</pre>

<p>Using this API rather than emulating it using
<code>XMLHttpRequest</code> or an <code>iframe</code> allows the
user agent to make better use of network resources in cases where
the user agent implementor and the network operator are able to
coordinate in advance. Amongst other benefits, this can result in
significant savings in battery life on portable devices. This is
discussed further in the section below on <a
href="#eventsource-push">connectionless push</a>.</p>

<!--END complete-->
<!--BOILERPLATE middle-w3c-api-intro-->
<!--START complete-->
Expand Down Expand Up @@ -74183,7 +74192,7 @@ data:&nbsp;test</pre>
href="#refsWEBWORKERS">[WEBWORKERS]</a></p>


<h4>Connectionless push and other features</h4>
<h4 id="eventsource-push">Connectionless push and other features</h4>

<p>User agents running in controlled environments, e.g. browsers on
mobile handsets tied to specific carriers, may offload the
Expand Down Expand Up @@ -96435,6 +96444,7 @@ interface <span>HTMLDocument</span> {
Brian Ryner,
Brian Smith,
Brian Wilson,
Bryan Sullivan,
Bruce D'Arcus,
Bruce Lawson,
Bruce Miller,
Expand Down Expand Up @@ -96740,6 +96750,7 @@ interface <span>HTMLDocument</span> {
Rigo Wenning,
Rikkert Koppes,
Rimantas Liubertas,
Rob Ennals,
Robert Blaut,
Robert Collins,
Robert O'Callahan,
Expand Down

0 comments on commit 1efcf09

Please sign in to comment.