Skip to content

Commit

Permalink
Editorial: referrer policy definitions moved to Referrer Policy
Browse files Browse the repository at this point in the history 
See w3c/webappsec-referrer-policy#62 for more
details.
  • Loading branch information
@annevk
annevk committed Aug 26, 2016
1 parent 2ef920d commit 8243753
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 74 deletions.
58 changes: 17 additions & 41 deletions Overview.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

<p><a class="logo" href="https://whatwg.org/"><img alt="WHATWG" height="100" src="https://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-25-august-2016">Living Standard — Last Updated 25 August 2016</h2>
<h2 class="no-num no-toc" id="living-standard-—-last-updated-26-august-2016">Living Standard — Last Updated 26 August 2016</h2>

<dl>
<dt>Participate:
Expand Down Expand Up @@ -61,11 +61,10 @@ <h2 class="no-num no-toc" id="table-of-contents">Table of Contents</h2>
<li><a href="#port-blocking"><span class="secno">3.5 </span>Port blocking</a></li>
<li><a href="#should-response-to-request-be-blocked-due-to-mime-type?"><span class="secno">3.6 </span>Should
<var>response</var> to <var>request</var> be blocked due to its MIME type?</a></li>
<li><a href="#referrer-policies"><span class="secno">3.7 </span>Referrer policies</a></li>
<li><a href="#client-hints-list"><span class="secno">3.8 </span>Client hints list</a></li>
<li><a href="#streams"><span class="secno">3.9 </span>Streams</a>
<li><a href="#client-hints-list"><span class="secno">3.7 </span>Client hints list</a></li>
<li><a href="#streams"><span class="secno">3.8 </span>Streams</a>
<ol>
<li><a href="#readablestream"><span class="secno">3.9.1 </span>ReadableStream</a></ol></ol></li>
<li><a href="#readablestream"><span class="secno">3.8.1 </span>ReadableStream</a></ol></ol></li>
<li><a href="#http-extensions"><span class="secno">4 </span>HTTP extensions</a>
<ol>
<li><a href="#origin-header"><span class="secno">4.1 </span>`<code title="">Origin</code>` header</a></li>
Expand Down Expand Up @@ -970,12 +969,12 @@ <h4 id="requests"><span class="secno">3.1.5 </span>Requests</h4>

<p>A <a href="#concept-request" title="concept-request">request</a> has an associated
<dfn data-dfn-for="request" data-export="" id="concept-request-referrer-policy" title="concept-request-referrer-policy">referrer policy</dfn>,
which is a <a href="#concept-referrer-policy" title="concept-referrer-policy">referrer policy</a>. Unless stated otherwise it is
the empty string.
which is a <a class="external" data-anolis-spec="referrer" href="https://w3c.github.io/webappsec-referrer-policy/#referrer-policy">referrer policy</a>. Unless stated otherwise it is
the empty string. <a href="#refsREFERRER">[REFERRER]</a>

<p class="note no-backref">This can be used to override a referrer policy associated with an
<a class="external" data-anolis-spec="html" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object">environment settings object</a>.

<p class="note no-backref">This can be used to override a referrer policy associated with
an <a class="external" data-anolis-spec="html" href="https://html.spec.whatwg.org/multipage/webappapis.html#environment-settings-object">environment settings object</a>.
<a href="#refsREFERRER">[REFERRER]</a>

<p>A <a href="#concept-request" title="concept-request">request</a> has an associated
<dfn data-dfn-for="request" data-export="" id="concept-request-client-hints-list" title="concept-request-client-hints-list">client hints list</dfn>,
Expand Down Expand Up @@ -1575,30 +1574,7 @@ <h3 id="should-response-to-request-be-blocked-due-to-mime-type?"><span class="se
</ol>


<h3 id="referrer-policies"><span class="secno">3.7 </span>Referrer policies</h3>

<p>A <dfn data-export="" id="concept-referrer-policy" title="concept-referrer-policy">referrer policy</dfn> is the empty string,
"<code>no-referrer</code>", "<code>no-referrer-when-downgrade</code>", "<code>same-origin</code>",
"<code>origin</code>", "<code>strict-origin</code>", "<code>origin-when-cross-origin</code>",
"<code>strict-origin-when-cross-origin</code>", or "<code>unsafe-url</code>".

<pre class="idl">enum <dfn data-dfn-type="enum" data-export="" id="referrerpolicy">ReferrerPolicy</dfn> {
"",
"no-referrer",
"no-referrer-when-downgrade",
"same-origin",
"origin",
"strict-origin",
"origin-when-cross-origin",
"strict-origin-when-cross-origin",
"unsafe-url"
};</pre>

<p class="note">The details of referrer policies are discussed in Referrer Policy.
<a href="#refsREFERRER">[REFERRER]</a>


<h3 id="client-hints-list"><span class="secno">3.8 </span>Client hints list</h3>
<h3 id="client-hints-list"><span class="secno">3.7 </span>Client hints list</h3>

