WebDriver

本规范的各个部分以逐步算法的形式编写。 这些算法的细节不具有任何规范性意义； 实现可以自由采用任何实现策略， 只要其产生与规范等效的输出即可。 特别是，本文档中的算法针对 可读性而非性能进行了优化。

在返回值的算法可能失败的情况下， 它们被写成返回 成功或 错误。 成功 值具有关联的 data 字段， 其中封装了返回的值， 而错误值具有关联的错误码。

当调用可能失败的算法时， 构造 “Let result be the result of trying to call algorithm” 等价于

1. 令 temp 为调用 algorithm 的结果。

2. 如果 temp 是错误，则返回 temp； 否则令 result 为 temp 的 data 字段。

使用 name 从 object 获取 属性的结果，定义为与在 object 上调用 Object.[[GetOwnProperty]](name) 的结果相同。

使用参数 name 和 default 从 object 获取带默认值的属性的结果， 定义为：如果在 object 上调用 Object.[[GetOwnProperty]](name) 得到的结果不是 undefined，则为该结果； 否则为 default。

使用参数 name 和 value 在 object 上设置属性， 定义为与在 object 上调用 Object.[[Put]](name, value) 相同。

对 JSON Object 类型的 object 进行 JSON 序列化的结果， 定义为调用 stringify(object) 的结果。

使用 text 进行 JSON 反序列化的结果定义为 调用 parse(text) 的结果。

WebDriver 协议被组织为命令。 本规范中定义了方法和模板的每个 HTTP 请求 都表示一个单独的命令， 因此每个命令都会产生一个单独的HTTP 响应。

响应一个命令时， 远程端将运行一系列操作， 称为远程端步骤。 这些步骤提供了远程端 在接收到特定命令时所采取的操作序列。

远程端是一个 HTTP 服务器， 从客户端读取请求并写入响应， 通常通过 TCP 套接字进行。 为了本规范的目的，我们将特定本地端和远程端之间的数据传输建模为一个 连接， 远程端可以向该连接写入字节和读取字节。 但是，该连接如何工作 以及如何建立的确切细节不在范围内。

在连接建立后，远程端必须运行 以下步骤：

1. 当while 该连接尚未 关闭时：

   1. 从连接读取字节，直到可以从数据构造出一个 完整的HTTP 请求。 令 request 为一个根据 [RFC7230] 的要求， 从接收到的数据构造出的请求。 如果无法构造完整的HTTP 请求， 则远程端必须关闭该连接， 或返回状态码为 500 的 HTTP 响应，或返回 一个错误，其错误 码为unknown error。

   2. 令 request match 为以 request 的 method 和 URL 作为参数， 运行匹配请求算法的结果。

   3. 如果 request match 的类型为错误， 则使用 request match 的 错误码 发送错误， 并continue。

      否则，令 command 和 URL variables 为 request match 的数据。

   4. 令 session 为 null。

   5. 如果 URL variables contains "session id"：

      注

      此条件旨在排除 新建 会话 和 状态 命令，以及任何不 操作特定 会话的扩展命令。

      1. 令 session id 为 URL variables["session id"]。

      2. 对于活动会话列表中的每个 active session：

         1. 如果 active session 的会话 ID等于 session id，则令 session 为 active session，并跳出循环。

      3. 如果 session 为null， 则使用错误码 invalid session id 发送错误， 然后continue。

   6. 将一个任务加入远程端的请求 队列，以运行以下 步骤：

      1. 如果 会话不再位于活动 会话列表中，则发送错误，其错误代码为 无效会话 ID，并返回。

      2. 令 parameters 为null。

      3. 如果 request 的method 是 POST：

         1. 令 parse result 为以 request 的 body 作为参数， 解析为 JSON的结果。如果此过程 抛出异常， 则返回一个错误，其错误码为 invalid argument，并跳回整个算法中的步骤 1。

         2. 如果 parse result 不是Object， 则使用错误码 invalid argument 发送错误 并跳回整个算法中的步骤 1。

            否则，令 parameters 为 parse result。

      4. 令 navigate result 为以 session 调用 等待 导航完成的结果。

      5. 如果 navigate result 是错误， 则使用等于 navigate result 的 错误 码的错误码 发送错误 并返回。

      6. 令 response result 为使用 session、URL variables 和 parameters 为 command 运行远程端 步骤 所获得的返回值。

      7. 如果 response result 是错误， 则使用等于 response result 的 错误码的错误码 发送错误 并返回。

      8. 断言：response result 是成功。

      9. 令 response data 为 response result 的 data。

      10. 以状态 200 和 response data 发送响应。

当被要求使用 error code 和可选的 error data 字典 发送 错误时， 远程端必须运行以下步骤：

1. 令 status 和 name 为 error code 对应的错误响应数据。

2. 令 message 为实现定义的字符串， 其中包含对错误原因的人类可读描述。

3. 令 stacktrace 为实现定义的字符串， 其中包含错误发生时活动栈帧的栈跟踪报告。

   令 body 为一个新的 JSON Object， 并用以下属性初始化：

   "error"

   name

   "message"

   message

   "stacktrace"

   stacktrace

4. 如果错误数据字典包含任何条目， 则将 body 上的 "data" 字段设置为 一个新的 JSON Object，并使用该字典填充。

5. 以 status 和 body 作为参数发送响应。

当被要求使用参数 status 和 data 发送响应时， 远程端必须运行以下步骤：

1. 令 response 为一个新的响应。

2. 将 response 的HTTP 状态设置为 status， 并将状态消息设置为在状态码 注册表中对应于 status 描述的字符串。

3. 使用以下值设置 response 的标头的 名称 和值：

   Content-Type

   "application/json; charset=utf-8"

   Cache-Control

   "no-cache"

4. 令 response 的body 为 一个 JSON Object 的 UTF-8 编码后的JSON 序列化结果， 该 Object 带有一个键 "value"，其值设置为 data。

5. 令 response bytes 为根据 [RFC7230] 中的规则 序列化 response 所得到的字节序列。

6. 将 response bytes 写入到连接。

请求路由 是从一个HTTP 请求 到实现该请求所表示的命令所需的一系列步骤的过程。

远程端具有关联的 URL 前缀， 它用作该远程端上 所有 WebDriver 定义的 URL 的前缀。 这必须是undefined 或路径绝对 URL。

为了在给定 method 和 URL 的情况下 匹配 请求， 必须采取以下步骤：

1. 令 endpoints 为一个列表， 包含端点表中的每一行。

2. 从 endpoints 中移除每个条目，如果 URL 前缀与该条目的URI 模板的串联没有一个有效展开等于 URL 的路径。

3. 如果 endpoints 中没有条目， 则返回错误，其错误码为 unknown command。

4. 移除 endpoints 中 method 列不等于 method 的每个条目。

5. 如果 endpoints 中没有条目， 则返回错误，其错误码为 unknown method。

6. 现在 endpoints 中恰好有一个条目； 令 entry 为该条目。

7. 令 URI template 为 URL 前缀与 entry 的 URI template 的串联。

8. 令 command 为 entry 的命令。

9. 令 URL variables 为一个map， 对于 URI template 中定义的每个变量都有一个 entry， 其条目名称等于模板变量名称， 条目值为将 URI template 展开以匹配 URL 的路径所需的变量值。

10. 返回成功，其数据为 command 和 URL variables。

以下端点表列出了 每个端点 节点命令的 method 和 URI 模板。扩展命令会隐式 附加到该表。

错误在 WebDriver 协议中表示为一个HTTP 响应，其HTTP 状态在 4xx 或 5xx 范围内， 并且 JSON 主体包含该错误的详细信息。 该主体是一个 JSON Object， 并且有一个名为 "value" 的字段， 其值是一个带有三个字段、有时带有四个字段的对象：

• "error"，包含一个指示错误码的字符串。
• "message"，包含一个实现定义的字符串， 对所发生错误的种类作出人类可读描述。
• "stacktrace"，包含一个实现定义的字符串， 其中包含错误发生时活动栈帧的栈跟踪报告。
• 可选的 "data"，它是一个 JSON Object， 带有有助于诊断错误的额外错误数据。

下表列出了每个错误码、 其关联的HTTP 状态、 JSON error 代码， 以及错误的非规范性描述。 特定错误码的 错误 响应数据 是与该错误码对应行中的 HTTP Status 和 JSON Error Code 列的值。

错误数据 字典 是字符串键到 JSON 可序列化值的映射， 可以可选地包含在错误对象中。

使用本节中定义的术语，其他人可以定义额外的 命令，以无缝集成到标准协议中。这允许 供应商公开其用户代理特有的功能，也 允许其他 Web 标准定义用于自动化新平台 特性的命令。

以这种方式定义的命令 称为扩展 命令， 且其行为与其他命令没有任何不同； 每个命令都有专用的 HTTP 端点和一组远程端步骤。

每个扩展命令具有关联的 扩展命令 URI 模板， 它是一个URI 模板字符串， 并且应当与该命令所执行的操作有一定相似性。 该值 连同 HTTP 方法和扩展命令 一起被添加到端点表， 因而遵循与其他内建命令相同的 请求路由规则。

为了避免与其他实现发生潜在的资源冲突， 供应商特定的扩展 命令 URI 模板必须以一个或多个 能唯一标识供应商和 UA 的路径片段开始。 建议供应商使用其供应商前缀， 不添加额外字符，如 [CSS21] 中所概述的那样， 尤其是关于 供应商关键字的第 4.1.2.2 节， 将其作为该路径元素的名称， 并包含供应商选择的 UA 标识符。

其他规范可以定义额外的 WebDriver 能力。每个定义的 能力都必须有一个能力名称， 它是不包含 ":"（冒号）字符的字符串； 以及一个额外能力反序列化 算法，它是一组步骤，接受一个 具有 JSON 类型的参数 value，并返回 封装反序列化能力值的成功， 或错误。

额外的 WebDriver 能力也可以 定义 匹配能力序列化算法， 它是一组步骤，用于确定某个能力是否由当前实现匹配， 并提供要返回给用户的任何计算值。 这组步骤接受一个参数 value， 该参数是对应额外 能力反序列化算法的输出， 并返回null 以表示该能力 未匹配，或者在该能力匹配时返回一个非 null 的 JSON 可序列化值。

其他规范也可以定义WebDriver 新会话算法，这些算法在创建新 会话之后、向远程端发送新会话响应之前被调用。 这些算法使用表示将要建立的 WebDriver 会话的 session， 以及将返回给远程端的能力对象 capabilities 进行调用。 允许此类算法修改能力对象中名称为 同一规范定义的额外 WebDriver 能力的任何条目。

远程端还可以引入 扩展能力， 它们是额外的能力， 用于提供配置或满足其他供应商特定需求。 扩展能力的键 必须包含 ":"（冒号）字符， 表示实现特定的命名空间。 该值可以是任意 JSON 类型。

与扩展命令一样， 建议用于表示扩展能力命名空间的键 基于 [CSS21] 中列出的 供应商关键字， 并且位于字符串中第一个 ":" 字符之前。

代理 配置能力 是嵌套在主要能力中的 JSON Object。 实现可以定义额外的代理配置选项， 但不得改变下列选项的语义。

用于 scheme 的主机和 可选端口 定义为有效的主机，可选地后跟一个冒号 和有效的端口。该主机可以 包含凭据。如果 省略端口且 scheme 具有默认端口， 则该端口为隐含端口。否则，端口保持未定义。

proxyType 为 "direct" 表示 浏览器完全不应使用代理。

proxyType 为 "system" 表示 浏览器应使用底层操作系统配置的各种代理。

proxyType 为 "autodetect" 表示应以实现特定的方式检测要使用的代理。

远程端将参数 parameter 反序列化为代理的步骤为：

1. 如果 parameter 不是 JSON Object，则返回 一个错误，其错误码为 invalid argument。

2. 令 proxy 为一个新的空 代理配置对象。

3. 对于 parameter 中的每个可枚举自身属性， 运行以下子步骤：

   1. 令 key 为属性的名称。

   2. 令 value 为从 parameter 获取 名为 name 的属性的结果。

   3. 如果代理配置表中 没有与 key 匹配的 key， 则返回一个错误， 其错误码为 invalid argument。

   4. 如果 value 不是该 key 的有效值之一，则返回 一个错误，其错误 码为 invalid argument。

   5. 在 proxy 上将属性 key 设置为 value。

