Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding IANA considerations section #1154

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

adding IANA considerations section #1154

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d2a20de
adding IANA considerations section
dret May 18, 2017
dbe0e7e
changing appendix name/id to highlight that it defines new header fields
dret May 29, 2017
1a879ed
changing sub-section names
dret May 29, 2017
b96674a
adding registration templates
dret May 29, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 36 additions & 6 deletions docs/v1/index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2049,6 +2049,36 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe
</section>
</section>

<section>
<h2 id="iana-considerations">IANA Considerations</h2>

<p>The following registrations are for community review and will be submitted to the <a href="https://www.ietf.org/iesg/">IESG</a> for review, approval, and registration with <a href="https://www.iana.org/">IANA</a>.</p>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will this part of the section need to be changed or replaced when the fields are registered to IANA?


<section>
<h3 id="iana-registration-service-worker">HTTP Header Field Service-Worker</h3>
<ul>
<li>Header Field Name: Service-Worker</li>
<li>Applicable Protocol: Hypertext Transfer Protocol (HTTP)</li>
<li>Status: Standard</li>
<li>Author/Change controller: W3C</li>
<li>Specification document(s): https://www.w3.org/TR/service-workers-1/</li>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure which document it should point to. Service Workers 1 is a snapshot of Service Workers which is a living document.

</ul>
</section>

<section>
<h3 id="iana-registration-service-worker-allowed">HTTP Header Field Service-Worker-Allowed</h3>
<t></t>
<ul>
<li>Header Field Name: Service-Worker-Allowed</li>
<li>Applicable Protocol: Hypertext Transfer Protocol (HTTP)</li>
<li>Status: Standard</li>
<li>Author/Change controller: W3C</li>
<li>Specification document(s): https://www.w3.org/TR/service-workers-1/</li>
</ul>
</section>

</section>

<section>
<h2 id="algorithms">Appendix A: Algorithms</h2>

Expand Down Expand Up @@ -2241,7 +2271,7 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe

1. Append \`<code>Service-Worker</code>\`/\`<code>script</code>\` to |request|'s [=request/header list=].

Note: See the definition of the Service-Worker header in Appendix B: Extended HTTP headers.
Note: See the definition of the Service-Worker header in Appendix B: HTTP header fields.

1. Set |request|'s [=request/cache mode=] to "<code>no-cache</code>" if any of the following are true:
* |registration|'s [=service worker registration/use cache=] is false.
Expand All @@ -2259,7 +2289,7 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe
1. Asynchronously complete these steps with a [=network error=].
1. Let |serviceWorkerAllowed| be the result of [=extracting header list values=] given \`<code>Service-Worker-Allowed</code>\` and |response|'s [=response/header list=].

Note: See the definition of the Service-Worker-Allowed header in Appendix B: Extended HTTP headers.
Note: See the definition of the Service-Worker-Allowed header in Appendix B: HTTP header fields.

1. Set |httpsState| to |response|'s [=response/HTTPS state=].
1. Set |referrerPolicy| to the result of <a>parse a referrer policy from a <code>Referrer-Policy</code> header</a> of |response|.
Expand Down Expand Up @@ -3055,10 +3085,10 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe
</section>

<section>
<h2 id="extended-http-headers">Appendix B: Extended HTTP headers</h2>
<h2 id="http-header-fields">Appendix B: HTTP header fields</h2>

<section>
<h3 id="service-worker-script-request">Service Worker Script Request</h3>
<h3 id="http-header-service-worker">HTTP Header Field Service-Worker</h3>

An HTTP request to [=/fetch=] a [=/service worker=]'s <a>script resource</a> will include the following <a>header</a>:

Expand All @@ -3069,7 +3099,7 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe
</section>

<section>
<h3 id="service-worker-script-response">Service Worker Script Response</h3>
<h3 id="http-header-service-worker-allowed">HTTP Header Field Service-Worker-Allowed</h3>

An HTTP response to a [=/service worker=]'s <a>script resource</a> request can include the following <a>header</a>:

Expand Down Expand Up @@ -3155,4 +3185,4 @@ spec: webappsec-referrer-policy; urlPrefix: https://w3c.github.io/webappsec-refe
The authors would also like to thank Dimitri Glazkov for his scripts and formatting tools which have been essential in the production of this specification. The authors are also grateful for his considerable guidance.

Thanks also to Vivian Cromwell, Greg Simon, Alex Komoroske, Wonsuk Lee, and Seojin Kim for their considerable professional support.
</section>
</section>