55 <title>WebDriver BiDi</title>
66 <meta content="ED" name="w3c-status">
77 <link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
8- <meta content="Bikeshed version 3c53a5b02 , updated Thu Nov 27 17:03:30 2025 +0000 " name="generator">
8+ <meta content="Bikeshed version 0ef803fdf , updated Tue Jan 6 11:59:39 2026 -0800 " name="generator">
99 <link href="https://www.w3.org/TR/webdriver-bidi/" rel="canonical">
1010 <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon">
11- <meta content="e09d68ef1bd85f21e0f98f51b893b9a5db331800 " name="revision">
11+ <meta content="43236c6232ca15cd856a75470b8c665996132473 " name="revision">
1212 <meta content="dark light" name="color-scheme">
1313 <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
1414<style>
650650</p>
651651 <h1 class="no-ref p-name" id="title">WebDriver BiDi</h1>
652652 <p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>,
653- <time class="dt-updated" datetime="2026-03-03">3 March 2026</time></p>
653+ <time class="dt-updated" datetime="2026-03-05">5 March 2026</time></p>
654654 <details open>
655655 <summary>More details about this document</summary>
656656 <div data-fill-with="spec-metadata">
@@ -2572,19 +2572,19 @@ <h5 class="heading settled" data-level="7.1.2.2" id="type-session-CapabilityRequ
25722572 <p>WebDriver BiDi defines <a data-link-type="dfn" href="https://w3c.github.io/webdriver/#dfn-additional-webdriver-capability" id="ref-for-dfn-additional-webdriver-capability">additional WebDriver
25732573capabilities</a>. The following tables enumerates the capabilities each
25742574implementation must support for WebDriver BiDi.</p>
2575- <table class="def">
2575+ <table class="def simpledef ">
25762576 <tbody>
25772577 <tr>
2578- <th>Capability
2578+ <th>Capability:
25792579 <td><dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport id="websocket-url">WebSocket URL</dfn>
25802580 <tr>
2581- <th>Key
2581+ <th>Key:
25822582 <td>"<code>webSocketUrl</code>"
25832583 <tr>
2584- <th>Value type
2584+ <th>Value type:
25852585 <td>boolean
25862586 <tr>
2587- <th>Description
2587+ <th>Description:
25882588 <td>Defines the current session’s support for bidirectional connection.
25892589 </table>
25902590 <div class="algorithm" data-algorithm="webSocketUrl capability deserialization algorithm">
@@ -3270,6 +3270,12 @@ <h4 class="heading settled" data-level="7.2.2" id="module-browser-window"><span
32703270 <p class="note" role="note"><span class="marker">Note:</span> This is a no-op for documents in window that are not fullscreen.</p>
32713271 </ol>
32723272 </ol>
3273+ <li data-md>
3274+ <p>If <var>current state</var> is "<code>maximized</code>" or "<code>minimized</code>":</p>
3275+ <ol>
3276+ <li data-md>
3277+ <p><a data-link-type="dfn" href="#restore-the-client-window" id="ref-for-restore-the-client-window">Restore the client window</a> <var>window</var>.</p>
3278+ </ol>
32733279 <li data-md>
32743280 <p>Switch on the value of <var>state</var>:</p>
32753281 <dl>
@@ -3287,11 +3293,6 @@ <h4 class="heading settled" data-level="7.2.2" id="module-browser-window"><span
32873293 <p><a data-link-type="dfn" href="https://infra.spec.whatwg.org/#iteration-break" id="ref-for-iteration-break①">Break</a>.</p>
32883294 </ol>
32893295 </ol>
3290- <dt>"<code>normal</code>"
3291-
3292- <dd>1. <a data-link-type="dfn" href="#restore-the-client-window" id="ref-for-restore-the-client-window">Restore the client window</a> <var>window</var>.
3293-
3294-
32953296 <dt>"<code>maximize</code>"
32963297
32973298 <dd>1. <a data-link-type="dfn" href="#maximize-the-client-window" id="ref-for-maximize-the-client-window">Maximize the client window</a> <var>window</var>.
@@ -8875,6 +8876,7 @@ <h5 class="heading settled" data-level="7.5.4.7" id="type-network-Cookie"><span
88758876 <p><code class="cddl"><a data-link-type="cddl" href="#cddl-module-remote-end-definition" id="ref-for-cddl-module-remote-end-definition②①">Remote end definition</a></code> and <code class="cddl"><a data-link-type="cddl" href="#cddl-module-local-end-definition" id="ref-for-cddl-module-local-end-definition②⑤">local end definition</a></code></p>
88768877<pre class="cddl def highlight" data-cddl-module="local-cddl,remote-cddl"><dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-networksamesite"><code>network.SameSite</code></dfn> = <dfn class="dfn-paneled" data-dfn-for="network.SameSite" data-dfn-type="cddl-value" data-lt="strict|"strict"" data-noexport id="cddl-value-networksamesite-strict"><code>"strict"</code></dfn> / <dfn class="dfn-paneled" data-dfn-for="network.SameSite" data-dfn-type="cddl-value" data-lt="lax|"lax"" data-noexport id="cddl-value-networksamesite-lax"><code>"lax"</code></dfn> / <dfn class="dfn-paneled" data-dfn-for="network.SameSite" data-dfn-type="cddl-value" data-lt="none|"none"" data-noexport id="cddl-value-networksamesite-none"><code>"none"</code></dfn> / <dfn class="dfn-paneled" data-dfn-for="network.SameSite" data-dfn-type="cddl-value" data-lt="default|"default"" data-noexport id="cddl-value-networksamesite-default"><code>"default"</code></dfn>
88778878
8879+
88788880<dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-networkcookie"><code>network.Cookie</code></dfn> = {
88798881 <dfn class="dfn-paneled" data-dfn-for="network.Cookie" data-dfn-type="cddl-key" data-lt="name|"name"" data-noexport id="cddl-key-networkcookie-name"><code>name</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①②④">text</a>,
88808882 <dfn class="dfn-paneled" data-dfn-for="network.Cookie" data-dfn-type="cddl-key" data-lt="value|"value"" data-noexport id="cddl-key-networkcookie-value"><code>value</code></dfn>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue" id="ref-for-cddl-type-networkbytesvalue">network.BytesValue</a>,
@@ -8977,8 +8979,10 @@ <h5 class="heading settled" data-level="7.5.4.10" id="type-network-FetchTimingIn
89778979 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="connectStart|"connectStart"" data-noexport id="cddl-key-networkfetchtiminginfo-connectstart"><code>connectStart</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①③⑦">float</a>,
89788980 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="connectEnd|"connectEnd"" data-noexport id="cddl-key-networkfetchtiminginfo-connectend"><code>connectEnd</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①③⑧">float</a>,
89798981 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="tlsStart|"tlsStart"" data-noexport id="cddl-key-networkfetchtiminginfo-tlsstart"><code>tlsStart</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①③⑨">float</a>,
8982+
89808983 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="requestStart|"requestStart"" data-noexport id="cddl-key-networkfetchtiminginfo-requeststart"><code>requestStart</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①④⓪">float</a>,
89818984 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="responseStart|"responseStart"" data-noexport id="cddl-key-networkfetchtiminginfo-responsestart"><code>responseStart</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①④①">float</a>,
8985+
89828986 <dfn class="dfn-paneled" data-dfn-for="network.FetchTimingInfo" data-dfn-type="cddl-key" data-lt="responseEnd|"responseEnd"" data-noexport id="cddl-key-networkfetchtiminginfo-responseend"><code>responseEnd</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D①④②">float</a>,
89838987}
89848988</pre>
@@ -12558,12 +12562,14 @@ <h5 class="heading settled" data-level="7.6.3.13" id="type-script-RemoteReferenc
1255812562
1255912563<dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-scriptsharedreference"><code>script.SharedReference</code></dfn> = {
1256012564 <dfn class="dfn-paneled" data-dfn-for="script.SharedReference" data-dfn-type="cddl-key" data-lt="sharedId|"sharedId"" data-noexport id="cddl-key-scriptsharedreference-sharedid"><code>sharedId</code></dfn>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid" id="ref-for-cddl-type-scriptsharedid">script.SharedId</a>
12565+
1256112566 ? <dfn class="dfn-paneled" data-dfn-for="script.SharedReference" data-dfn-type="cddl-key" data-lt="handle|"handle"" data-noexport id="cddl-key-scriptsharedreference-handle"><code>handle</code></dfn>: <a data-link-type="cddl" href="#cddl-type-scripthandle" id="ref-for-cddl-type-scripthandle">script.Handle</a>,
1256212567 <a data-link-type="cddl" href="#cddl-type-extensible" id="ref-for-cddl-type-extensible①④">Extensible</a>
1256312568}
1256412569
1256512570<dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-scriptremoteobjectreference"><code>script.RemoteObjectReference</code></dfn> = {
1256612571 <dfn class="dfn-paneled" data-dfn-for="script.RemoteObjectReference" data-dfn-type="cddl-key" data-lt="handle|"handle"" data-noexport id="cddl-key-scriptremoteobjectreference-handle"><code>handle</code></dfn>: <a data-link-type="cddl" href="#cddl-type-scripthandle" id="ref-for-cddl-type-scripthandle①">script.Handle</a>,
12572+
1256712573 ? <dfn class="dfn-paneled" data-dfn-for="script.RemoteObjectReference" data-dfn-type="cddl-key" data-lt="sharedId|"sharedId"" data-noexport id="cddl-key-scriptremoteobjectreference-sharedid"><code>sharedId</code></dfn>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid" id="ref-for-cddl-type-scriptsharedid①">script.SharedId</a>
1256812574 <a data-link-type="cddl" href="#cddl-type-extensible" id="ref-for-cddl-type-extensible①⑤">Extensible</a>
1256912575}
@@ -14688,6 +14694,7 @@ <h5 class="heading settled" data-level="7.7.3.1" id="command-storage-getCookies"
1468814694 <dfn class="dfn-paneled" data-dfn-for="storage.GetCookies" data-dfn-type="cddl-key" data-lt="params|"params"" data-noexport id="cddl-key-storagegetcookies-params"><code>params</code></dfn>: <a data-link-type="cddl" href="#cddl-type-storagegetcookiesparameters" id="ref-for-cddl-type-storagegetcookiesparameters">storage.GetCookiesParameters</a>
1468914695)
1469014696
14697+
1469114698<dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-storagecookiefilter"><code>storage.CookieFilter</code></dfn> = {
1469214699 ? <dfn class="dfn-paneled" data-dfn-for="storage.CookieFilter" data-dfn-type="cddl-key" data-lt="name|"name"" data-noexport id="cddl-key-storagecookiefilter-name"><code>name</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D②②⓪">text</a>,
1469314700 ? <dfn class="dfn-paneled" data-dfn-for="storage.CookieFilter" data-dfn-type="cddl-key" data-lt="value|"value"" data-noexport id="cddl-key-storagecookiefilter-value"><code>value</code></dfn>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue" id="ref-for-cddl-type-networkbytesvalue⑦">network.BytesValue</a>,
@@ -14778,6 +14785,7 @@ <h5 class="heading settled" data-level="7.7.3.2" id="command-storage-setCookie">
1477814785 <dfn class="dfn-paneled" data-dfn-for="storage.SetCookie" data-dfn-type="cddl-key" data-lt="params|"params"" data-noexport id="cddl-key-storagesetcookie-params"><code>params</code></dfn>: <a data-link-type="cddl" href="#cddl-type-storagesetcookieparameters" id="ref-for-cddl-type-storagesetcookieparameters">storage.SetCookieParameters</a>,
1477914786)
1478014787
14788+
1478114789<dfn class="dfn-paneled" data-dfn-type="cddl-type" data-noexport id="cddl-type-storagepartialcookie"><code>storage.PartialCookie</code></dfn> = {
1478214790 <dfn class="dfn-paneled" data-dfn-for="storage.PartialCookie" data-dfn-type="cddl-key" data-lt="name|"name"" data-noexport id="cddl-key-storagepartialcookie-name"><code>name</code></dfn>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D" id="ref-for-appendix-D②②⑦">text</a>,
1478314791 <dfn class="dfn-paneled" data-dfn-for="storage.PartialCookie" data-dfn-type="cddl-key" data-lt="value|"value"" data-noexport id="cddl-key-storagepartialcookie-value"><code>value</code></dfn>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue" id="ref-for-cddl-type-networkbytesvalue⑧">network.BytesValue</a>,
@@ -21974,6 +21982,7 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-remote-end-
2197421982
2197521983<a href="#cddl-type-networksamesite"><code>network.SameSite</code></a> = <a href="#cddl-value-networksamesite-strict"><code>"strict"</code></a> / <a href="#cddl-value-networksamesite-lax"><code>"lax"</code></a> / <a href="#cddl-value-networksamesite-none"><code>"none"</code></a> / <a href="#cddl-value-networksamesite-default"><code>"default"</code></a>
2197621984
21985+
2197721986<a href="#cddl-type-networkcookie"><code>network.Cookie</code></a> = {
2197821987 <a href="#cddl-key-networkcookie-name"><code>name</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">text</a>,
2197921988 <a href="#cddl-key-networkcookie-value"><code>value</code></a>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue">network.BytesValue</a>,
@@ -22350,12 +22359,14 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-remote-end-
2235022359
2235122360<a href="#cddl-type-scriptsharedreference"><code>script.SharedReference</code></a> = {
2235222361 <a href="#cddl-key-scriptsharedreference-sharedid"><code>sharedId</code></a>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid">script.SharedId</a>
22362+
2235322363 ? <a href="#cddl-key-scriptsharedreference-handle"><code>handle</code></a>: <a data-link-type="cddl" href="#cddl-type-scripthandle">script.Handle</a>,
2235422364 <a data-link-type="cddl" href="#cddl-type-extensible">Extensible</a>
2235522365}
2235622366
2235722367<a href="#cddl-type-scriptremoteobjectreference"><code>script.RemoteObjectReference</code></a> = {
2235822368 <a href="#cddl-key-scriptremoteobjectreference-handle"><code>handle</code></a>: <a data-link-type="cddl" href="#cddl-type-scripthandle">script.Handle</a>,
22369+
2235922370 ? <a href="#cddl-key-scriptremoteobjectreference-sharedid"><code>sharedId</code></a>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid">script.SharedId</a>
2236022371 <a data-link-type="cddl" href="#cddl-type-extensible">Extensible</a>
2236122372}
@@ -22657,6 +22668,7 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-remote-end-
2265722668 <a href="#cddl-key-storagegetcookies-params"><code>params</code></a>: <a data-link-type="cddl" href="#cddl-type-storagegetcookiesparameters">storage.GetCookiesParameters</a>
2265822669)
2265922670
22671+
2266022672<a href="#cddl-type-storagecookiefilter"><code>storage.CookieFilter</code></a> = {
2266122673 ? <a href="#cddl-key-storagecookiefilter-name"><code>name</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">text</a>,
2266222674 ? <a href="#cddl-key-storagecookiefilter-value"><code>value</code></a>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue">network.BytesValue</a>,
@@ -22697,6 +22709,7 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-remote-end-
2269722709 <a href="#cddl-key-storagesetcookie-params"><code>params</code></a>: <a data-link-type="cddl" href="#cddl-type-storagesetcookieparameters">storage.SetCookieParameters</a>,
2269822710)
2269922711
22712+
2270022713<a href="#cddl-type-storagepartialcookie"><code>storage.PartialCookie</code></a> = {
2270122714 <a href="#cddl-key-storagepartialcookie-name"><code>name</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">text</a>,
2270222715 <a href="#cddl-key-storagepartialcookie-value"><code>value</code></a>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue">network.BytesValue</a>,
@@ -23541,6 +23554,7 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-local-end-d
2354123554
2354223555<a href="#cddl-type-networksamesite"><code>network.SameSite</code></a> = <a href="#cddl-value-networksamesite-strict"><code>"strict"</code></a> / <a href="#cddl-value-networksamesite-lax"><code>"lax"</code></a> / <a href="#cddl-value-networksamesite-none"><code>"none"</code></a> / <a href="#cddl-value-networksamesite-default"><code>"default"</code></a>
2354323556
23557+
2354423558<a href="#cddl-type-networkcookie"><code>network.Cookie</code></a> = {
2354523559 <a href="#cddl-key-networkcookie-name"><code>name</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">text</a>,
2354623560 <a href="#cddl-key-networkcookie-value"><code>value</code></a>: <a data-link-type="cddl" href="#cddl-type-networkbytesvalue">network.BytesValue</a>,
@@ -23567,8 +23581,10 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-local-end-d
2356723581 <a href="#cddl-key-networkfetchtiminginfo-connectstart"><code>connectStart</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
2356823582 <a href="#cddl-key-networkfetchtiminginfo-connectend"><code>connectEnd</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
2356923583 <a href="#cddl-key-networkfetchtiminginfo-tlsstart"><code>tlsStart</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
23584+
2357023585 <a href="#cddl-key-networkfetchtiminginfo-requeststart"><code>requestStart</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
2357123586 <a href="#cddl-key-networkfetchtiminginfo-responsestart"><code>responseStart</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
23587+
2357223588 <a href="#cddl-key-networkfetchtiminginfo-responseend"><code>responseEnd</code></a>: <a data-link-type="cddl-type" href="https://www.rfc-editor.org/rfc/rfc8610#appendix-D">float</a>,
2357323589}
2357423590
@@ -23924,12 +23940,14 @@ <h3 class="heading no-num no-ref settled" id="cddl-index-cddl-module-local-end-d
2392423940
2392523941<a href="#cddl-type-scriptsharedreference"><code>script.SharedReference</code></a> = {
2392623942 <a href="#cddl-key-scriptsharedreference-sharedid"><code>sharedId</code></a>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid">script.SharedId</a>
23943+
2392723944 ? <a href="#cddl-key-scriptsharedreference-handle"><code>handle</code></a>: <a data-link-type="cddl" href="#cddl-type-scripthandle">script.Handle</a>,
2392823945 <a data-link-type="cddl" href="#cddl-type-extensible">Extensible</a>
2392923946}
2393023947
2393123948<a href="#cddl-type-scriptremoteobjectreference"><code>script.RemoteObjectReference</code></a> = {
2393223949 <a href="#cddl-key-scriptremoteobjectreference-handle"><code>handle</code></a>: <a data-link-type="cddl" href="#cddl-type-scripthandle">script.Handle</a>,
23950+
2393323951 ? <a href="#cddl-key-scriptremoteobjectreference-sharedid"><code>sharedId</code></a>: <a data-link-type="cddl" href="#cddl-type-scriptsharedid">script.SharedId</a>
2393423952 <a data-link-type="cddl" href="#cddl-type-extensible">Extensible</a>
2393523953}
0 commit comments