From c1a5cebe5c01d9a9f6523c23232a729aa3822077 Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Thu, 6 Feb 2025 16:36:12 -0500 Subject: [PATCH 1/6] Issue #181 - redefine section 3.1 in terms of Fetch --- index.html | 46 +++++++++++++++++++--------------------------- 1 file changed, 19 insertions(+), 27 deletions(-) diff --git a/index.html b/index.html index 463e941..5d5fb07 100644 --- a/index.html +++ b/index.html @@ -12,7 +12,7 @@ github: "https://github.com/w3c/network-error-logging/", shortname: "network-error-logging", specStatus: "ED", - xref: ["network-reporting", "fetch", "hr-time", "html", "referrer-policy", "reporting", "resource-timing", "secure-contexts", "url"], + xref: ["network-reporting", "fetch", "hr-time", "html", "mixed-content", "referrer-policy", "reporting", "resource-timing", "secure-contexts", "url"], editors: [{ name: "Douglas Creager", url: "https://dcreager.net/", @@ -117,38 +117,30 @@

Network requests

A network request occurs when the - user agent must use the network to service a single - request. + user agent must use the network to service a single [=request=].

- If the user agent can service a request out of a local - cache, that request MUST NOT result in a network - request. + If the user agent can service a [=request=] out of a local cache, that + [=request=] MUST NOT result in a network request.

- If the user agent follows [=redirect status|redirects=] as part of a [=navigate|navigation=], - there MUST be separate network requests for each request in - the redirect chain. + If the user agent follows [=redirect status|redirects=] as part of a + [=navigate|navigation=], there MUST be separate network requests + for each request in the redirect chain.

- A request MUST NOT result in a network request if the user - agent is known to be offline (i.e., when navigator.{{NavigatorOnLine/onLine}} returns - false). + A [=request=] MUST NOT result in a network request if the user + agent is known to be offline (i.e., when navigator. + {{NavigatorOnLine/onLine}} returns false).

- A request MUST NOT result in a network request if it is - blocked due to mixed content or CORS failures. Any CORS-preflight - request MUST result in its own network request. -

- -

- For user agents that service requests according to the [[FETCH]] - standard, a network request corresponds to one execution of the - HTTP-network fetch algorithm. + A [=request=] MUST NOT result in a network request if it is + blocked due to [=mixed content=] or [=CORS protocol|CORS=] failures. Any + [=CORS-preflight request=] MUST result in its own network request.

@@ -160,9 +152,9 @@

Network requests

  1. DNS resolution: The user agent uses the Domain Name System - [[RFC1034]] to resolve a domain name into an IP address of a + [[RFC1034]] to resolve a domain name into an [=IP address=] of a server can that service - HTTP requests to that domain. + HTTP [=requests=] to that domain.
  2. @@ -173,8 +165,8 @@

    Network requests

  3. Transmission of request and response: Once the secure - channel is established, the user agent can transmit the HTTP request, - and receive the response from the server. + channel is established, the user agent can transmit the HTTP + [=request=], and receive the [=response=] from the server.
@@ -186,8 +178,8 @@

Network requests

to the same domain. Similarly, HTTP persistent connections allow open connections to be shared for multiple requests to the same - origin. However, if multiple phases occur, they will occur - in the above order. + [=network partition key=]. However, if multiple phases occur, they + will occur in the above order.

From b23879392913ccd4d000ede8a6871441ef6a5007 Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Thu, 6 Feb 2025 17:53:35 -0500 Subject: [PATCH 2/6] Fetch updates from 3.1 to section 5.3 --- index.html | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index 5d5fb07..33f65f3 100644 --- a/index.html +++ b/index.html @@ -290,8 +290,8 @@

NEL policies

Each NEL policy has a received IP address, which is the - IP address of the server that the user agent received this NEL - policy from. + [=IP address=] of the server that the user agent received this + NEL policy from.

@@ -583,7 +583,8 @@