4. 如果 proxy 没有 "proxyType" 的自身属性， 则返回一个错误，其错误 码为 invalid argument。

5. 如果从 proxy 获取 名为 "proxyType" 的属性的结果等于 "pac"，且 proxy 没有 "proxyAutoconfigUrl" 的自身属性， 则返回 一个错误，其错误码为 invalid argument。

6. 如果 proxy 具有 "socksProxy" 的自身属性， 但没有 "socksVersion" 的自身属性， 则返回一个错误，其错误 码为 invalid argument。

7. 返回成功，其数据为 proxy。

代理 配置对象是一个 JSON Object，其中每个匹配 代理配置中键的自身属性 都满足该键的有效性标准。

给定 parameters 和会话 配置标志 flags，为了处理 能力，端点节点 必须采取以下步骤：

1. 令 capabilities request 为从 parameters 获取 属性 "capabilities" 的结果。

   1. 如果 capabilities request 不是 JSON Object， 则返回错误，其错误 码为 invalid argument。

2. 令 required capabilities 为从 capabilities request 获取 属性 "alwaysMatch" 的结果。

   1. 如果 required capabilities 为undefined， 则将该值设为一个空 JSON Object。

   2. 令 required capabilities 为使用 required capabilities 和 flag 作为参数， trying 去验证能力的结果。

3. 令 all first match capabilities 为从 capabilities request 获取 属性 "firstMatch" 的结果。

   1. 如果 all first match capabilities 为undefined， 则将该值设为一个List，其中单个条目为空 JSON Object。

   2. 如果 all first match capabilities 不是一个包含 一个或多个条目的List，则返回错误， 其错误码为 invalid argument。

4. 令 validated first match capabilities 为空 List。

5. 对于 all first match capabilities 中 与索引属性对应的每个 first match capabilities：

   1. 令 validated capabilities 为使用 first match capabilities 和 flags 作为参数， trying 去验证能力的结果。

   2. 将 validated capabilities 追加到 validated first match capabilities。

6. 令 merged capabilities 为空 List。

7. 对于 validated first match capabilities 中 与索引属性对应的每个 first match capabilities：

   1. 令 merged 为以 required capabilities 和 first match capabilities 作为参数， trying 去合并 能力的结果。

   2. 将 merged 追加到 merged capabilities。

8. 对于 merged capabilities 中 与索引属性对应的每个 capabilities：

   1. 令 matched capabilities 为以 capabilities 作为 参数， trying 去匹配 能力的结果。

   2. 如果 matched capabilities 不是null， 则返回成功，其数据为 matched capabilities。

9. 返回成功，其数据为null。

当被要求使用参数 capabilities 验证能力时：

1. 如果 capabilities 不是 JSON Object，则返回 一个错误，其错误码为 invalid argument。

2. 令 result 为空 JSON Object。

3. 对于 capabilities 中的每个可枚举自身属性， 运行以下子步骤：

   1. 令 name 为属性的名称。

   2. 令 value 为从 capabilities 获取 名为 name 的属性的结果。

   3. 运行第一个匹配条件的子步骤：

      value 为null

      令 deserialized 被设置为null。

      name 等于 "acceptInsecureCerts"

      如果 value 不是boolean，则返回 一个错误，其错误码为 invalid argument。否则，令 deserialized 被设置为 value。

      name 等于 "browserName"

      name 等于 "browserVersion"

      name 等于 "platformName"

      如果 value 不是string，则返回 一个错误，其错误码为 invalid argument。否则，令 deserialized 被设置为 value。

      name 等于 "pageLoadStrategy"

      令 deserialized 为以 value 作为参数， trying 去 反序列化为页面 加载策略的结果。

      name 等于 "proxy"

      令 deserialized 为以 value 作为参数， trying 去反序列化 为代理的结果。

      name 等于 "strictFileInteractability"

      如果 value 不是boolean，则返回 一个错误，其错误码为 invalid argument。否则，令 deserialized 被设置为 value

      name 等于 "timeouts"

      令 deserialized 为使用 value， trying 去反序列化为 超时配置 的结果。

      name 等于 "unhandledPromptBehavior"

      令 deserialized 为以 value 作为参数， trying 去反序列化 为未处理提示行为的结果。

      name 是某个额外 WebDriver 能力的名称

      令 deserialized 为以 value 作为参数， trying 去运行与 name 对应的扩展能力的额外 能力反序列化 算法的结果。

      name 是某个扩展能力的键

      如果实现已知 name， 则令 deserialized 为以实现特定方式 trying 去反序列化 value 的结果。 否则，令 deserialized 被设置为 value。

      远程端是端点节点

      返回一个错误，其错误码为 invalid argument。

   4. 如果 deserialized 不是null， 则在 result 上以名称 name 和值 deserialized 设置属性。

4. 返回成功，其数据为 result。

当使用 JSON Object 参数 primary 和 secondary 合并 能力时， 端点节点必须采取以下步骤：

1. 令 result 为一个新的 JSON Object。

2. 对于 primary 中的每个可枚举自身属性， 运行以下子步骤：

   1. 令 name 为属性的名称。

   2. 令 value 为从 primary 获取 名为 name 的属性的结果。

   3. 在 result 上以名称 name 和值 value 设置属性。

3. 如果 secondary 为undefined， 则返回 result。

4. 对于 secondary 中的每个可枚举自身属性， 运行以下子步骤：

   1. 令 name 为属性的名称。

   2. 令 value 为从 secondary 获取 名为 name 的属性的结果。

   3. 令 primary value 为从 primary 获取属性 name 的结果。

   4. 如果 primary value 不是undefined， 则返回一个错误，其错误 码为 invalid argument。

   5. 在 result 上以名称 name 和值 value 设置属性。

5. 返回 result。

给定 JSON Object capabilities 和会话 配置标志 flags，当匹配能力时，端点节点 必须采取以下步骤：

1. 令 matched capabilities 为一个 JSON Object， 具有以下条目：

   "browserName"

   用户代理名称的 ASCII 小写形式，作为 string。

   "browserVersion"

   用户代理版本，作为string。

   "platformName"

   当前平台名称的 ASCII 小写形式，作为 string。

   "acceptInsecureCerts"

   Boolean，初始设置为 false， 表示会话不会在导航时 隐式信任不受信任的或自签名的 TLS 证书。

   "strictFileInteractability"

   Boolean，初始设置为 false， 表示会对 <input type=file> 应用可交互性检查。

   "setWindowRect"

   Boolean，指示远程端是否支持所有 调整大小和 定位命令。

   "userAgent"

   包含默认 User-Agent 值的 String。

2. 如果 flags 包含 "http"，则将 以下条目添加到 matched capabilities：

   "strictFileInteractability"

   Boolean，初始设置为 false， 表示会对 <input type=file> 应用可交互性检查。

3. 可选地将扩展能力作为条目 添加到 matched capabilities。这些值可以被 省略，并且不要求添加所有 扩展能力。

   注

4. 对于与 capabilities 的自身属性对应的 每个 name 和 value：

   1. 令 match value 等于 value。

   2. 运行第一个匹配 name 的子步骤：

      "browserName"

      如果 value 不是等于 matched capabilities 中 "browserName" 条目的 string， 则返回成功， 其数据为null。

      注

      有可能远程端需要 启动浏览器进程以正确确定 browserName。在执行此操作之前， 首选轻量级检查。

      "browserVersion"

      使用实现定义的比较算法，将 value 与 matched capabilities 中的 "browserVersion" 条目 进行比较。 该比较应接受使用 "<"、"<="、">" 和 ">=" 运算符对版本施加约束的 value。

      如果两个值不匹配， 则返回成功，其数据为null。

      注

      版本比较作为实现细节保留， 因为每个用户代理可能都有冲突的方法 来编码用户代理版本， 而标准化这些方案超出了本标准的范围。

      注

      有可能远程端需要 启动浏览器进程以正确确定 browserVersion。在执行此操作之前， 首选轻量级检查。

      "platformName"

      如果 value 不是等于 matched capabilities 中 "platformName" 条目的 string， 则返回成功，其数据为null。

      注

      以下平台名称在通常使用中具有 明确理解的语义，并且在为平台名称匹配 能力时， 将它们作为知名操作系统的有效同义词予以认可， 可以实现最大的互操作性：

      键	系统
      "linux"	任何基于 Linux 内核的服务器或桌面系统。
      "mac"	Apple 的 macOS 的任何版本。
      "windows"	Microsoft Windows 的任何版本，包括桌面版和 移动版。

      此列表并不详尽。

      从New Session返回能力时， 返回更具体的 platformName 是有效的， 以允许用户正确识别 WebDriver 实现正在运行的操作系统。

      "acceptInsecureCerts"

      如果accept insecure TLS 标志已设置 且不等于 value， 则返回成功， 其数据为null。

      注

      如果端点节点 不支持不安全的 TLS 证书，并且这是最终无法匹配的原因， 则向本地端 提供此信息是有用的。

      "proxy"

      如果has proxy configuration 标志已设置，或者 value 中定义的代理配置未通过端点节点的 实现特定有效性检查，则返回成功， 其数据为null。

      注

      本地端只有在期望该能力被认可并使用已配置代理时， 才会发送此能力。其意图是，如果无法做到这一点， 则不会建立新会话。

      "unhandledPromptBehavior"

      如果使用 value 调用 check user prompt handler matches 为 false，则返回成功， 其数据为null。

      否则

      • 如果 name 是定义了匹配 能力序列化算法的某个额外 WebDriver 能力的名称， 则令 match value 为使用 value 和 flags 作为参数， 为能力 name 运行匹配 能力序列化算法的结果。

      • 否则，如果 name 是某个 扩展能力的键， 则令 match value 为使用 value， trying 实现特定步骤来匹配 name 的结果。如果 匹配未成功，则返回成功， 其数据为null。

   3. 如果 match value 不是 null，则在 matched capabilities 上以名称 name 和 值 match value 设置属性。

5. 返回成功，其数据为 matched capabilities。

除了每会话状态之外，作为端点节点的远程端还具有跨所有会话全局的附加状态。

端点节点有关联的接受不安全 TLS标志，该标志指示是否将不受信任或自签名的 TLS 证书视为受信任。如果端点不支持接受不安全的 TLS 连接，则该标志的默认值为 false；否则为未设置。

端点节点有关联的已有代理 配置标志，该标志指示代理是否已经 配置。如果端点 不支持代理配置，则该标志的默认值为 true；否则为 false。

要在给定 JSON Object capabilites 和会话配置 标志 flags 时创建 会话：

1. 令 session id 为生成 UUID的结果。

2. 令 session 为一个新的会话，其会话 ID为 session id，且HTTP 标志为 flags 包含 "http"。

3. 令 proxy 为从 capabilities 获取属性 "proxy" 的结果，并运行第一个匹配语句的 子步骤：

   proxy 是一个代理配置 对象

   执行实现定义的步骤，使用提取的 proxy 配置设置用户代理代理。如果定义的代理无法配置，则返回错误，其 错误代码为session not created。否则 将已有代理配置标志设置为 true。

   否则

   设置 capabilities 的一个属性，其 名称为 "proxy"，值为一个新的 JSON Object。

4. 如果 capabilites 有一个名为 "acceptInsecureCerts" 的属性，则将端点 节点的接受不安全 TLS标志设置为从 capabilities 获取名为 "acceptInsecureCerts" 的属性的结果。

5. 令 user prompt handler capability 为从 capabilities 获取属性 "unhandledPromptBehavior" 的结果。

6. 如果 user prompt handler capability 不是 undefined，则使用 user prompt handler capability 更新用户 提示处理器。

7. 令 serialized user prompt handler 为序列化用户提示处理器的结果。

8. 在 capabilities 上设置一个属性，其名称为 "unhandledPromptBehavior"，值为 serialized user prompt handler。

9. 如果 flags contains "http"：

   1. 令 strategy 为从 capabilities 获取属性 "pageLoadStrategy" 的结果。

      如果 strategy 是 string，则将会话的页面加载 策略设置为 strategy。否则，将 页面加载策略设置为 normal， 并设置 capabilities 的一个属性，其名称为 "pageLoadStrategy"，值为 "normal"。

   2. 令 strictFileInteractability 为从 capabilities 获取属性 "strictFileInteractability" 的结果。如果 strictFileInteractability 是 boolean，则将会话的严格文件 可交互性设置为 strictFileInteractability。

   3. 令 timeouts 为从 capabilities 获取属性 "timeouts" 的结果。 如果 timeouts 不是 undefined，则将 session 的会话超时 设置为 timeouts。

   4. 在 capabilities 上设置一个属性，其名称为 "timeouts"，值为使用 session 的 会话超时序列化超时 配置的结果。

