diff --git a/index.bs b/index.bs index a3904f0..b40467b 100644 --- a/index.bs +++ b/index.bs @@ -59,6 +59,9 @@ urlPrefix: https://w3c.github.io/webdriver-bidi/; spec: webdriver-bidi text: user context; url: #user-context text: get valid top-level traversables by ids; url: #get-valid-top-level-traversables-by-ids text: get valid user contexts; url: #get-valid-user-contexts +urlPrefix: https://w3c.github.io/webdriver/; spec: webdriver + type: dfn + text: remote end; url: #dfn-remote-ends
@@ -468,11 +471,6 @@ has defined a number of properties for itself:
       any other [=equivalence classes=] full version).
 *   wow64-ness - A boolean indicating if the [=user agent=]'s binary is running in 32-bit mode on 64-bit Windows. (e.g., ?0 or ?1)
 
-Whenever the Client Hints are requested for the given [=environment settings object=],
-|environment settings|, if [=emulated UA Client Hints=] associated with the |environment settings|
-is not null, return the corresponding value from the [=emulated UA Client Hints=] instead of the
-default value for the requested property.
-
 [=User agents=] SHOULD keep these strings short and to the point, but servers MUST accept arbitrary
 values for each, as they are all values constructed at the [=user agent=]'s whim.
 
@@ -500,9 +498,18 @@ privacy, compatibility, or other reasons, given a request for any the following
 [=user agent/full version=], [=user agent/platform architecture=], [=user agent/platform bitness=],
 [=user agent/wow64-ness=] or [=user agent/model=].
 
-If the [=user agent=]'s [=emulated client hints=] is not null, the [=user agent=] MUST
-return the corresponding value from the [=emulated client hints=] instead of the default
-value for the requested property.
+
+Whenever the Client Hints property |property| is requested for the given [=environment settings object=] +|environment settings|, run the following steps: + +1. Let |emulated client hints| be [=emulated UA Client Hints=] associated with for |environment settings|. + +1. If |emulated client hints| is not null and |emulated client hints|'s |property| is not undefined, + return |emulated client hints|'s |property|. + +1. Return the implementation-defined value of |property|. + +
The 'Sec-CH-UA' Header Field {#sec-ch-ua} ---------------------------- @@ -1043,12 +1050,14 @@ The toJSON() method MUST run th Automation {#automation} ======================== +For the purposes of user-agent automation and application testing, this document defines extensions to the [[WebDriver-BiDi]] specification. + Definitions {#automation-definitions} ----------------------
 UserAgentClientHintsCommand = (
-  emulation.SetClientHintsOverrideCommand
+  userAgentClientHints.SetClientHintsOverrideCommand
 )
 
@@ -1057,53 +1066,47 @@ A brand version is a [=struct=] with: * [=struct/item=] named version, which is a string. An user agent client hints is a [=struct=] with: -* [=struct/item=] named brands, which is a list of - [=brand version=] pairs or null; -* [=struct/item=] named full version, which is a string or - null; -* [=struct/item=] named full version list, which is a list - of [=brand version=] or null; -* [=struct/item=] named mobile, which is a boolean or null; -* [=struct/item=] named model, which is a string or null; -* [=struct/item=] named platform, which is a string or - null; -* [=struct/item=] named platform version, which is a string - or null; -* [=struct/item=] named architecture, which is a string or - null; -* [=struct/item=] named bitness, which is a string or null; -* [=struct/item=] named wow64, which is a boolean or null. - -A [=User agent=] has emulated client hints, which is a [=struct=] with: -* [=struct/item=] named default emulated client hints, which - is an [=user agent client hints=] or null, initially null; +* [=struct/item=] named brands, which is a list of[=brand version=] pairs or undefined, initially undefined; +* [=struct/item=] named full version, which is a string or undefined, initially undefined; +* [=struct/item=] named full version list, which is a list of [=brand version=] or undefined, initially undefined; +* [=struct/item=] named mobile, which is a boolean or undefined, initially undefined; +* [=struct/item=] named model, which is a string or undefined, initially undefined; +* [=struct/item=] named platform, which is a string or undefined, initially undefined; +* [=struct/item=] named platform version, which is a string or undefined, initially undefined; +* [=struct/item=] named architecture, which is a string or undefined, initially undefined; +* [=struct/item=] named bitness, which is a string or undefined, initially undefined; +* [=struct/item=] named wow64, which is a boolean or undefined, initially undefined. + +A [=remote end=] has associated emulated client hints, which is a [=struct=] with: +* [=struct/item=] named default emulated client hints, + which is a [=user agent client hints=] or null, initially null; * [=struct/item=] named emulated client hints per user contexts, which is a weak map between [=user context=] and [=user agent client hints=], initially empty; * [=struct/item=] named emulated client hints per navigables, which is a weak map between [=/navigables=] and [=user agent client hints=], initially empty. -The emulation.setClientHintsOverride command {#emulation-setclienthintsoverride} +The userAgentClientHints.setClientHintsOverride command {#emulation-setclienthintsoverride} ---------------- -The emulation.setClientHintsOverride command sets or removes +The userAgentClientHints.setClientHintsOverride command sets or removes emulated user agent client hints for a list of [=/navigables=] or [=user context=], or globally.
Command Type
-        emulation.SetClientHintsOverrideCommand = {
-            method: "emulation.setClientHintsOverride",
+        userAgentClientHints.SetClientHintsOverrideCommand = {
+            method: "userAgentClientHints.setClientHintsOverride",
             params: {
-                clientHints: emulation.ClientHintsMetadata / null,
+                clientHints: userAgentClientHints.ClientHintsMetadata / null,
                 ? contexts: [+text],
                 ? userContexts: [+text],
             }
         }
 
-        emulation.ClientHintsMetadata = {
-            ? brands: [* emulation.BrandVersion],
-            ? fullVersionList: [* emulation.BrandVersion],
+        userAgentClientHints.ClientHintsMetadata = {
+            ? brands: [* userAgentClientHints.BrandVersion],
+            ? fullVersionList: [* userAgentClientHints.BrandVersion],
             ? platform: text,
             ? platformVersion: text,
             ? architecture: text,
@@ -1114,7 +1117,7 @@ emulated user agent client hints for a list of [=/navigables=] or [=user context
             ? formFactors: [* text];
         }
 
-        emulation.BrandVersion = {
+        userAgentClientHints.BrandVersion = {
             brand: text,
             version: text
         }
@@ -1123,7 +1126,7 @@ emulated user agent client hints for a list of [=/navigables=] or [=user context
    
Return Type
-      emulation.SetClientHintsOverrideResult = {}
+      userAgentClientHints.SetClientHintsOverrideResult = {}
       
@@ -1159,7 +1162,7 @@ The emulated UA Client Hints associated with [=environment set -
+
The [=remote end steps=] given |command parameters| are: