Skip to content

Commit

Permalink
drop Beacon-Age header
Browse files Browse the repository at this point in the history
Current implementations do not defer or coalesce beacon requests, and
the definition of Beacon-Age allows it to be omitted when age is 0. As
such, this is backwards compatible change.

The right place to enable this is probably in Fetch API:
whatwg/fetch#184

Assuming above is resolved, Beacon API would simply set a flag to
indicate to fetch that the request is delay tolerant. Fetch would handle
the coalescing logic and append the ~Request-Age header. This would
allow different request types to be batched together (e.g. background
sync, beacons, and so on).
  • Loading branch information
igrigorik committed Jan 12, 2016
1 parent daf6bd0 commit 997344e
Showing 1 changed file with 0 additions and 39 deletions.
39 changes: 0 additions & 39 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -413,9 +413,6 @@ <h2>Processing Model</h2>
"#dom-navigator-sendbeacon"><code>sendBeacon</code></a> method, the
following steps must be run:</p>
<ol>
<li>
<p>Set <var>requestTime</var> to current time.</p>
</li>
<li>
<p>Set <var>base</var> to the <a>entry settings object</a>'s <a>API
base URL</a>.</p>
Expand Down Expand Up @@ -504,24 +501,10 @@ <h2>Processing Model</h2>
<dd><i>include</i></dd>
</dl>
</li>
<li>
<p>Set <var>age</var> to current time minus <var>requestTime</var>
expressed in seconds. If <var>age</var> is non-zero, append a
<dfn><code>Beacon-Age</code></dfn> header with value <var>age</var>
to <a>header list</a> field of <var>req</var>.</p>
</li>
<li>
<a>Fetch</a> <var>req</var>.
</li>
</ol>
<p>The <dfn>Beacon-Age header field</dfn> is used to communicate the time
delay, measured in seconds, between the time when the request is sent and
the <i>requestTime</i> set when <a>sendBeacon</a> method is called. The
ABNF (Augmented Backus-Naur Form) syntax for the <a>Beacon-Age header
field</a> is as follows:</p>
<pre>
Beacon-Age = "Beacon-Age" ":" 1*DIGIT
</pre>
</section>
<section id="privacy" class='informative'>
<h2>Privacy and Security</h2>
Expand All @@ -538,28 +521,6 @@ <h2>Privacy and Security</h2>
<li>The user agent should not store or defer delivery of beacon data indefinitely, as that may expose additional data when delivered - e.g. user's location via new IP address of the device.</li>
</ul>
</section>
<section>
<h2>IANA Considerations</h2>
<p>The permanent message header field registry should be updated with the
following registrations ([[RFC3864]]):</p>
<section>
<h2>Beacon-Age</h2>
<dl>
<dt>Header field name</dt>
<dd>Beacon-Age</dd>
<dt>Applicable protocol</dt>
<dd>http</dd>
<dt>Status</dt>
<dd>standard</dd>
<dt>Author/Change controller</dt>
<dd>W3C</dd>
<dt>Specification document</dt>
<dd>
This specification (see <a>Beacon-Age Header Field</a>)
</dd>
</dl>
</section>
</section>
<section class="appendix">
<h2>Acknowledgments</h2>
<p>Sincere thanks to Jonas Sicking, Nick Doty, James Simonsen, William Chan, Jason Weber, Philippe Le Hegaret, Daniel Austin, Chase Douglas, and Anne van Kesteren for their helpful comments and contributions to this work.</p>
Expand Down

0 comments on commit 997344e

Please sign in to comment.