Skip to content
Permalink
Browse files

[e] (0) Rename API referrer source to just referrer source, for fetch

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=27032
Affected topics: DOM APIs, Workers

git-svn-id: https://svn.whatwg.org/webapps@8846 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Nov 7, 2014
1 parent 7456ed7 commit eb9798e51203b8d0630be01d4333fc6ae021b2e0
Showing with 39 additions and 39 deletions.
  1. +16 −16 complete.html
  2. +16 −16 index
  3. +7 −7 source
</style><body onload=init()>
<header id=head class="head with-buttons">
<p><a href=https://whatwg.org/ class=logo><img src=//whatwg.org/images/logo width=101 alt=WHATWG height=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1><h2 id=living-standard-—-last-updated-[date:-01-jan-1901] class="no-num no-toc">Living Standard — Last Updated <span class=pubdate>6 November 2014</span></h2></hgroup>
<hgroup><h1 class=allcaps>HTML</h1><h2 id=living-standard-—-last-updated-[date:-01-jan-1901] class="no-num no-toc">Living Standard — Last Updated <span class=pubdate>7 November 2014</span></h2></hgroup>

<nav>
<div>

<p>When a user agent is to <dfn id=fetch>fetch</dfn> a resource or <a href=#url id=processing-model:url>URL</a>, optionally
<strong>from</strong> an origin <i>origin</i>, optionally <strong>using</strong> a
specific <a href=#referrer-source id=processing-model:referrer-source>referrer source</a> as an <i>override referrer source</i>, and optionally with
specific <a href=#referrer-source-2 id=processing-model:referrer-source-2>referrer source</a> as an <i>override referrer source</i>, and optionally with
any of a <i>blocking flag</i>, a <i>manual redirect flag</i>, a <i>force same-origin flag</i>,
and a <i>block cookies flag</i>, the following steps must be run. (When a
<em><a href=#url id=processing-model:url-2>URL</a></em> is to be fetched, the URL identifies a resource to be obtained.)<div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=11235" title="Mechanism to disable sending of cookies with requests for style sheets, background images, fonts, WebSockets, server-sent events, <video src>, <source>, <track>, <iframe>, <img>, etc">11235</a></div>
<p>When the user agent is required to perform a <dfn id=potentially-cors-enabled-fetch>potentially CORS-enabled fetch</dfn> of an
<a href=#absolute-url id=cors-enabled-fetch:absolute-url>absolute URL</a> <var>URL</var> with a mode <var>mode</var> that is
either "<a href=#attr-crossorigin-none id=cors-enabled-fetch:attr-crossorigin-none>No CORS</a>", "<a href=#attr-crossorigin-anonymous id=cors-enabled-fetch:attr-crossorigin-anonymous>Anonymous</a>", or "<a href=#attr-crossorigin-use-credentials id=cors-enabled-fetch:attr-crossorigin-use-credentials>Use Credentials</a>", optionally using a
<a href=#referrer-source id=cors-enabled-fetch:referrer-source>referrer source</a> <var>referrer source</var>, with an <a href=#origin-2 id=cors-enabled-fetch:origin-2>origin</a>
<a href=#referrer-source-2 id=cors-enabled-fetch:referrer-source-2>referrer source</a> <var>referrer source</var>, with an <a href=#origin-2 id=cors-enabled-fetch:origin-2>origin</a>
<var>origin</var>, and with a default origin behaviour <var>default</var>
which is either "<i>taint</i>" or "<i>fail</i>", it must run the first applicable set of steps
from the following list. The default origin behaviour is only used if <var>mode</var> is
and abort these steps.<li><p>Remove all child nodes of <var>document</var>, without firing any mutation
events.<li><p>Set the <a href=#current-document-readiness id=loading-xml-documents:current-document-readiness>current document readiness</a> of <var>document</var> to "<code>loading</code>".<li><p>Run the remainder of these steps <a href=#in-parallel id=loading-xml-documents:in-parallel>in parallel</a>, and return true from the
method.<li><p>Let <var>result</var> be a <code id=loading-xml-documents:document><a href=#document>Document</a></code> object.<li><p>Let <var>success</var> be false.<li><p><a href=#fetch id=loading-xml-documents:fetch>Fetch</a> <var>url</var> from the <a href=#origin-2 id=loading-xml-documents:origin-2-3>origin</a> of
<var>document</var>, using the <a href=#api-referrer-source id=loading-xml-documents:api-referrer-source>API referrer source</a> specified by the
<var>document</var>, using the <a href=#referrer-source-2 id=loading-xml-documents:referrer-source-2>referrer source</a> specified by the
<a href=#entry-settings-object id=loading-xml-documents:entry-settings-object-2>entry settings object</a>, with the <i>blocking flag</i> set and the <i>force same-origin flag</i> set.<li>

<p>If the fetch attempt was successful, and the resource's <a href=#content-type id=loading-xml-documents:content-type>Content-Type metadata</a> is an <a href=#xml-mime-type id=loading-xml-documents:xml-mime-type>XML MIME type</a>, then run

<p>Each element can have a <dfn id=specially-focusable>tabindex focus flag</dfn> set, as defined
below. This flag is a factor that contributes towards determining whether an element is a
<a href=#focusable-area id=the-tabindex-attribute:focusable-area-3>focusable area</a>, as described in the previous section.<div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27246" title="disabled elements should never set the tabindex focus flag">27246</a></div>
<a href=#focusable-area id=the-tabindex-attribute:focusable-area-3>focusable area</a>, as described in the previous section.</p>

<p>If the <code id=the-tabindex-attribute:attr-tabindex-3><a href=#attr-tabindex>tabindex</a></code> attribute is specified on an element, it
must be parsed using the <a href=#rules-for-parsing-integers id=the-tabindex-attribute:rules-for-parsing-integers>rules for parsing integers</a>. The attribute's values, or lack
<p>An <a href=#event-loop id=definitions-2:event-loop>event loop</a> that is used when it would not be immediately clear what event
loop to use.</p>

<dt>An <dfn id=api-referrer-source>API referrer source</dfn><dd>
<dt>An <dfn id=referrer-source-2>referrer source</dfn><dd>

<p>Either a <code id=definitions-2:document-3><a href=#document>Document</a></code> (specifically, the <a href=#responsible-document id=definitions-2:responsible-document-2>responsible document</a>), or a
<a href=#url id=definitions-2:url>URL</a>, which is used by some APIs to determine what value to use for the <code id=definitions-2:http-referer><a href=#http-referer>Referer</a></code> (sic) header in calls to the <a href=#fetch id=definitions-2:fetch>fetching</a> algorithm.</p>

<p>An instrument used in security checks.</p>

</dl><div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27032" title="Rename this from API referrer source to simply referrer source as the plan is to use it for all fetc [...]">27032</a></div>
</dl>

<p>The <dfn id=relevant-settings-object-for-a-global-object>relevant settings object for a global object</dfn> <var>o</var> is the
<a href=#environment-settings-object id=definitions-2:environment-settings-object-7>environment settings object</a> whose <a href=#global-object id=definitions-2:global-object-3>global object</a> is <var>o</var>.
similar-origin browsing contexts</a> to which the <code id=script-settings-for-browsing-contexts:window-5><a href=#window>Window</a></code> object's <a href=#browsing-context id=script-settings-for-browsing-contexts:browsing-context-2>browsing
context</a> belongs.</p>

<dt>The <a href=#api-referrer-source id=script-settings-for-browsing-contexts:api-referrer-source>API referrer source</a><dd>
<dt>The <a href=#referrer-source-2 id=script-settings-for-browsing-contexts:referrer-source-2>referrer source</a><dd>

<p>Return the <code id=script-settings-for-browsing-contexts:document-2><a href=#document>Document</a></code> with which the <code id=script-settings-for-browsing-contexts:window-6><a href=#window>Window</a></code> is currently
associated.</p>

<h4 id=events>8.1.5 Events</h4>

<h5 id=event-handler-attributes>8.1.5.1 Event handlers</h5>
<h5 id=event-handler-attributes>8.1.5.1 Event handlers</h5><div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27274" title="onpaste seems to be missing from this list">27274</a></div>



<a href=#in-parallel id=the-eventsource-interface:in-parallel>in parallel</a>.<li>

<p>Do a <a href=#potentially-cors-enabled-fetch id=the-eventsource-interface:potentially-cors-enabled-fetch>potentially CORS-enabled fetch</a> of the resulting <a href=#absolute-url id=the-eventsource-interface:absolute-url>absolute
URL</a> using the <a href=#api-referrer-source id=the-eventsource-interface:api-referrer-source>API referrer source</a> specified by the <a href=#entry-settings-object id=the-eventsource-interface:entry-settings-object-2>entry settings
URL</a> using the <a href=#referrer-source-2 id=the-eventsource-interface:referrer-source-2>referrer source</a> specified by the <a href=#entry-settings-object id=the-eventsource-interface:entry-settings-object-2>entry settings
object</a>, with the <i>mode</i> being <var>CORS mode</var>, and the <i>origin</i> being the <a href=#origin-2 id=the-eventsource-interface:origin-2>origin</a> specified by the <a href=#entry-settings-object id=the-eventsource-interface:entry-settings-object-3>entry settings
object</a>, and process the resource obtained in
this fashion, if any, as described below.</p>



<h5 id=worker-used-for-background-i/o>10.1.2.2 Worker used for background I/O</h5>
<h5 id=worker-used-for-background-i/o>10.1.2.2 Worker used for background I/O</h5><div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27265" title="button.value = data(i);">27265</a></div>

<p><i>This section is non-normative.</i></p>


<p>Attempt to <a href=#fetch id=processing-model-11:fetch>fetch</a> the resource identified by <var>url</var>, from the
<a href=#origin-2 id=processing-model-11:origin-2>origin</a> specified by <var>settings object</var>, using the <a href=#responsible-document id=processing-model-11:responsible-document>responsible
document</a> specified by <var>settings object</var> as the <a href=#referrer-source id=processing-model-11:referrer-source>referrer source</a> (not
the specified <a href=#api-referrer-source id=processing-model-11:api-referrer-source>API referrer source</a>!), and with the <i>blocking flag</i> set and
document</a> specified by <var>settings object</var> as the <a href=#referrer-source-2 id=processing-model-11:referrer-source-2>referrer source</a> (not
the specified <a href=#referrer-source-2 id=processing-model-11:referrer-source-2-2>referrer source</a>!), and with the <i>blocking flag</i> set and
the <i>force same-origin flag</i> set.</p>

<p>If the attempt fails, then for each <code id=processing-model-11:worker><a href=#worker>Worker</a></code> or <code id=processing-model-11:sharedworker><a href=#sharedworker>SharedWorker</a></code> object

<p>Return <var>worker event loop</var>.</p>

<dt>The <a href=#api-referrer-source id=script-settings-for-workers:api-referrer-source>API referrer source</a><dd>
<dt>The <a href=#referrer-source-2 id=script-settings-for-workers:referrer-source-2>referrer source</a><dd>

<p>Return <var>script address</var>.</p>

<a href=#workerglobalscope id=apis-available-to-workers:workerglobalscope-2>WorkerGlobalScope</a> implements <a href=#windowbase64 id=apis-available-to-workers:windowbase64>WindowBase64</a>;</pre>


<h4 id=importing-scripts-and-libraries>10.3.1 Importing scripts and libraries</h4>
<h4 id=importing-scripts-and-libraries>10.3.1 Importing scripts and libraries</h4><div class=status><input onclick=toggleStatus(this) value=⋰ type=button><p class=bugs><strong>Spec bugs:</strong> <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=27276" title="Ensure importScripts(&quot;http://... 404 error ...&quot;) is clearly defined">27276</a></div>

<p>When a script invokes the <dfn id=dom-workerglobalscope-importscripts><code>importScripts(<var>urls</var>)</code></dfn> method on a <code id=importing-scripts-and-libraries:workerglobalscope><a href=#workerglobalscope>WorkerGlobalScope</a></code> object, the user
agent must run the following steps:</p>

<ol><li><p>If there are no arguments, return without doing anything. Abort these steps.<li><p>Let <var>settings object</var> be the <a href=#incumbent-settings-object id=importing-scripts-and-libraries:incumbent-settings-object>incumbent settings
object</a>.<li><p><a href=#resolve-a-url id=importing-scripts-and-libraries:resolve-a-url>Resolve</a> each argument.<li><p>If any fail, throw a <code id=importing-scripts-and-libraries:syntaxerror><a href=#syntaxerror>SyntaxError</a></code> exception and abort these steps.<li>

<p>Attempt to <a href=#fetch id=importing-scripts-and-libraries:fetch>fetch</a> each resource identified by the resulting <a href=#absolute-url id=importing-scripts-and-libraries:absolute-url>absolute URLs</a>, from the <a href=#origin-2 id=importing-scripts-and-libraries:origin-2>origin</a> specified by <var>settings object</var>, using the <a href=#api-referrer-source id=importing-scripts-and-libraries:api-referrer-source>API referrer source</a> specified by <var>settings object</var>, and with the <i>blocking flag</i> set.</p>
<p>Attempt to <a href=#fetch id=importing-scripts-and-libraries:fetch>fetch</a> each resource identified by the resulting <a href=#absolute-url id=importing-scripts-and-libraries:absolute-url>absolute URLs</a>, from the <a href=#origin-2 id=importing-scripts-and-libraries:origin-2>origin</a> specified by <var>settings object</var>, using the <a href=#referrer-source-2 id=importing-scripts-and-libraries:referrer-source-2>referrer source</a> specified by <var>settings object</var>, and with the <i>blocking flag</i> set.</p>

<li>

0 comments on commit eb9798e

Please sign in to comment.
You can’t perform that action at this time.