10. 以实现定义的方式处理 capabilities 中的任何扩展能力。

11. 使用参数 session、 capabilities 和 flags，运行外部规范中定义的任何WebDriver 新建会话算法。

12. 将 session 追加到活动会话。

13. 如果 flags 包含 "http"， 则将 session 追加到活动 HTTP 会话。

14. 将webdriver-active 标志设置为 true。

要在给定 session 时关闭 会话， 远程端必须执行以下步骤：

1. 如果设置了 session 的HTTP 标志， 则从活动 HTTP 会话中移除 session。

2. 从活动会话中移除 session。

3. 根据远程端的 类型执行以下子步骤：

   远程端是一个端点 节点

   1. 如果活动会话列表 为空：

      1. 将webdriver-active 标志 设置为 false

      2. 将用户 提示处理器设置为 null。

      3. 取消设置接受 不安全 TLS标志。

      4. 将已有 代理配置标志重置为其 默认值。

      5. 可选地，关闭所有顶级 浏览上下文， 且不提示卸载。

   远程端是一个中介节点

   1. 关闭关联会话。如果这导致 错误发生，则先完成此算法的其余部分， 然后返回该错误。

4. 执行任何实现特定的清理步骤。

5. 如果上述任何步骤中发生了错误， 则返回该错误，否则返回成功，其 数据为null。

关闭会话可能导致关联的浏览器进程被 终止。 假设任何实现特定的清理步骤都在响应已发回客户端 之后执行， 这样连接就不会过早关闭。

新建会话命令 会使用端点节点创建一个新的 WebDriver 会话。 如果创建失败，则返回session not created 错误。

如果远程端是中介 节点， 它可以使用能力处理 算法的结果， 将新会话请求路由到适当的端点节点。 中介节点可以自由定义扩展能力 来协助此过程；但是，这些特定能力 不得转发给端点节点。

如果中介节点需要与用户代理特性无关的额外信息， 建议将此信息作为顶层参数传递， 而不是作为请求的能力的一部分传递。 中介节点必须将自定义的 顶层参数（即非能力）转发给后续远程端节点。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果实现是端点节点，且 活动 HTTP 会话列表非空，或者 在其他情况下实现无法启动额外会话， 则返回错误，其错误码为 session not created。

2. 如果远程端是一个中介 节点，则执行 实现定义的步骤，其结果要么是返回一个错误，其错误代码为session not created， 要么是返回一个成功，其数据同构于 远程端根据本 算法其余部分返回的数据。如果未返回错误，则该中介 节点必须保留对在上游节点上创建的会话的引用，将其作为关联 会话，以便 在后续命令中可以将命令转发给此关联会话。

   注

   如何完成这一点完全取决于实现， 但通常需要跟踪 sessionId，以及 上游远程端的 URL 和 URL 前缀。

3. 令 flags 为包含 "http" 的 set。

4. 令 capabilities 为以 parameters 和 flags trying 去处理能力的结果。

5. 如果 capabilities 是null， 则返回错误，其错误码为 session not created。

6. 令 session 为使用 capabilities 和 flags 创建 会话的结果。

7. 令 body 为用以下内容初始化的 JSON Object：

   "sessionId"

   session 的会话 ID。

   "capabilities"

   capabilities

8. 将 session 的当前顶级 浏览 上下文设置为端点节点的顶级 浏览上下文之一，优先选择具有系统 焦点的顶级浏览 上下文， 或者否则优先选择任何其 可见性 状态 为visible的顶级浏览 上下文。

   注

   WebDriver 实现通常会启动一个 全新的浏览器实例，但本规范中没有要求 必须这样做（也没有要求 WebDriver 只能用于自动化 Web 浏览器）。实现可以选择使用已有的 浏览器实例，例如通过选择当前具有 焦点的窗口。

9. 将请求队列设置为新的queue。

10. 返回成功，其数据为 body。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 是活动 HTTP 会话， 则try 使用 session 关闭会话。

2. 返回成功，其数据为null。

实现可以可选地将 额外元信息作为主体的一部分包含进来， 但顶层属性 ready 和 message 是保留的，不得被覆盖。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 body 为一个新的 JSON Object， 具有以下属性：

   "ready"

   远程端的就绪状态。

   "message"

   一个实现定义的字符串， 解释远程端的就绪状态。

2. 返回成功，其数据为 body。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 timeouts 为使用会话的超时 配置序列化超时 配置的结果

2. 返回数据为 timeouts 的成功。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 timeouts 为使用 parameters trying 去 反序列化为超时 配置的结果。

2. 将 session 的超时配置 设置为 timeouts。

3. 返回成功，其数据为null。

如果远程端的接受不安全 TLS标志为 true，则通常会导致用户代理中止 并显示安全警告的证书错误，不应阻碍导航到请求的 地址。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 URL 为从 parameters 获取 名为 "url" 的属性的结果。

2. 如果 session 的当前顶级 浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

3. 如果 URL 不是绝对 URL， 或不是带片段的绝对 URL，或不是 本地 scheme，则返回错误，其错误 码为 invalid argument。

4. Try 使用 session 处理任何用户提示。

5. 令 timeout 为会话的会话 超时的页面加载超时。

6. 令 current URL 为 session 的当前 顶级浏览上下文的活动文档的URL。

7. 如果 current URL 和 URL 不具有相同的 绝对 URL，且 timeout 不为 null：

   1. 将 timer 设置为新的计时器。

   2. 使用 timer 和 timeout 启动计时器。

