emulation.setScrollbarTypeOverride

Author: sadym-chromium

index.bs

@@ -272,6 +272,10 @@ spec: HR-TIME; urlPrefix: https://w3c.github.io/hr-time/
 spec: RFC4648; urlPrefix: https://datatracker.ietf.org/doc/html/rfc4648
   type: dfn
     text: Base64 Encode; url: section-4
+spec: CSS-OVERFLOW-3; urlPrefix: https://drafts.csswg.org/css-overflow-3/
+  type: dfn
+    text: classic scrollbars; url: #classic-scrollbars
+    text: overlay scrollbars; url: #overlay-scrollbars
 spec: CSS-VALUES-3; urlPrefix: https://drafts.csswg.org/css-values-3/
   type: dfn
     text: absolute lengths; url: #absolute-lengths
@@ -5973,6 +5977,7 @@ EmulationCommand = (
   emulation.SetScreenOrientationOverride //
   emulation.SetScreenSettingsOverride //
   emulation.SetScriptingEnabled //
+  emulation.SetScrollbarTypeOverride //
   emulation.SetTimezoneOverride //
   emulation.SetTouchOverride //
   emulation.SetUserAgentOverride
@@ -5987,6 +5992,7 @@ EmulationResult = (
   emulation.SetLocaleOverrideResult /
   emulation.SetScreenOrientationOverrideResult /
   emulation.SetScriptingEnabledResult /
+  emulation.SetScrollbarTypeOverrideResult /
   emulation.SetTimezoneOverrideResult /
   emulation.SetTouchOverrideResult /
   emulation.SetUserAgentOverrideResult
@@ -5997,14 +6003,14 @@ A <dfn export>stored config</dfn> is a [=struct=] with:
 * [=struct/item=] named <dfn for="stored config">scrollbar type</dfn> which is a string or null initially null.
 
 A [=BiDi session=] has an <dfn for=session>session stored configuration</dfn> which is a [=struct=] with:
-* [=struct/item=] named <dfn for="session stored configuration">default</dfn> which is a [=stored config=], initially an empty [=stored config=];
+* [=struct/item=] named <dfn for="session stored configuration">global</dfn> which is a [=stored config=], initially an empty [=stored config=];
 * [=struct/item=] named <dfn for="session stored configuration">user contexts</dfn> which is a weak map between [=user context|user contexts=] and [=stored config=], initially empty;
 * [=struct/item=] named <dfn for="session stored configuration">navigables</dfn> which is a weak map between [=/navigables=] and [=stored config=], initially empty.
 
 <div algorithm>
 
 Note: this algorithm allows for accessing the stored configuration for a given navigable by checking the stored
-configuration for the navigable, then the user context, then the default for all the active sessions.
+configuration for the navigable, then the user context, then the global for all the active sessions.
 
 To <dfn export>get stored config</dfn> of [=stored config=]'s [=struct/item=] |config item| for
 [=/navigables|navigable=] |navigable|:
@@ -6029,42 +6035,42 @@ To <dfn export>get stored config</dfn> of [=stored config=]'s [=struct/item=] |c
 
 1. For each |session| in [=active BiDi sessions=]:
 
-   1. If |session|'s |session|'s [=session stored configuration=]'s [=session stored configuration/default=]
+   1. If |session|'s |session|'s [=session stored configuration=]'s [=session stored configuration/global=]
       |config item| is not null, return |session|'s [=session stored configuration=]'s
-      [=session stored configuration/default=]'s |config item|.
+      [=session stored configuration/global=]'s |config item|.
 
 1. Return null.
 
 </div>
 
 <div algorithm>
 
-To <dfn export>store global config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| in [=BiDi session=]
+To <dfn>store global config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| in [=BiDi session=]
 |session|:
 
-1. Set |session|'s [=session stored configuration=]'s [=session stored configuration/default=]'s |config item| to
+1. Set |session|'s [=session stored configuration=]'s [=session stored configuration/global=]'s |config item| to
    |config|.
 
 </div>
 
 <div algorithm>
 
-To <dfn export>store user context config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| for
+To <dfn>store user context config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| for
 |user context| in [=BiDi session=] |session|:
 
 1. If |config| is null:
 
    1. If |session|'s [=session stored configuration=]'s [=session stored configuration/user contexts=] [=map/contains=]
       |user context|:
-      
+
       1. Set |session|'s [=session stored configuration=]'s
          [=session stored configuration/user contexts=][|user context|]'s |config item| to null.
-   
+
       1. If |session|'s [=session stored configuration=]'s
          [=session stored configuration/user contexts=][|user context|] contains only nulls, remove
          |user context| from |session|'s [=session stored configuration=]'s
          [=session stored configuration/user contexts=].
-      
+
       1. Return.
 
 1. If |session|'s [=session stored configuration=]'s [=session stored configuration/user contexts=] does not
@@ -6078,22 +6084,22 @@ To <dfn export>store user context config</dfn> [=stored config=]'s [=struct/item
 
 <div algorithm>
 
-To <dfn export>store navigable config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| for
+To <dfn>store navigable config</dfn> [=stored config=]'s [=struct/item=] |config item| |config| for
 |navigable| in [=BiDi session=] |session|:
 
 1. If |config| is null:
 
    1. If |session|'s [=session stored configuration=]'s [=session stored configuration/navigables=] [=map/contains=]
       |navigable|:
-      
+
       1. Set |session|'s [=session stored configuration=]'s
          [=session stored configuration/navigables=][|navigable|]'s |config item| to null.
-   
+
       1. If |session|'s [=session stored configuration=]'s
          [=session stored configuration/navigables=][|navigable|] contains only nulls, remove
          |navigable| from |session|'s [=session stored configuration=]'s
          [=session stored configuration/navigables=].
-      
+
       1. Return.
 
 1. If |session|'s [=session stored configuration=]'s [=session stored configuration/navigables=] does not
@@ -7057,6 +7063,106 @@ The [=remote end steps=] with |command parameters| are:
 
 </div>
 
+#### The emulation.SetScrollbarTypeOverride Command #### {#command-emulation-setScrollbarTypeOverride}
+
+The <dfn export for=commands>emulation.setScrollbarTypeOverride</dfn> command modifies
+scrollbar type on the given top-level traversables, user contexts or globally.
+
+<dl>
+   <dt>Command Type</dt>
+   <dd>
+    <pre class="cddl" data-cddl-module="remote-cddl">
+      emulation.SetScrollbarTypeOverride = (
+        method: "emulation.setScrollbarTypeOverride",
+        params: emulation.SetScrollbarTypeOverrideParameters
+      )
+
+      emulation.SetScrollbarTypeOverrideParameters = {
+        scrollbarType: "classic" / "overlay" / null,
+        ? contexts: [+browsingContext.BrowsingContext],
+        ? userContexts: [+browser.UserContext],
+      }
+    </pre>
+   </dd>
+   <dt>Return Type</dt>
+   <dd>
+      <pre class="cddl" data-cddl-module="local-cddl">
+      emulation.SetScrollbarTypeOverrideResult = EmptyResult
+      </pre>
+   </dd>
+</dl>
+
+<div algorithm>
+To <dfn>update scrollbar type override</dfn> for [=/navigable=] |navigable|:
+
+1. Let |scrollbar type override| be the result of [=get stored config=] of [=stored config/scrollbar type=] for
+   |navigable|.
+
+1. Assert that |scrollbar type override| is "<code>classic</code>", "<code>overlay</code>" or null.
+
+1. If |scrollbar type override| is "<code>classic</code>", run [=implementation-defined=] steps to make the
+   |navigable|'s [=active document=] to use <a>classic scrollbars</a>.
+
+1. Otherwise, if |scrollbar type override| is "<code>overlay</code>", run [=implementation-defined=] steps to
+   make the |navigable|'s [=active document=] to use <a>overlay scrollbars</a>.
+
+1. Otherwise, run [=implementation-defined=] steps to make the |navigable|'s [=active document=] to
+   use an [=implementation-defined=] default scrollbar type.
+
+</div>
+
+<div algorithm="remote end steps for emulation.setScrollbarTypeOverride">
+
+The [=remote end steps=] given |session| and |command parameters| are:
+
+1. Let |emulated scrollbar type| be |command parameters|["<code>scrollbarType</code>"].
+
+1. If the implementation does not support setting |emulated scrollbar type|, then return [=error=] with [=error code=]
+   [=unsupported operation=].
+
+1. If |command parameters| [=map/contains=] "<code>userContexts</code>"
+   and |command parameters| [=map/contains=] "<code>contexts</code>",
+   return [=error=] with [=error code=] [=invalid argument=].
+
+1. Let |affected navigables| be an empty [=/set=].
+
+1. If |command parameters| [=map/contains=] "<code>contexts</code>":
+
+   1. Let |navigables| be the result of [=trying=] to
+      [=get valid top-level traversables by ids=] with
+      |command parameters|["<code>contexts</code>"].
+
+   1. For each |navigable| of |navigables|:
+
+      1. [=set/Append=] |navigable| to |affected navigables|.
+
+      1. [=Store navigable config=] [=stored config/scrollbar type=] |emulated scrollbar type| for |navigable|.
+
+1. Otherwise, if |command parameters| [=map/contains=] "<code>userContexts</code>":
+
+   1. Let |user contexts| be the result of [=trying=] to [=get valid user contexts=]
+      with |command parameters|["<code>userContexts</code>"].
+
+   1. For each |user context| of |user contexts|:
+
+      1. [=list/For each=] |top-level traversable| in the list of all [=/top-level traversables=]
+         whose [=associated user context=] is |user context|:
+
+         1. [=set/Append=] |top-level traversable| to |affected navigables|.
+
+      1. [=Store user context config=] [=stored config/scrollbar type=] |emulated scrollbar type| for |user context|.
+
+1. Otherwise, [=store global config=] [=stored config/scrollbar type=] |emulated scrollbar type| for |session|.
+
+1. For each |navigable| of |affected navigables|:
+
+   1. [=Update scrollbar type override=] for |navigable|.
+
+1. Return [=success=] with data null.
+
+</div>
+
+
 #### The emulation.setTimezoneOverride Command ####  {#command-emulation-setTimezoneOverride}
 
 The <dfn export for=commands>emulation.setTimezoneOverride</dfn> command modifies