Skip to content

Commit

Permalink
Clarify header ideas a bit. Still not great. w3c/ServiceWorker#348
Browse files Browse the repository at this point in the history
  • Loading branch information
annevk committed Aug 1, 2014
1 parent a6b39f5 commit 137ff3d
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 8 deletions.
28 changes: 23 additions & 5 deletions Overview.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<p><a class="logo" href="//www.whatwg.org/"><img alt="WHATWG" height="100" src="//resources.whatwg.org/logo-fetch.svg" width="100"></a>
<h1 id="cors">Fetch</h1>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-31-july-2014">Living Standard — Last Updated 31 July 2014</h2>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-1-august-2014">Living Standard — Last Updated 1 August 2014</h2>

<dl>
<dt>This Version:
Expand All @@ -33,7 +33,7 @@ <h2 class="no-num no-toc" id="living-standard-—-last-updated-31-july-2014">Liv
<p class="copyright"><a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="license"><img alt="CC0" src="http://i.creativecommons.org/p/zero/1.0/80x15.png"></a>
To the extent possible under law, the editor has waived all copyright and
related or neighboring rights to this work. In addition, as of
31 July 2014, the editor has made this specification available
1 August 2014, the editor has made this specification available
under the
<a href="http://www.openwebfoundation.org/legal/the-owf-1-0-agreements/owfa-1-0" rel="license">Open Web Foundation Agreement Version 1.0</a>,
which is available at
Expand Down Expand Up @@ -1598,8 +1598,6 @@ <h3 id="http-network-or-cache-fetch"><span class="secno">4.3 </span>HTTP network
<!-- XXX ideally we have an easier way to convert something ASCII-safe into bytes
concept-as-bytes -->

<li><p class="XXX">Append `<code title="">Host</code>`, ...

<li><p>If <var title="">HTTPRequest</var>'s
<a href="#force-origin-header-flag">force <code>Origin</code> header flag</a> is set,
<a href="#concept-header-list-append" title="concept-header-list-append">append</a>
Expand Down Expand Up @@ -1662,6 +1660,26 @@ <h3 id="http-network-or-cache-fetch"><span class="secno">4.3 </span>HTTP network
<var title="">HTTPRequest</var>'s
<a href="#concept-request-credentials-mode" title="concept-request-credentials-mode">credentials mode</a>.

<li>
<p>Modify <var title="">HTTPRequest</var>'s
<a href="#concept-request-header-list" title="concept-request-header-list">header list</a> per HTTP.

<p class="note no-backref">It would be great if we could make this more normative
somehow. At this point <a href="#concept-header" title="concept-header">headers</a> such as
`<code title="http-accept-encoding">Accept-Encoding</code>`,
`<code title="http-connection">Connection</code>`,
`<code title="http-dnt">DNT</code>`, and
`<code title="http-host">Host</code>`,
are to be <a href="#concept-header-list-append" title="concept-header-list-append">appended</a> if necessary.

<p>`<code title="http-accept-charset">Accept-Charset</code>` must not be included.
`<code title="http-accept">Accept</code>` and
`<code title="http-accept-language">Accept-Language</code>` must not be included at this
point. <span class="note">See <a href="#http-header-layer-division">HTTP header layer division</a>.</span>

<li>
<p class="XXX"><a href="https://github.com/slightlyoff/ServiceWorker/issues/398">Handle caches</a>.

<li>
<p>Let <var title="">response</var> be the result of making an HTTP request, using
<var title="">HTTPRequest</var>, following the requirements from HTTP as appropriate, and
Expand Down Expand Up @@ -3042,7 +3060,7 @@ <h2 class="no-num" id="background-reading">Background reading</h2>

<p><em>This section and its subsections are informative only.</em>

<h3 class="no-num" id="http-header-layer-division">HTTP header layer division</h3>
<h3 class="no-num" id="http-header-layer-division"><dfn>HTTP header layer division</dfn></h3>

<p>For the purposes of fetching, the platform has an API layer (HTML's
<code title="">img</code>, CSS' <code title="">background-image</code>), service worker layer,
Expand Down
24 changes: 21 additions & 3 deletions Overview.src.html
Original file line number Diff line number Diff line change
Expand Up @@ -1554,8 +1554,6 @@ <h3>HTTP network or cache fetch</h3>
<!-- XXX ideally we have an easier way to convert something ASCII-safe into bytes
concept-as-bytes -->

<li><p class=XXX>Append `<code title>Host</code>`, ...

<li><p>If <var title>HTTPRequest</var>'s
<span>force <code>Origin</code> header flag</span> is set,
<span title=concept-header-list-append>append</span>
Expand Down Expand Up @@ -1618,6 +1616,26 @@ <h3>HTTP network or cache fetch</h3>
<var title>HTTPRequest</var>'s
<span title=concept-request-credentials-mode>credentials mode</span>.

<li>
<p>Modify <var title>HTTPRequest</var>'s
<span title=concept-request-header-list>header list</span> per HTTP.

<p class="note no-backref">It would be great if we could make this more normative
somehow. At this point <span title=concept-header>headers</span> such as
`<code title=http-accept-encoding>Accept-Encoding</code>`,
`<code title=http-connection>Connection</code>`,
`<code title=http-dnt>DNT</code>`, and
`<code title=http-host>Host</code>`,
are to be <span title=concept-header-list-append>appended</span> if necessary.

<p>`<code title=http-accept-charset>Accept-Charset</code>` must not be included.
`<code title=http-accept>Accept</code>` and
`<code title=http-accept-language>Accept-Language</code>` must not be included at this
point. <span class=note>See <span>HTTP header layer division</span>.</span>

<li>
<p class=XXX><a href=https://github.com/slightlyoff/ServiceWorker/issues/398>Handle caches</a>.

<li>
<p>Let <var title>response</var> be the result of making an HTTP request, using
<var title>HTTPRequest</var>, following the requirements from HTTP as appropriate, and
Expand Down Expand Up @@ -2998,7 +3016,7 @@ <h2 class=no-num>Background reading</h2>

<p><em>This section and its subsections are informative only.</em>

<h3 class=no-num>HTTP header layer division</h3>
<h3 class=no-num><dfn>HTTP header layer division</dfn></h3>

<p>For the purposes of fetching, the platform has an API layer (HTML's
<code title>img</code>, CSS' <code title>background-image</code>), service worker layer,
Expand Down

0 comments on commit 137ff3d

Please sign in to comment.