8. 运行这些步骤，但当 timer 的 abort when 超时触发标志被设置时中止：

   1. 将 session 的当前 顶级 浏览上下文导航到 URL。

   2. 如果 URL 为特殊 URL（file 除外），并且 current URL 与 URL 不具有相同的绝对 URL：

      1. Try 使用 session 和 timer 等待 导航完成。

      2. Try 运行导航后检查。

   3. 使用 session 和当前顶级浏览 上下文设置当前浏览 上下文。

   4. 当 session 的当前顶级浏览 上下文包含 time 为 1 秒 或更少的刷新状态 pragma 指令时， 运行以下步骤：

      1. 将 current URL 设置为 session 的 当前顶级 浏览上下文的活动 文档的URL。

      2. 等待刷新超时已经过去，并且 session 的当前顶级 浏览上下文的新导航已经开始。

      3. 将 URL 设置为 session 的 当前顶级 浏览上下文的活动 文档正在进行的导航的目标 URL。

      4. 如果 URL 为特殊 URL（file 除外），并且 current URL 与 URL 不具有相同的绝对 URL：

         1. Try 使用 session 和 timer 等待 导航完成。

         2. Try 运行导航后 检查。

9. 如果已中止，则返回一个错误，其错误 码为 timeout。

10. 返回成功，其数据为null。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 令 URL 为 session 的当前 顶级浏览上下文的 活动文档的URL的 序列化。

4. 返回成功，其数据为 URL。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 令 timeout 为 session 的会话 超时中的页面加载超时。

4. 令 timer 为一个新的计时器。

5. 如果 timeout 不为 null：

   1. 使用 timer 和 timeout 启动计时器。

6. 对于 session 的当前浏览 上下文，按 delta 遍历历史 –1。

7. 如果上一步完成导致 pageHide event firing，则等待 直到 pageShow event fires 或 timer 的超时触发标志被设置， 以先发生者为准。

8. 如果 timer 的超时触发标志已设置：

   1. 处理任何用户提示。

   2. 返回错误，其错误 码为 timeout。

9. 返回成功，其数据为null。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 令 timeout 为 session 的会话 超时中的页面加载超时。

4. 令 timer 为一个新的计时器。

5. 如果 timeout 不为 null：

   1. 使用 timer 和 timeout 启动计时器。

6. 对于 session 的当前浏览 上下文，按 delta 遍历历史 1。

7. 如果上一步完成导致 pageHide 事件触发，则等待直到 pageShow event fires 或 timer 的超时触发标志被设置， 以先发生者为准。

8. 如果 timer 的超时触发标志已设置：

   1. 处理任何用户提示。

   2. 返回错误，其错误 码为 timeout。

9. 返回成功，其数据为null。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 发起对 session 的当前 顶级浏览 上下文的活动文档的覆盖重载。

4. 如果 URL 为特殊 URL（file 除外）：

   1. Try 使用 session 等待导航 完成。

   2. Try 运行导航后检查。

5. 使用 session 和 session 的当前 顶级浏览上下文 设置当前浏览上下文。

6. 返回成功，其数据为null。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 令 title 为 session 的当前 顶级浏览 上下文的活动文档的title。

4. 返回成功，其数据为 title。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. 返回成功，其数据为与 session 的 当前顶级浏览 上下文关联的窗口句柄。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

2. Try 使用 session 处理任何用户提示。

3. 关闭 session 的当前 顶级 浏览上下文。

4. 如果不再有打开的顶级浏览上下文， 则try 去关闭会话。

5. 返回为 获取窗口句柄列表命令 运行远程端步骤的结果， 参数为 session、URL variables 和 parameters。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 handle 为从 parameters 获取属性 "handle" 的结果。

2. 如果 handle 为undefined， 则返回错误，其错误码为 invalid argument。

3. 如果存在活动的用户提示，它会阻止 聚焦另一个顶级浏览上下文， 则返回错误，其错误码为 unexpected alert open。

4. 如果 handle 等于某个顶级浏览上下文的关联窗口 句柄， 则令 context 为该浏览上下文，并使用 session 和 context 设置 当前顶级浏览上下文。

   否则，返回错误，其错误码为 no such window。

5. 更新任何由用户选择 session 的当前浏览上下文进行 交互而产生的实现特定状态，且不改变 OS 级焦点。

6. 返回成功，其数据为null。

窗口句柄返回的顺序是任意的。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 令 handles 为一个 List。

2. 对于远程端中的每个顶级浏览上下文， 将关联的窗口句柄推入 handles。

3. 返回成功，其数据为 handles。

创建新的顶级浏览上下文。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果实现不支持创建新的顶级 浏览上下文，则返回错误，其错误码为 unsupported operation。

2. 如果 session 的当前 顶级浏览 上下文不再打开，则返回错误， 其错误码为 no such window。

3. Try 使用 session 处理任何用户提示。

4. 令 type hint 为从 parameters 获取属性 "type" 的结果。

5. 通过运行 window open steps 创建新的顶级浏览上下文， 其中 URL 设置为 "about:blank"，target 设置为空 字符串，features 设置为 "noopener"，并且 用户代理被配置为创建新的浏览上下文。这必须 在不为所创建的浏览 上下文调用聚焦步骤的情况下完成。 如果 type hint 的值为 "tab"， 且实现支持在同一个 OS 窗口中存在多个浏览上下文， 则新的浏览上下文应与 session 的当前浏览 上下文共享一个 OS 窗口。如果 type hint 为 "window"，且实现支持在不同 OS 窗口中存在多个 浏览上下文，则所创建的浏览 上下文应位于新的 OS 窗口中。在所有其他情况下， 浏览上下文如何呈现给用户的细节都是 实现定义的。

6. 令 handle 为 新创建窗口的关联窗口句柄。

7. 如果新创建的窗口与 session 的当前浏览 上下文共享 OS 级窗口，则令 type 为 "tab"； 否则为 "window"。

8. 令 result 为一个新的 JSON Object，使用以下内容初始化：

   "handle"

   handle 的值。

   "type"

   type 的值。

9. 返回成功，其数据为 result。

1. 令 id 为从 parameters 获取属性 "id" 的结果。

2. 如果 id 不是null、 Number 对象， 或表示 web 元素的Object， 则返回错误，其错误码为 invalid argument。