Process policy headers

  • Let key be the result of calling determine the network - partition key, given request. + partition key, given request's + [=request/reserved client=].
  • @@ -652,7 +653,7 @@

    Process policy headers

    received IP address
    - the IP address of the server that the user agent received + the [=IP address=] of the server that the user agent received response from

    @@ -734,7 +735,8 @@

    Choose a policy for a request

  • Let key be the result of calling determine the network - partition key, given request. + partition key, given request's' + [=request/reserved client=].
  • @@ -806,10 +808,9 @@

    Extract request headers

  • For each header in request's - [=request/header list=] whose name is header name, append - header's value to - values. + [=request/header list=] whose name + is header name, append header's + value to values.
  • From efbce4a99b6e9eaae6ca2f942c9310eca129d1a5 Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Fri, 7 Feb 2025 17:48:41 -0500 Subject: [PATCH 3/6] minor edits to intro; link to ABNF rfc --- index.html | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 33f65f3..3f33ee9 100644 --- a/index.html +++ b/index.html @@ -12,7 +12,7 @@ github: "https://github.com/w3c/network-error-logging/", shortname: "network-error-logging", specStatus: "ED", - xref: ["network-reporting", "fetch", "hr-time", "html", "mixed-content", "referrer-policy", "reporting", "resource-timing", "secure-contexts", "url"], + xref: ["network-reporting", "fetch", "hr-time", "html", "infra", "mixed-content", "referrer-policy", "reporting", "resource-timing", "secure-contexts", "url"], editors: [{ name: "Douglas Creager", url: "https://dcreager.net/", @@ -117,7 +117,8 @@

    Network requests

    A network request occurs when the - user agent must use the network to service a single [=request=]. + [=user agent=] attempts to [=fetch=] a resource over the network for a + given [=request=].

    @@ -404,7 +405,7 @@

    NEL response header

    The NEL response header is used to communicate an origin's NEL policy to the user agent. The - ABNF (Augmented Backus-Naur Form) syntax for the NEL header is as + ABNF (Augmented Backus-Naur Form) [[RFC5234]] syntax for the NEL header is as follows:

    From 35a7a96828a959c29e373485b39511ed704571bd Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Mon, 17 Feb 2025 13:53:47 -0500 Subject: [PATCH 4/6] review feedback --- index.html | 15 ++------------- 1 file changed, 2 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index 3f33ee9..48c5ade 100644 --- a/index.html +++ b/index.html @@ -117,19 +117,8 @@

    Network requests

    A network request occurs when the - [=user agent=] attempts to [=fetch=] a resource over the network for a - given [=request=]. -

    - -

    - If the user agent can service a [=request=] out of a local cache, that - [=request=] MUST NOT result in a network request. -

    - -

    - If the user agent follows [=redirect status|redirects=] as part of a - [=navigate|navigation=], there MUST be separate network requests - for each request in the redirect chain. + [=user agent=] attempts to [=HTTP-network fetch=] a resource over the + network for a given [=request=].

    From b48ee03a40cf3df24fd01e80c1f1ccff99c017ec Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Mon, 17 Feb 2025 14:05:28 -0500 Subject: [PATCH 5/6] manually cite http-network fetch --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 48c5ade..3457f13 100644 --- a/index.html +++ b/index.html @@ -117,8 +117,8 @@

    Network requests

    A network request occurs when the - [=user agent=] attempts to [=HTTP-network fetch=] a resource over the - network for a given [=request=]. + [=user agent=] attempts to HTTP-network fetch + a resource over the network for a given [=request=].

    From 20b68d2b6cf69f693e64323c325cd135dc27371d Mon Sep 17 00:00:00 2001 From: Mike Taylor Date: Mon, 5 May 2025 14:19:07 -0400 Subject: [PATCH 6/6] add back note, even if redundant --- index.html | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/index.html b/index.html index 3457f13..861258f 100644 --- a/index.html +++ b/index.html @@ -133,6 +133,12 @@

    Network requests

    [=CORS-preflight request=] MUST result in its own network request.

    +

    + For user agents that service requests according to the [[FETCH]] + standard, a network request corresponds to one execution of the + HTTP-network fetch algorithm. +

    +

    Regardless of which fetch algorithm and which underlying application and transport protocols are used, servicing a network request consists