<p class="note">This section will be integrated into HTTP Client Hints.
<a href="#refsCLIENT-HINTS">[CLIENT-HINTS]</a>
Expand All @@ -1611,11 +1587,11 @@ <h3 id="client-hints-list"><span class="secno">3.8 </span>Client hints list</h3>
`<code title="">width</code>`.


<h3 id="streams"><span class="secno">3.9 </span>Streams</h3>
<h3 id="streams"><span class="secno">3.8 </span>Streams</h3>

<p class="note no-backref">This section might be integrated into other standards, such as IDL.

<h4 id="readablestream"><span class="secno">3.9.1 </span>ReadableStream</h4>
<h4 id="readablestream"><span class="secno">3.8.1 </span>ReadableStream</h4>

<p>A <dfn data-dfn-type="interface" data-export="" id="concept-readablestream" title="concept-ReadableStream">ReadableStream</dfn>
object represents a <a class="external" data-anolis-spec="streams" href="https://streams.spec.whatwg.org/#rs-class" title="readablestream">stream of data</a>. In
Expand Down Expand Up @@ -2459,7 +2435,7 @@ <h3 id="main-fetch"><span class="secno">5.1 </span>Main fetch</h3>
<p>If <var>request</var>'s <a href="#concept-request-referrer" title="concept-request-referrer">referrer</a>
is not "<code>no-referrer</code>", set <var>request</var>'s
<a href="#concept-request-referrer" title="concept-request-referrer">referrer</a> to the result of invoking
<a href="https://w3c.github.io/webappsec-referrer-policy/#determine-requests-referrer">determine <var>request</var>'s referrer</a>.
<a class="external" data-anolis-spec="referrer" href="https://w3c.github.io/webappsec-referrer-policy/#determine-requests-referrer">determine <var>request</var>'s referrer</a>.
<a href="#refsREFERRER">[REFERRER]</a>

<p class="note no-backref">As stated in <cite>Referrer Policy</cite>, user agents can
Expand Down Expand Up @@ -3120,8 +3096,8 @@ <h3 id="http-redirect-fetch"><span class="secno">5.4 </span>HTTP-redirect fetch<
<a href="#concept-request-url-list" title="concept-request-url-list">url list</a>.

<li><p>Invoke
<a href="https://w3c.github.io/webappsec-referrer-policy/#set-requests-referrer-policy-on-redirect">set <var>request</var>'s referrer policy on redirect</a>
on <var>request</var> and <var>actualResponse</var>. <a href="#refsREFERRER">[REFERRER]</a>
<a class="external" data-anolis-spec="referrer" href="https://w3c.github.io/webappsec-referrer-policy/#set-requests-referrer-policy-on-redirect">set <var>request</var>'s referrer policy on redirect</a> on
<var>request</var> and <var>actualResponse</var>. <a href="#refsREFERRER">[REFERRER]</a>

<li>
<p>Return the result of performing a <a href="#concept-main-fetch" title="concept-main-fetch">main fetch</a> using
Expand Down Expand Up @@ -4570,7 +4546,7 @@ <h3 id="request-class"><span class="secno">6.3 </span>Request class</h3>
readonly attribute <a href="#requesttype">RequestType</a> <a href="#dom-request-type" title="dom-Request-type">type</a>;
readonly attribute <a href="#requestdestination">RequestDestination</a> <a href="#dom-request-destination" title="dom-Request-destination">destination</a>;
readonly attribute USVString <a href="#dom-request-referrer" title="dom-Request-referrer">referrer</a>;
readonly attribute <a href="#referrerpolicy">ReferrerPolicy</a> <a href="#dom-request-referrerpolicy" title="dom-Request-referrerPolicy">referrerPolicy</a>;
readonly attribute <a class="external" data-anolis-spec="referrer" href="https://w3c.github.io/webappsec-referrer-policy/#enumdef-referrerpolicy">ReferrerPolicy</a> <a href="#dom-request-referrerpolicy" title="dom-Request-referrerPolicy">referrerPolicy</a>;
readonly attribute <a href="#requestmode">RequestMode</a> <a href="#dom-request-mode" title="dom-Request-mode">mode</a>;
readonly attribute <a href="#requestcredentials">RequestCredentials</a> <a href="#dom-request-credentials" title="dom-Request-credentials">credentials</a>;
readonly attribute <a href="#requestcache">RequestCache</a> <a href="#dom-request-cache" title="dom-Request-cache">cache</a>;
Expand All @@ -4589,7 +4565,7 @@ <h3 id="request-class"><span class="secno">6.3 </span>Request class</h3>
<a href="#headersinit">HeadersInit</a> headers;
<a href="#bodyinit">BodyInit</a>? body;
USVString referrer;
<a href="#referrerpolicy">ReferrerPolicy</a> referrerPolicy;
<a class="external" data-anolis-spec="referrer" href="https://w3c.github.io/webappsec-referrer-policy/#enumdef-referrerpolicy">ReferrerPolicy</a> referrerPolicy;
<a href="#requestmode">RequestMode</a> mode;
<a href="#requestcredentials">RequestCredentials</a> credentials;
<a href="#requestcache">RequestCache</a> cache;
Expand Down
43 changes: 10 additions & 33 deletions Overview.src.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -899,12 +899,12 @@ <h4>Requests</h4>

