@@ -2865,8 +2865,9 @@ steps:
2865
2865
<a>network partition key</a> <var> key</var> , <a for=/>URL</a> <var> url</var> , boolean
2866
2866
<var> credentials</var> , an optional <a>new connection setting</a> <var> new</var> (default
2867
2867
"<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 -->
2870
2871
2871
2872
<ol>
2872
2873
<li>
@@ -2878,11 +2879,11 @@ steps:
2878
2879
<a for=connection>origin</a> is <var> url</var> 's <a for=url>origin</a> , and
2879
2880
<a for=connection>credentials</a> is <var> credentials</var> .
2880
2881
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> .
2883
2884
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> .
2886
2887
</ol>
2887
2888
2888
2889
<li>
@@ -2920,8 +2921,8 @@ steps:
2920
2921
<p> Let <var> connection</var> be the result of running this step: run <a>create a connection</a>
2921
2922
given <var> key</var> , <var> url</var> 's <a for=url>origin</a> , <var> credentials</var> ,
2922
2923
<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
2925
2926
<a>implementation-defined</a> manner, select a value to return from the returned values and
2926
2927
return it. Any other returned values that are <a>connections</a> may be closed.
2927
2928
@@ -2955,7 +2956,7 @@ reused across <a>connections</a> whose <a for=connection>credentials</a> are fal
2955
2956
<p> To <dfn>create a connection</dfn> , given a <a for=/>network partition key</a> <var> key</var> ,
2956
2957
<a for=/>origin</a> <var> origin</var> , boolean <var> credentials</var> , string <var> proxy</var> ,
2957
2958
<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:
2959
2960
2960
2961
<ol>
2961
2962
<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:
2971
2972
[[!HTTP1]] [[!TLS]]
2972
2973
2973
2974
<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]]
2975
2977
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]]
2979
2983
2980
2984
<li><p> If <var> credentials</var> is false, then do not send a TLS client certificate.
2981
2985
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.
2984
2988
</ul>
2985
2989
2986
2990
<li>
0 commit comments