diff --git a/index.html b/index.html index 463e941..861258f 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", "infra", "mixed-content", "referrer-policy", "reporting", "resource-timing", "secure-contexts", "url"], editors: [{ name: "Douglas Creager", url: "https://dcreager.net/", @@ -117,32 +117,20 @@

Network requests

A network request occurs when the - user agent must use the network to service a single - request. + [=user agent=] attempts to HTTP-network 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. + 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).

- 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 it is - blocked due to mixed content or CORS failures. Any CORS-preflight - request MUST result in its own network request. + 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 +148,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 +161,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 +174,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.

@@ -298,8 +286,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.

@@ -412,7 +400,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:

@@ -591,7 +579,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=].
  • @@ -660,7 +649,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

    @@ -742,7 +731,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=].
  • @@ -814,10 +804,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.