3. 运行第一个匹配条件的子步骤：

   id 是null

   1. 如果 session 的当前顶级 浏览 上下文不再打开， 则返回错误， 其错误码为 no such window。

   2. Try 使用 session 处理任何用户提示。

   3. 使用 session 和 session 的当前 顶级浏览上下文 设置 当前浏览上下文。

   id 是 Number 对象

   1. 如果 id 小于 0 或大于 2¹⁶ – 1， 则返回错误，其错误码为 invalid argument。

   2. 如果 session 的当前浏览上下文 不再 打开，则返回错误，其错误码为 no such window。

   3. Try 使用 session 处理任何用户提示。

   4. 令 window 为 session 的当前浏览上下文的 活动文档的关联 窗口。

   5. 如果 id 不是 window 的支持的 属性索引， 则返回错误，其错误码为 no such frame。

   6. 令 child window 为通过调用 window.[[GetOwnProperty]] (id) 获得的WindowProxy 对象。

   7. 使用 session 和 child window 的浏览上下文 设置 当前浏览上下文。

   id 表示 web 元素

   1. 如果 session 的当前浏览上下文 不再 打开，则返回错误，其错误码为 no such window。

   2. Try 使用 session 处理任何用户提示。

   3. 令 element 为 使用 session 和 id trying 去获取已知元素 的结果。

   4. 如果 element 不是 frame 或 iframe 元素， 则返回错误，其错误码为 no such frame。

   5. 使用 session 和 element 的内容 navigable的活动 浏览上下文 设置 当前浏览上下文。

4. 更新任何由用户选择 session 的当前浏览上下文进行 交互而产生的实现特定状态，且不改变 OS 级焦点。

5. 返回成功，其数据为null。

给定 session、URL variables 和 parameters 时，远程端步骤为：

1. 如果 session 的当前浏览 上下文已经是 顶级浏览上下文：

   1. 如果 session 的当前浏览 上下文 不再打开，则返回错误，其错误 码为 no such window。

   2. 返回成功，其数据为null。

2. 如果 session 的当前父 浏览上下文 不再打开，则返回错误，其错误 码为 no such window。

3. Try 使用 session 处理任何用户提示。

4. 如果会话的当前父浏览上下文不是 null，则使用 session 和当前父 浏览上下文设置当前浏览上下文。

5. 更新任何由用户选择 session 的当前浏览上下文进行 交互而产生的实现特定状态，且不改变 OS 级焦点。

6. 返回成功，其数据为null。

WebDriver 提供命令， 用于与包含 session 的当前顶级 浏览上下文的操作系统窗口交互。 由于不同操作系统的窗口管理器提供不同的能力， 并非本节中的所有命令都能被所有远程端支持。 对这些命令的支持由窗口 尺寸调整/定位能力决定。 当某个命令不受支持时， 会返回unsupported operation 错误。

顶级浏览上下文 具有关联的窗口状态， 用于描述其 OS 小部件窗口处于何种可见性状态。 它可以处于以下状态之一：

如果出于任何原因，顶级浏览上下文的 OS 窗口无法进入任一窗口状态，或者此 概念不适用于当前系统，则默认状态 必须为 normal。

对于 WindowProxy window，WindowRect 对象是使用以下属性初始化的Object：

"x"

window 的screenX 属性。

"y"

window 的screenY 属性。

"width"

windows 的outerWidth 属性。

"height"

window 的outerHeight 属性。

给定一个具有关联顶级浏览上下文的操作系统级窗口， 为了最大化 窗口， 运行实现特定步骤， 将该操作系统级窗口转换到最大化窗口状态。 如果窗口管理器支持调整窗口大小， 但没有窗口最大化概念， 则窗口尺寸必须增加到 窗口管理器允许的当前屏幕的 最大可用大小。 当窗口完成转换时返回， 或在实现定义的超时时间内返回。

给定一个具有关联顶级浏览上下文的操作系统级窗口， 为了图标化 窗口， 运行实现特定步骤， 将该操作系统级窗口转换到最小化窗口状态。 在顶级浏览上下文的活动文档的可见性状态 达到hidden 状态之前， 或操作超时之前，不要从此操作返回。

给定一个具有关联顶级浏览上下文的操作系统级窗口， 为了恢复 窗口， 运行实现特定步骤， 将窗口恢复或取消隐藏到 可见屏幕。 在顶级浏览上下文的活动文档的可见性状态 达到visible 状态之前， 或操作超时之前，不要从此操作返回。

为了确定一个元素 是否可以使用指针操作与之交互， WebDriver 会执行命中测试以找出 该交互是否能够到达所请求的元素。

可交互元素 是一个元素，它要么是 指针可交互，要么是键盘可交互。

指针可交互元素 定义为在其矩形中位于视口内部的中心点处， 按绘制顺序找到的第一个元素， 不包括任何已渲染滚动条的尺寸。

键盘可交互元素 是任何具有可聚焦区域的元素， 或者是 body 元素， 或者是文档元素。

元素的视图内中心 点 是以下矩形的原点位置： 该矩形是元素第一个由 getClientRects() 返回的DOMRect 与初始视口之间的交集。 它可以按如下方式计算：

1. 令 rectangle 为 在element 上调用 getClientRects() 返回的 DOMRect 集合中的第一个对象。

2. 令 left 为 max(0, min(x 坐标, x 坐标 + 宽度 维度))。

3. 令 right 为 min(innerWidth, max(x 坐标, x 坐标 + 宽度 维度))。

4. 令 top 为 max(0, min(y 坐标, y 坐标 + 高度 维度))。

5. 令 bottom 为 min(innerHeight, max(y 坐标, y 坐标 + 高度 维度))。

6. 令 x 为 floor((left + right) ÷ 2.0)。

7. 令 y 为 floor((top + bottom) ÷ 2.0)。

8. 返回 (x, y) 对。

如果以下步骤返回 true，则元素 element 是禁用的：

1. 如果 element 是 option 元素，或 element 是 optgroup 元素：

   1. 对于 element 的每个包含祖先 ancestor：

      1. 如果 ancestor 是 optgroup 元素，或 ancestor 是 select 元素，并且 ancestor 实际禁用，则返回 true。

   2. 返回 false。

2. 返回 element 实际禁用。

如果一个元素是其自身指针可交互绘制 树的成员， 并假定其指针事件未被 禁用， 则该元素在视图中。

如果一个元素在其中心点处的 指针可交互绘制树 为空， 或者此树中的第一个元素 不是其自身的包含后代，则该元素被遮挡。

元素 element 的 指针可交互绘制树 按以下方式生成：

