Skip to content

Commit 14bad1d

Browse files
authored
Rename http3Only to requireUnreliable
This should be more future proof. Also tidy up the language a bit. Fixes #1744.
1 parent 4c3750d commit 14bad1d

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

fetch.bs

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2865,8 +2865,9 @@ steps:
28652865
<a>network partition key</a> <var>key</var>, <a for=/>URL</a> <var>url</var>, boolean
28662866
<var>credentials</var>, an optional <a>new connection setting</a> <var>new</var> (default
28672867
"<code>no</code>"), and an optional boolean
2868-
<dfn export for="obtain a connection"><var>http3Only</var></dfn> (default false), run these steps:
2869-
<!-- new's "yes-and-dedicated" and http3Only have been added for WebTransport -->
2868+
<dfn export for="obtain a connection"><var>requireUnreliable</var></dfn> (default false), run these
2869+
steps:
2870+
<!-- new's "yes-and-dedicated" and requireUnreliable have been added for WebTransport -->
28702871

28712872
<ol>
28722873
<li>
@@ -2878,11 +2879,11 @@ steps:
28782879
<a for=connection>origin</a> is <var>url</var>'s <a for=url>origin</a>, and
28792880
<a for=connection>credentials</a> is <var>credentials</var>.
28802881

2881-
<li><p>If <var>connections</var> is not empty and <var>http3Only</var> is false, then return
2882-
one of <var>connections</var>.
2882+
<li><p>If <var>connections</var> is not empty and <var>requireUnreliable</var> is false, then
2883+
return one of <var>connections</var>.
28832884

2884-
<li><p>If there is an HTTP/3 <a>connection</a> in <var>connections</var>, then return that
2885-
<a>connection</a>.
2885+
<li><p>If there is a <a>connection</a> capable of supporting unreliable transport in
2886+
<var>connections</var>, e.g., HTTP/3, then return that <a>connection</a>.
28862887
</ol>
28872888

28882889
<li>
@@ -2920,8 +2921,8 @@ steps:
29202921
<p>Let <var>connection</var> be the result of running this step: run <a>create a connection</a>
29212922
given <var>key</var>, <var>url</var>'s <a for=url>origin</a>, <var>credentials</var>,
29222923
<var>proxy</var>, an <a>implementation-defined</a> <a for=/>host</a> from <var>hosts</var>,
2923-
<var>timingInfo</var>, and <var>http3Only</var> an <a>implementation-defined</a> number of
2924-
times, <a>in parallel</a> from each other, and wait for at least 1 to return a value. In an
2924+
<var>timingInfo</var>, and <var>requireUnreliable</var> an <a>implementation-defined</a> number
2925+
of times, <a>in parallel</a> from each other, and wait for at least 1 to return a value. In an
29252926
<a>implementation-defined</a> manner, select a value to return from the returned values and
29262927
return it. Any other returned values that are <a>connections</a> may be closed.
29272928

@@ -2955,7 +2956,7 @@ reused across <a>connections</a> whose <a for=connection>credentials</a> are fal
29552956
<p>To <dfn>create a connection</dfn>, given a <a for=/>network partition key</a> <var>key</var>,
29562957
<a for=/>origin</a> <var>origin</var>, boolean <var>credentials</var>, string <var>proxy</var>,
29572958
<a for=/>host</a> <var>host</var>, <a for=/>connection timing info</a> <var>timingInfo</var>, and
2958-
boolean <var>http3Only</var>, run these steps:
2959+
boolean <var>requireUnreliable</var>, run these steps:
29592960

29602961
<ol>
29612962
<li><p>Set <var>timingInfo</var>'s <a for="connection timing info">connection start time</a> to the
@@ -2971,16 +2972,19 @@ boolean <var>http3Only</var>, run these steps:
29712972
[[!HTTP1]] [[!TLS]]
29722973

29732974
<ul>
2974-
<li><p>If <var>http3Only</var> is true, then establish an HTTP/3 connection. [[!HTTP3]]
2975+
<li><p>If <var>requireUnreliable</var> is true, then establish a connection capable of unreliable
2976+
transport, e.g., an HTTP/3 connection. [[!HTTP3]]
29752977

2976-
<li><p>When establishing an HTTP/3 connection, include SETTINGS_ENABLE_WEBTRANSPORT with a value
2977-
of 1 and H3_DATAGRAM with a value of 1 in the initial SETTINGS frame. [[!WEBTRANSPORT-HTTP3]]
2978-
[[!HTTP3-DATAGRAM]]
2978+
<li><p>When establishing a connection capable of unreliable transport, enable options that are
2979+
necessary for WebTransport. For HTTP/3, this means including
2980+
<code>SETTINGS_ENABLE_WEBTRANSPORT</code> with a value of <code>1</code> and
2981+
<code>H3_DATAGRAM</code> with a value of <code>1</code> in the initial <code>SETTINGS</code>
2982+
frame. [[!WEBTRANSPORT-HTTP3]] [[!HTTP3-DATAGRAM]]
29792983

29802984
<li><p>If <var>credentials</var> is false, then do not send a TLS client certificate.
29812985

2982-
<li><p>If establishing a connection does not succeed (e.g., a TCP or TLS error), then return
2983-
failure.
2986+
<li><p>If establishing a connection does not succeed (e.g., a UDP, TCP, or TLS error), then
2987+
return failure.
29842988
</ul>
29852989

29862990
<li>

0 commit comments

Comments
 (0)