<p>A <span title=concept-request>request</span> has an associated
<dfn title=concept-request-referrer-policy data-export data-dfn-for=request>referrer policy</dfn>,
which is a <span title=concept-referrer-policy>referrer policy</span>. Unless stated otherwise it is
the empty string.
which is a <span data-anolis-spec=referrer>referrer policy</span>. Unless stated otherwise it is
the empty string. <span data-anolis-ref>REFERRER</span>

<p class="note no-backref">This can be used to override a referrer policy associated with an
<span data-anolis-spec=html>environment settings object</span>.

<p class="note no-backref">This can be used to override a referrer policy associated with
an <span data-anolis-spec=html>environment settings object</span>.
<span data-anolis-ref>REFERRER</span>

<p>A <span title=concept-request>request</span> has an associated
<dfn title=concept-request-client-hints-list data-export data-dfn-for=request>client hints list</dfn>,
Expand Down Expand Up @@ -1504,29 +1504,6 @@ <h3 id="should-response-to-request-be-blocked-due-to-mime-type?"><dfn title="sho
</ol>


<h3>Referrer policies</h3>

<p>A <dfn title=concept-referrer-policy data-export>referrer policy</dfn> is the empty string,
"<code>no-referrer</code>", "<code>no-referrer-when-downgrade</code>", "<code>same-origin</code>",
"<code>origin</code>", "<code>strict-origin</code>", "<code>origin-when-cross-origin</code>",
"<code>strict-origin-when-cross-origin</code>", or "<code>unsafe-url</code>".

<pre class=idl>enum <dfn data-dfn-type=enum data-export>ReferrerPolicy</dfn> {
"",
"no-referrer",
"no-referrer-when-downgrade",
"same-origin",
"origin",
"strict-origin",
"origin-when-cross-origin",
"strict-origin-when-cross-origin",
"unsafe-url"
};</pre>

<p class=note>The details of referrer policies are discussed in Referrer Policy.
<span data-anolis-ref>REFERRER</span>


<h3>Client hints list</h3>

<p class="note">This section will be integrated into HTTP Client Hints.
Expand Down Expand Up @@ -2388,7 +2365,7 @@ <h3>Main fetch</h3>
<p>If <var>request</var>'s <span title=concept-request-referrer>referrer</span>
is not "<code>no-referrer</code>", set <var>request</var>'s
<span title=concept-request-referrer>referrer</span> to the result of invoking
<a href=https://w3c.github.io/webappsec-referrer-policy/#determine-requests-referrer>determine <var>request</var>'s referrer</a>.
<span data-anolis-spec=referrer>determine <var>request</var>'s referrer</span>.
<span data-anolis-ref>REFERRER</span>

<p class="note no-backref">As stated in <cite>Referrer Policy</cite>, user agents can
Expand Down Expand Up @@ -3049,8 +3026,8 @@ <h3>HTTP-redirect fetch</h3>
<span title=concept-request-url-list>url list</span>.

<li><p>Invoke
<a href=https://w3c.github.io/webappsec-referrer-policy/#set-requests-referrer-policy-on-redirect>set <var>request</var>'s referrer policy on redirect</a>
on <var>request</var> and <var>actualResponse</var>. <span data-anolis-ref>REFERRER</span>
<span data-anolis-spec=referrer>set <var>request</var>'s referrer policy on redirect</span> on
<var>request</var> and <var>actualResponse</var>. <span data-anolis-ref>REFERRER</span>

<li>
<p>Return the result of performing a <span title=concept-main-fetch>main fetch</span> using
Expand Down Expand Up @@ -4499,7 +4476,7 @@ <h3>Request class</h3>
readonly attribute <span>RequestType</span> <span title=dom-Request-type>type</span>;
readonly attribute <span>RequestDestination</span> <span title=dom-Request-destination>destination</span>;
readonly attribute USVString <span title=dom-Request-referrer>referrer</span>;
readonly attribute <span>ReferrerPolicy</span> <span title=dom-Request-referrerPolicy>referrerPolicy</span>;
readonly attribute <span data-anolis-spec=referrer>ReferrerPolicy</span> <span title=dom-Request-referrerPolicy>referrerPolicy</span>;
readonly attribute <span>RequestMode</span> <span title=dom-Request-mode>mode</span>;
readonly attribute <span>RequestCredentials</span> <span title=dom-Request-credentials>credentials</span>;
readonly attribute <span>RequestCache</span> <span title=dom-Request-cache>cache</span>;
Expand All @@ -4518,7 +4495,7 @@ <h3>Request class</h3>
<span>HeadersInit</span> headers;
<span>BodyInit</span>? body;
USVString referrer;
<span>ReferrerPolicy</span> referrerPolicy;
<span data-anolis-spec=referrer>ReferrerPolicy</span> referrerPolicy;
<span>RequestMode</span> mode;
<span>RequestCredentials</span> credentials;
<span>RequestCache</span> cache;
Expand Down

0 comments on commit 8243753

Please sign in to comment.