1. 如果 element 与 session 的当前浏览 上下文的 活动文档不在同一树中， 则返回一个空序列。

2. 令 rectangles 为 在 element 上调用 getClientRects() 所返回的 DOMRect 序列。

3. 如果 rectangles 的长度为 0， 则返回一个空序列。

4. 令 center point 为 element 的视口内中心点。

5. 给定坐标 center point，返回点处的元素。

shadow root 是一种抽象，用于在通过协议、 在远程端与本地端之间传输时， 标识一个shadow root。

shadow root 标识符是字符串常量 "shadow-6066-11e4-a52e-4f735466cecf"。

如果 ECMAScript Object 具有一个shadow root 标识符自身属性， 则该对象表示 shadow root。

为了给定 session 和 reference 来获取 已知 shadow root：

1. 如果在 session、 session 的当前浏览上下文 和 reference 下节点引用是已知的不成立，则返回 错误， 其错误码为 no such shadow root。
2. 令 node 为使用 session、session 的当前浏览 上下文和 reference 获取节点的结果。
3. 如果 node 不为 null，且 node 未实现 ShadowRoot，则返回错误， 其错误码为 no such shadow root。
4. 如果 node 为 null，或 node 已分离，则返回 错误， 其错误码为 detached shadow root。
5. 返回成功，其数据为 node。

为了给定 session 和 shadow root 来获取或创建 shadow root 引用：

1. 断言：element 实现了 ShadowRoot。
2. 返回 使用 session、session 的当前 浏览上下文和 element trying 去获取 或创建节点 引用的结果。

session 和 shadow root 的shadow root 引用对象由以下给出：

1. 令 identifier 为shadow root 标识符。

2. 令 reference 为使用 session 和 shadow root 获取或创建 shadow root 引用的结果。

3. 返回一个 JSON Object，该对象以一个属性初始化， 其名称为 identifier，值为 reference。

当要求通过一个 JSON Object object 来反序列化 shadow root， 该 object 表示 shadow root：

1. 如果 object 没有自身属性shadow root 标识符， 则返回错误，其错误码为 invalid argument。

2. 令 reference 为从 object 获取 shadow root 标识符属性 的结果。

3. 如果 reference 不是 String， 则返回一个错误，其错误码为 invalid argument。

4. 令 shadow 为 使用 session 和 reference trying 去获取 已知 shadow root 的结果。

5. 返回成功，其数据为 shadow。

如果一个shadow root的 节点文档不是活动文档， 或者称为其宿主的元素节点 已 过时，则该 shadow root 已分离。

查找元素、 查找元素列表、 从元素查找元素、 从元素查找元素列表、 从 Shadow Root 查找元素， 以及从 Shadow Root 查找元素列表命令 允许查找单个元素和元素集合。 元素检索搜索会使用文档节点的 先序遍历来执行， 匹配所提供选择器的表达式。

当要求给定 session、start node、using 和 value 来查找时，远程 端必须运行以下步骤：

1. 令 location strategy 等于 using。

2. 令 selector 等于 value。

3. 令 timeout 为 session 的 会话超时的隐式等待超时。

4. 令 timer 为一个新的计时器。

5. 如果 timeout 不为 null：

   1. 使用 timer 和 timeout 启动计时器。

6. 令 elements returned 为空List。

7. 当 elements returned 为空 且 timer 的timeout fired flag未 设置时：

   1. 将 elements returned 设置为使用参数 start node 和 selector trying 调用 相关元素定位策略的结果。

   2. 如果在执行元素定位策略期间出现 DOMException、SyntaxError、 XPathException，或其他错误， 则返回错误 invalid selector。

8. 令 result 为空List。

9. 对于 elements returned 中的每个 element， 将 session 和 element 的web 元素引用对象 追加到 result。

10. 返回成功，其数据为 result。

为了给定 session 和 element 来计算绝对位置：

1. 令 rect 为调用 getBoundingClientRect() 返回的值。

2. 令 window 为 session 的当前 顶级浏览上下文的关联窗口。

3. 令 x 为 （window 的 scrollX + rect 的x 坐标）。

4. 令 y 为 （window 的 scrollY + rect 的y 坐标）。

5. 返回 (x, y) 对。

为了确定节点是否与另一个节点 other 不在同一树中， 运行以下子步骤：

1. 如果该节点的节点文档 不是 other 的节点文档， 则返回 true。

2. 如果以 other 作为参数调用该节点的 compareDocumentPosition() 的结果是 DOCUMENT_POSITION_DISCONNECTED (1)， 则返回 true，否则返回 false。

element 的容器是：

处于有效元素上下文中的 option 元素

处于有效元素上下文中的 optgroup 元素

该element 的元素 上下文， 它由以下方式确定：

1. 令 datalist parent 为 从 element 反向遍历树时到达的第一个 datalist 元素； 如果到达树的根，则为undefined。

2. 令 select parent 为 从 element 反向遍历树时到达的第一个 select 元素； 如果到达树的根，则为undefined。

3. 如果 datalist parent 是undefined， 则元素上下文为 select parent。 否则，元素上下文为 datalist parent。

处于无效元素上下文中的 option 元素

该元素没有容器。

否则

容器是该元素本身。

元素交互命令 提供了一组用于操作表单控件的高级指令集。 不同于操作， 它们会隐式地将元素滚动到视图中， 并检查它是一个可交互元素。

某些可重置元素定义了自己的清除 算法。 不同于其关联的重置算法， 作为这些算法的一部分对表单控件所做的更改 确实计为由用户导致的更改 （因此，例如确实会导致 input 事件触发）。 当为没有定义自己的清除算法的元素调用清除算法时， 必须改为调用其重置算法。

input 元素的清除算法 是将脏值标志和脏选中性 标志恢复为 false， 将元素的值 设置为空字符串， 如果元素具有 checked 内容属性，则将元素的选中性设置为 true， 如果没有则设置为 false， 清空选定文件列表， 然后当且仅当 type 属性的当前状态定义了一个值清理算法时调用它。

textarea 元素的清除算法 是将脏值标志恢复为 false， 并将元素的原始值设置为空字符串。

output 元素的清除算法 是将元素的值模式标志设置为 default， 然后将元素的 textContent IDL 属性 设置为空字符串（从而清除元素的子节点）。