Skip to content

Commit

Permalink
Add WebDriver BiDi network request logging
Browse files Browse the repository at this point in the history
  • Loading branch information
jgraham committed May 22, 2023
1 parent 086e35f commit 5df348c
Showing 1 changed file with 42 additions and 1 deletion.
43 changes: 42 additions & 1 deletion fetch.bs
Original file line number Diff line number Diff line change
Expand Up @@ -110,6 +110,12 @@ urlPrefix:https://tc39.es/ecma262/#;type:dfn;spec:ecma-262
"href": "https://datatracker.ietf.org/doc/html/draft-ietf-dnsop-svcb-https",
"publisher": "IETF",
"title": "Service binding and parameter specification via the DNS (DNS SVCB and HTTPS RRs)"
},
"WEBDRIVER-BIDI": {
"authors": [],
"href": "https://w3c.github.io/webdriver-bidi/",
"publisher": "W3C",
"title": "WebDriver BiDi"
}
}
</pre>
Expand Down Expand Up @@ -2123,6 +2129,11 @@ Unless stated otherwise, it is false.

<p class=note>This is for exclusive use by HTML's navigate algorithm. [[!HTML]]

<p>A <a for=/>request</a> has an associated <dfn export for=request>navigation
id</dfn> (a string). Unless stated otherwise, it is null.

<p class=note>This is for exclusive use by HTML's navigate algorithm. [[!HTML]]

<p>A <a for=/>request</a> has an associated boolean <dfn export for=request>render-blocking</dfn>.
Unless stated otherwise, it is false.

Expand Down Expand Up @@ -2164,6 +2175,15 @@ otherwise, it is unset.
<a for=request>done flag</a>, and <a for=request>timing allow failed flag</a> are used as
bookkeeping details by the <a for=/>fetch</a> algorithm.

<p>A <a for=/>request</a> has an associated
<dfn export for=request id=concept-request-id>request id</dfn> which is a unique
string automatically set when the <a for=/>request</a> is created.

Note: the [=request/request id=] is used by WebDriver-BiDi. It remains constant
across all requests resulting from a redirect of an initial request. When a
request is [=request/cloned=], the created request gets a unique
[=request/request id=]. [[!WEBDRIVER-BIDI]]

<hr>

<p>A <dfn export>subresource request</dfn> is a <a for=/>request</a>
Expand Down Expand Up @@ -2240,7 +2260,7 @@ is to return the result of <a>serializing a request origin</a> with <var>request

<ol>
<li><p>Let <var>newRequest</var> be a copy of <var>request</var>, except for its
<a for=request>body</a>.
<a for=request>body</a> and <a for=request>request id</a>.

<li><p>If <var>request</var>'s <a for=request>body</a> is non-null, set <var>newRequest</var>'s
<a for=request>body</a> to the result of <a lt=clone for=body>cloning</a> <var>request</var>'s
Expand Down Expand Up @@ -4779,6 +4799,11 @@ steps:
<a for=request>URL</a>, <var>fetchParams</var>'s <a for="fetch params">request</a>'s
<a for=request>initiator type</a>, <var>global</var>, <var>cacheState</var>,
<var>bodyInfo</var>, and <var>responseStatus</var>.

<li><p>If <var>response</var> is a <a>network error</a>, run
the <a>WebDriver BiDi fetch error</a> steps with <var>request</var>. Otherwise
run the <a>WebDriver BiDi response completed</a> steps with
<var>request</var> and <var>response</var>.
</ol>

<li>
Expand Down Expand Up @@ -5129,6 +5154,13 @@ these steps:
<a>filtered response</a>; otherwise to <var>response</var>'s
<a for="filtered response">internal response</a>.

<!-- Service Workers is responsible for emmitting the WebDriver BiDi
request events in this case. That's necessary to ensure that the events are
only generated if the service worker will handle the fetch, and to get the
correct event ordering in the case of network fallback -->
<li><p>Run the [=WebDriver BiDi response started=] steps with
<var>request</var> and <var>response</var>.

<li>
<p>If one of the following is true

Expand Down Expand Up @@ -5663,6 +5695,10 @@ run these steps:
<p class=note>This intentionally does not depend on <var>httpRequest</var>'s
<a for=request>credentials mode</a>.

<!-- After this point the request is not further modified before being either
retrieved from the cache or sent -->
<li><p>Run the <a>WebDriver BiDi before request sent</a> steps with <var>request</var>.

<li><p>Set <var>httpCache</var> to the result of <a>determining the HTTP cache partition</a>,
given <var>httpRequest</var>.

Expand Down Expand Up @@ -5758,6 +5794,8 @@ run these steps:
<li><p><a>If aborted</a>, then return the <a for=/>appropriate network error</a> for
<var>fetchParams</var>.

<li><p>If <var>response</var> is not null, run the <a>WebDriver BiDi response
started</a> steps with <var>request</var> and <var>response</var>.

<!-- If response is still null, we require a forwarded request. -->
<li>
Expand Down Expand Up @@ -6021,6 +6059,9 @@ optional boolean <var>forceNewConnection</var> (default false), run these steps:

<li><p>Wait until all the HTTP response headers are transmitted.

<li><p>Run the [=WebDriver BiDi response started=] steps with
|request| and |response|.

<li><p>Let <var>status</var> be the HTTP response's status code.

<li>
Expand Down

0 comments on commit 5df348c

Please sign in to comment.