WebUSB API

1. 令 global 为 this 的 相关全局对象。

2. 令 document 为 global 的 关联文档，如无就为 null。

3. 令 storage 为：

   1. 如 global 是 ServiceWorkerGlobalScope，则为其脚本执行环境中的 USBPermissionStorage 对象；

   2. 否则为当前脚本环境的 USBPermissionStorage 对象。

4. 令 promise 为新 promise。

5. 并行执行以下步骤：

   1. 枚举所有系统已连接设备。记为 enumerationResult。

   2. 令 devices 为一个新空 Array。

   3. 遍历 enumerationResult，对每个 device：

      1. 若 device 对 document 被屏蔽，则 继续。

      2. 如果本方法为首次被调用，检查 device 的权限，用 storage。

      3. 在 storage.allowedDevices 找到元素 allowedDevice，device 位于 allowedDevice.[[devices]]。 如未找到，继续下一个 device。

   4. 将代表 device 的 USBDevice 对象加入 devices。

   5. グローバルタスクをキューに追加 する（global で USB タスクソースを指定）、promise を resolve（解決）し、devices で完了させる。

6. 返回 promise。

1. 请求使用如下描述符的权限，

   {
     name: "usb"
     filters: options.filters
     exclusionFilters: options.exclusionFilters
   }
   

   令 permissionResult 为生成的 Promise。

2. 当 permissionResult 被满足时，带有 result ，执行以下步骤：

   1. 如果 result.devices 为空，抛出 "NotFoundError" DOMException 并中止后续步骤。

   2. 返回 result.devices[0]。

1. 令 global 为 storage 的 相关全局对象。

2. 遍历 options.filters， 如果其中某个 filter 不是有效过滤器，返回 一个被拒 promise，原因是 TypeError。

3. 遍历options.exclusionFilters， 如果其中某个 exclusionFilter 不是有效过滤器，返回被拒 promise，原因是 TypeError。

4. 检查算法是否在 global 具备临时激活时触发。否则返回 被拒的 promise，报 SecurityError DOMException。

5. 令 promise 为新 promise。

6. 并行执行以下步骤。

   1. 枚举系统所有已连接设备。令该结果为enumerationResult。

   2. 如果 enumerationResult 中的设备对 document 在阻止列表中，则移除该设备。

   3. 如果 enumerationResult 中的设备不 匹配过滤器（options.filters）中的过滤条件，则移除该设备。

   4. 如果 enumerationResult 中的设备 匹配过滤器（options.exclusionFilters）中的过滤条件，则移除该设备。

   5. 向用户显示设备选择弹窗，请用户从 enumerationResult 中选择设备。UA 应为每个设备显示易于理解的名称。

   6. 等待用户选择了某个 device 或取消了弹窗。

   7. 在 USB 任务源 USB task source 上，为 global 排队全局任务，执行下列步骤：

      1. 将 status.state 赋值为 "ask"。

      2. 如果用户取消弹窗，则将 status.devices 赋值为空的 FrozenArray， resolve promise，返回 undefined，并终止后续步骤。

      3. 将 device 添加到 storage。

      4. 令 deviceObj 为表示 device 的 USBDevice 对象。

      5. 将 status.devices 赋值为包含 deviceObj 的新 FrozenArray。

      6. resolve promise，返回 undefined。

7. 返回 promise。

1. 令 deviceDescriptor 为通过执行 Get Descriptor（将 DescriptorType 设置为 DEVICE）而得到的已连接设备的 device descriptor。

2. 返回 deviceDescriptor。

1. 令 deviceDescriptor 为执行 获取已连接 USB 设备的设备描述符 的结果。

2. 令 numConfigurations 为 deviceDescriptor 的 bNumConfigurations 值。

3. 令 configurationIndex 为 0。

4. 令 configurationDescriptors 为一个 空 的 列表。

5. 当 configurationIndex 小于 numConfigurations 时：

   1. 令 descriptors 为通过执行 Get Descriptor（将 DescriptorType 设置为 CONFIGURATION，并将 DescriptorIndex 设为 configurationIndex）得到的描述符列表。

   2. 如果 descriptors[0] 的 bDescriptorType 等于 CONFIGURATION，则将 descriptors[0] 追加 到 configurationDescriptors。

   3. 将 configurationIndex 加 1。

6. 返回 configurationDescriptors。

1. 令 global 为 interface 的 相关全局对象。

2. 令 configuration 为 interface.[[configuration]]。

3. 令 device 为 configuration.[[device]]。

4. 如果 configuration 与 使用 device 执行 查找当前配置 得到的结果不同，则返回。

5. 如果 使用 interface 执行 查找接口是否被声明（claimed） 的结果不为 true，则返回。

6. 令 currAlternateInterface 为 使用 interface 执行 查找当前 alternate setting 的 alternate interface 的结果。

7. 对每个 endpoint 属于 currAlternateInterface.[[endpoints]] 执行：

   1. 中止在 endpoint 上当前排定的所有传输。

   2. 在给定 global 的 USB task source 上 排队一个全局任务，以便 拒绝 相关的 promise，并以 "AbortError" DOMException 作为原因。

1. 令 interfaceIndex 为 0。

2. 当 interfaceIndex 小于 configuration.[[interfaces]] 的 大小 时：

   1. 如果 configuration.[[interfaces]][interfaceIndex].[[interfaceNumber]] 等于 interfaceNumber，则返回 interfaceIndex。

   2. 将 interfaceIndex 加 1。

3. 返回 -1。

1. 令 alternateIndex 为 0。

2. 当 alternateIndex 小于 interface.[[alternates]] 的 大小 时：

   1. 如果 interface.[[alternates]][alternateIndex].[[alternateSetting]] 等于 alternateSetting，则返回 alternateIndex。

   2. 将 alternateIndex 加 1。

3. 返回 -1。

1. 对每个 configuration 属于 device.[[configurations]] 执行：

   1. 如果 configuration.[[configurationValue]] 等于 device.[[configurationValue]]， 则返回 configuration。

2. 返回 null。

1. 令 configuration 为 使用 device 执行 查找当前配置 的结果。

2. 如果 configuration 为 null，则返回 null。

3. 对每个 interface 属于 configuration.[[interfaces]] 执行：

   1. 如果 使用 interface 执行 查找接口是否被声明（claimed） 的结果不为 true，则继续下一个 interface。

   2. 令 alternate 为 使用 interface 执行 查找当前 alternate setting 的 alternate interface 的结果。

   3. 对每个 endpoint 属于 alternate.[[endpoints]] 执行：

      1. 如果 endpoint.[[endpointAddress]] 等于 endpointAddress，则返回 endpoint。

4. 返回 null。

1. 如果 device 已不再连接到系统，返回 一个被拒的 promise，原因是 "NotFoundError" DOMException。

2. 如果 device.opened 不为 true，返回 一个被拒的 promise，原因是 "InvalidStateError" DOMException。

3. 如果 device.[[configurationValue]] 等于 0，返回 一个被拒的 promise，原因是 "InvalidStateError" DOMException。

4. 返回 undefined。

1. 将 this.[[configurationValue]] 设置为执行 Get Configuration 返回的值。

2. 令 configurationDescriptors 为 执行 查找已连接 USB 设备的配置描述符列表 的结果。

3. 对每个 configurationDescriptor 属于 configurationDescriptors 执行：

   1. 令 configuration 为 使用 new 创建的 USBConfiguration 对象，调用形式为 USBConfiguration(device, configurationValue)，其中 device 设置为 this，且 configurationValue 为 configurationDescriptor 的 bConfigurationValue。

   2. 将 configuration 追加 到 this.[[configurations]]。

   3. 如果 bConfigurationValue 等于 this.[[configurationValue]]：

      1. 令 numInterfaces 为 configuration.[[interfaces]] 的 大小。

      2. 将 this.[[selectedAlternateSetting]] 调整大小为 numInterfaces。

      3. 将 this.[[selectedAlternateSetting]] 填充为 0。

      4. 将 this.[[claimedInterface]] 调整大小为 numInterfaces。

      5. 将 this.[[claimedInterface]] 填充为 false。

1. 令 global 为 this 的 相关全局对象。

2. 如果 this 已不再连接到系统，则返回 一个被拒绝的 promise，原因是 "NotFoundError" DOMException。

3. 如果 this.opened 为 true，则返回 一个已解决的 promise，值为 undefined。

4. 并行 执行以下步骤。

   1. 执行必要的平台特定步骤以开始与设备的会话。

   2. 在给定 global 的 USB 任务源 上排队一个全局任务以运行以下步骤：

      1. 如果上述平台特定步骤因任何原因失败，则 拒绝 promise，原因是 "NetworkError" DOMException 并中止这些步骤。

      2. 将 this.opened 设置为 true。

      3. 解析 promise，值为 undefined。

5. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果 this 已不再连接到系统，则返回 一个被拒绝的 promise，原因是 "NotFoundError" DOMException。

3. 如果 this.opened 为 false，则返回 一个已解决的 promise，值为 undefined。

4. 中止当前针对该设备正在运行的所有其他算法，并拒绝它们关联的 promise，并抛出一个 "AbortError" DOMException。

5. 并行 执行以下步骤。

   1. 执行必要的平台特定步骤以释放所有被声明的接口，就像对每个被声明的接口调用了 releaseInterface(interfaceNumber) 一样。

   2. 执行必要的平台特定步骤以结束与设备的会话。

   3. 在给定 global 的 USB 任务源 上排队一个全局任务以运行以下步骤：

      1. 将 this.opened 设为 false。

      2. 解析 promise，值为 undefined。

6. 返回 promise。

注： 当没有任何 [ECMAScript] 代码可以再观察到某个 USBDevice 实例 device 时，UA 应当调用 device.close()（建议）。

1. 令 device 为 this。

2. 令 storage 为当前脚本执行环境中的 USBPermissionStorage 对象。

3. 使用 storage 执行 从存储中移除 device。

4. 返回 一个已解决的 promise，值为 undefined。

注： 用户代理可以决定跨 API 合并权限，例如将 WebHID 与 WebUSB 的设备访问跟踪为统一的低级设备访问权限。因此，未来该方法也可能撤销额外的（目前未指定的）权限。

1. 令 global 为 this 的 相关全局对象。

2. 如果 this 已不再连接到系统，则返回 一个被拒绝的 promise，原因是 "NotFoundError" DOMException。

3. 令 selectedConfiguration 为 null。

4. 遍历 this.[[configurations]] 的每个 configuration：

   1. 如果 configuration.[[configurationValue]] 等于 configurationValue，则将 selectedConfiguration 设为该 configuration 并跳出循环。

5. 如果 selectedConfiguration 仍为 null，则返回 一个被拒绝的 promise，原因是 "NotFoundError" DOMException。

6. 如果 this.opened 不等于 true，则返回 一个被拒绝的 promise，原因是 "InvalidStateError" DOMException。

7. 令 activeConfiguration 为使用 查找当前配置 并以 this 作为参数的结果。

8. 并行 执行以下步骤。

   1. 如果 activeConfiguration 不为 null：

      1. 遍历 activeConfiguration.[[interfaces]] 的每个 interface，对其执行 中止该接口上当前排定的传输。

   2. 发出一个 SET_CONFIGURATION 的 控制传输，其 configurationValue 设置为 configurationValue。

   3. 在给定 global 的 USB 任务源 上排队一个全局任务以运行以下步骤：

      1. 如果上述 控制传输 失败，则 拒绝 promise，原因是 "NetworkError" DOMException 并中止这些步骤。

      2. 令 numInterfaces 为 selectedConfiguration.[[interfaces]] 的 大小。

      3. 将 this.[[selectedAlternateSetting]] 调整大小为 numInterfaces。

      4. 将 this.[[selectedAlternateSetting]] 填充为 0。

      5. 将 this.[[claimedInterface]] 调整大小为 numInterfaces。

      6. 将 this.[[claimedInterface]] 填充为 false。

      7. 将 this.[[configurationValue]] 设为 configurationValue。

      8. 解析 promise，值为 undefined。

9. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果 使用 检查设备是否已配置 并以 this 为参数 的结果是一个 Promise，则返回该值。

3. 令 activeConfiguration 为使用 查找当前配置 并以 this 为参数 的结果。

4. 令 interfaces 为 activeConfiguration.[[interfaces]]。

5. 令 interfaceIndex 为 使用 查找接口索引（以 interfaceNumber 与 activeConfiguration 为参数）的结果。

6. 如果 interfaceIndex 等于 -1，则返回 一个被拒绝的 promise，原因是 "NotFoundError" DOMException。

7. 如果 this.[[claimedInterface]][interfaceIndex] 为 true，则返回 一个已解决的 promise，值为 undefined。

8. 令 unrestricted 为 false。

9. 令 document 为 global 的 关联 Document，如果不存在则为 null。

10. 如果 document 不为 null 且 document 被允许使用 名为 "usb-unrestricted" 的 策略控制特性，则将 unrestricted 设为 true。

11. 如果 interfaces[interfaceIndex].[[isProtectedClass]] 为 true 且 unrestricted 为 false，则返回 一个被拒绝的 promise，原因是 "SecurityError" DOMException。

12. 令 promise 为 一个新 promise。

13. 并行 执行以下步骤。

    1. 执行必要的平台特定步骤以请求将 interfaces[interfaceIndex] 的独占控制权赋予当前执行上下文。

    2. 在给定 global 的 USB 任务源 上排队一个全局任务以运行以下步骤：

       1. 如果上述平台特定步骤失败，则 拒绝 promise，原因是 "NetworkError" DOMException 并中止这些步骤。

       2. 将 this.[[claimedInterface]][interfaceIndex] 设为 true。

       3. 解析 promise，值为 undefined。

14. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise，则返回该值。

3. 令 activeConfiguration 为使用 查找当前配置 与 this 的结果。

4. 令 interfaces 为 activeConfiguration.[[interfaces]]。

5. 令 interfaceIndex 为用 查找接口索引，输入为 interfaceNumber 和 activeConfiguration 的结果。

6. 如果 interfaceIndex 等于 -1，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

7. 如果 this.[[claimedInterface]][interfaceIndex] 为 false， 则返回 一个以解决状态完成的 promise，其值为 undefined。

8. 令 promise 为 一个新的 promise。

9. 并行运行以下步骤。

   1. 执行必要的平台特定步骤，以放弃对 interfaces[interfaceIndex] 的独占控制。

   2. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 将 this.[[selectedAlternateSetting]][interfaceIndex] 设为 0。

      2. 将 this.[[claimedInterface]][interfaceIndex] 设为 false。

      3. 将 promise 解析为 undefined。

10. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 activeConfiguration 为使用 查找当前配置 与 this 的结果。

4. 令 interfaces 为 activeConfiguration.[[interfaces]]。

5. 令 interfaceIndex 为用 查找接口索引，输入为 interfaceNumber 和 activeConfiguration 的结果。

6. 如果 interfaceIndex 等于 -1，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

7. 如果 this.[[claimedInterface]][interfaceIndex] 为 false， 则返回 一个以拒绝状态完成的 promise，其拒因为 "InvalidStateError" DOMException。

8. 令 interface 为 interfaces[interfaceIndex]。

9. 令 alternateIndex 为用 查找备选设置索引，输入为 alternateSetting 和 interface 的结果。

10. 如果 alternateIndex 等于 -1，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

11. 令 promise 为 一个新的 promise。

12. 并行运行以下步骤。

    1. 用 interface 中止当前已调度在某接口上的传输。

    2. 发出一个 SET_INTERFACE 控制传输，其中 interfaceNumber 设为 interfaceNumber， alternateSetting 设为 alternateSetting。

    3. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

       1. 如果上述 控制传输失败，则拒绝 promise，拒因为 "NetworkError" DOMException， 并中止这些步骤。

       2. 将 this.[[selectedAlternateSetting]][interfaceIndex] 设为 alternateSetting。

       3. 将 promise 解析为 undefined。

13. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 如果用 检查控制传输参数的有效性，输入为 this 和 setup，返回一个 Promise， 则返回该值。

4. 令 promise 为 一个新的 promise。

5. 并行运行以下步骤。

   1. 如果 length 大于 0，令 buffer 为一个具有 length 字节空间的主机缓冲区。

   2. 向 this 发起一次 控制传输，其 设置包 参数来自 setup，并将 bmRequestType 中的数据传输方向设为 “device to host”，将 wLength 设为 length。 如已定义，还应提供 buffer 作为接收此传输响应数据的写入目标。

   3. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 bytesTransferred 为写入 buffer 的字节数。

      2. 令 result 为 新的 USBInTransferResult。

      3. 如果从设备接收到数据，则创建一个 新的 ArrayBuffer， 其包含 buffer 的前 bytesTransferred 个字节，并将 result.data 设为在其之上构建的一个 新的 DataView。

      4. 将 result.status 设为：

         • "stall"， 如果设备通过停止 默认控制管道进行响应。

         • "babble"， 如果设备响应的数据多于 length 字节。

         • "ok"， 否则。

      5. 如果传输因其他任何原因失败，则拒绝 promise，拒因为 "NetworkError"， 并中止这些步骤。

      6. 将 promise 解析为 result。

6. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 如果用 检查控制传输参数的有效性，输入为 this 和 setup，返回一个 Promise， 则返回该值。

4. 获取缓冲区源 data 的一份拷贝，并令结果为 bytes。

5. 令 promise 为 一个新的 promise。

6. 并行运行以下步骤。

   1. 向 控制传输 的目标 this 发起传输，其 设置包 参数来自 setup，将 bmRequestType 中的数据传输方向设为 “host to device”，并将 wLength 设为 bytes 的长度。

   2. 在传输的 数据阶段 发送 bytes。

   3. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 result 为 新的 USBOutTransferResult。

      2. 将 result.status 设为：

         • "stall"， 如果设备通过停止 默认控制管道进行响应。

         • "ok"， 否则，并将 result.bytesWritten 设为 bytes 的长度。

      3. 如果传输因其他任何原因失败，则拒绝 promise， 拒因为 "NetworkError" DOMException， 并中止这些步骤。

      4. 将 promise 解析为 result。

7. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 endpointAddress 为 endpointNumber | 0x80，如果 direction 等于 "in"， 否则为 endpointNumber。

4. 令 endpoint 为用 查找端点，输入为 endpointAddress 和 this 的结果。

5. 如果 endpoint 为 null，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

6. 令 promise 为 一个新的 promise。

7. 并行运行以下步骤。

   1. 向设备发出 ClearFeature(ENDPOINT_HALT) 控制传输 以清除 endpoint 上的停滞状态。

   2. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 如果上述 控制传输 失败，则拒绝 promise， 拒因为 "NetworkError" DOMException， 并中止这些步骤。

      2. 将 promise 解析为 undefined。

8. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 endpointAddress 为 endpointNumber | 0x80（即 "in" 方向）。

4. 令 endpoint 为用 查找端点，输入为 endpointAddress 和 this 的结果。

5. 如果 endpoint 为 null，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

6. 如果 endpoint.type 不等于 "bulk" 或 "interrupt"， 则返回 一个以拒绝状态完成的 promise，其拒因为 "InvalidAccessError" DOMException。

7. 令 promise 为 一个新的 promise。

8. 并行运行以下步骤。

   1. 令 buffer 为一个具有 length 字节空间的主机缓冲区。

   2. 视 endpoint 的类型，执行 批量 或 中断 IN 传输 于 endpoint 上，从设备接收 length 字节数据到 buffer。

   3. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 bytesTransferred 为写入 buffer 的字节数。

      2. 令 result 为 新的 USBInTransferResult。

      3. 如果从设备接收到数据，则创建一个 新的 ArrayBuffer， 其包含 buffer 的前 bytesTransferred 个字节，并将 result.data 设为在其之上构建的一个 新的 DataView。

      4. 将 result.status 设为：

         • "stall"， 如果设备通过停止 endpoint 进行响应。

         • "babble"， 如果设备响应的数据多于 length 字节。

         • "ok"， 否则。

      5. 如果传输因其他任何原因失败，则拒绝 promise，拒因为 "NetworkError" DOMException， 并中止这些步骤。

      6. 将 promise 解析为 result。

9. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 endpointAddress 为 endpointNumber（即 "out" 方向）。

4. 令 endpoint 为用 查找端点，输入为 endpointAddress 和 this 的结果。

5. 如果 endpoint 为 null，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

6. 如果 endpoint.type 不等于 "bulk" 或 "interrupt"， 则返回 一个以拒绝状态完成的 promise，其拒因为 "InvalidAccessError" DOMException。

7. 获取缓冲区源 data 的一份拷贝，并令结果为 bytes。

8. 令 promise 为 一个新的 promise。

9. 并行运行以下步骤。

   1. 视 endpoint 的类型，执行 批量 或 中断 OUT 传输 于 endpoint 上，将 bytes 发送到设备。

   2. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 result 为 新的 USBOutTransferResult。

      2. 将 result.bytesWritten 设为成功发送到设备的数据量。

      3. 将 result.status 设为：

         • "stall"， 如果设备通过停止 endpoint 进行响应。

         • "ok"， 否则。

      4. 如果传输因其他任何原因失败，则拒绝 promise，拒因为 "NetworkError" DOMException， 并中止这些步骤。

      5. 将 promise 解析为 result。

10. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 endpointAddress 为 endpointNumber | 0x80（即 "in" 方向）。

4. 令 endpoint 为用 查找端点，输入为 endpointAddress 和 this 的结果。

5. 如果 endpoint 为 null，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

6. 如果 endpoint.type 不等于 "isochronous"， 则返回 一个以拒绝状态完成的 promise， 其拒因为 "InvalidAccessError" DOMException。

7. 令 promise 为 一个新的 promise。

8. 并行运行以下步骤。

   1. 令 totalLength 为 packetLengths 各元素之和。

   2. 令 buffer 为一个具有 totalLength 字节空间的主机缓冲区。

   3. 在 endpoint 上执行一次 等时 IN 传输，按照 packetLengths 从设备读取分组并写入 buffer。

   4. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 result 为 新的 USBIsochronousInTransferResult。

      2. 令 data 为一个 新的 ArrayBuffer，以 buffer 初始化。

      3. 将 result.data 设为在 buffer 之上构建的一个 新的 DataView。

      4. 对于每个分组 i 从 0 到 packetLengths.length - 1：

         1. 令 packet 为 新的 USBIsochronousInTransferPacket。

         2. 令 view 为一个 新的 DataView， 其覆盖 data 中包含该分组从设备接收数据的部分，并将 packet.data 设为 view。

         3. 将 packet.status 设为：

            • "stall"， 如果传输因设备在该分组接收前停止了 endpoint 而结束。

            • "babble"， 如果传输因设备为该分组发送的数据多于 packetLengths[i] 字节而结束。

            • "ok"， 否则。

         4. 如果传输因其他任何原因失败，则拒绝 promise，拒因为 "NetworkError" DOMException， 并中止这些步骤。

         5. 将 result.packets[i] 设为 packet。

      5. 将 promise 解析为 result。

9. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 endpointAddress 为 endpointNumber（即 "out" 方向）。

4. 令 endpoint 为用 查找端点，输入为 endpointAddress 和 this 的结果。

5. 如果 endpoint 为 null，返回 一个以拒绝状态完成的 promise，其拒因为 "NotFoundError" DOMException。

6. 如果 endpoint.type 不等于 "isochronous"， 则返回 一个以拒绝状态完成的 promise， 其拒因为 "InvalidAccessError" DOMException。

7. 获取缓冲区源 data 的一份拷贝，并令结果为 bytes。

8. 令 promise 为 一个新的 promise。

9. 并行运行以下步骤。

   1. 在 endpoint 上执行一次 等时 OUT 传输，将 bytes 写入设备，分成 packetLengths.length 个分组， 每个分组为 packetLengths[i] 字节（对于分组 i 从 0 到 packetLengths.length - 1）。

   2. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 令 result 为 新的 USBIsochronousOutTransferResult。

      2. 对于每个分组 i 从 0 到 packetLengths.length - 1：

         1. 令 packet 为 新的 USBIsochronousOutTransferPacket。

         2. 将 packet.bytesWritten 设为作为该分组的一部分成功发送到设备的数据量。

         3. 将 packet.status 设为：

            • "stall"， 如果传输因设备在该分组被确认前停止了 endpoint 而结束。

            • "ok"， 否则。

         4. 如果传输因其他任何原因失败，则拒绝 promise，拒因为 "NetworkError" DOMException， 并中止这些步骤。

         5. 将 result.packets[i] 设为 packet。

      3. 将 promise 解析为 result。

10. 返回 promise。

1. 令 global 为 this 的 相关全局对象。

2. 如果用 检查设备是否已配置 与 this 返回一个 Promise， 则返回该值。

3. 令 promise 为 一个新的 promise。

4. 并行运行以下步骤。

   1. 中止设备上的所有操作，并在 全局任务队列中入队一个基于 USB 任务源 的任务， 以拒绝其相关的 promise，拒因为 "AbortError" DOMException。

   2. 执行必要的平台特定操作以对设备进行软重置。

   3. 在全局任务队列中入队一个基于 USB 任务源、给定 global 的任务， 以运行以下步骤：

      1. 如果软重置失败，则拒绝 promise，拒因为 "NetworkError"， 并中止这些步骤。

      2. 将 promise 解析为 undefined。

5. 返回 promise。

设备重置后处于什么配置？ [Issue #36]

1. 令 configuration 为用 device 查找当前配置 的结果。

2. 如果 configuration 为 null，返回 undefined。

3. 如果 setup.recipient 为 "interface"， 则执行以下步骤：

   1. 令 interfaceNumber 为 setup.index 的低 8 位。

   2. 令 interfaceIndex 为用 interfaceNumber 和 configuration 查找接口索引 的结果。

   3. 如果 interfaceIndex 等于 -1，返回 一个被拒绝的 promise，其拒因为 "NotFoundError" DOMException。

   4. 令 interface 为 configuration.[[interfaces]][interfaceIndex]。

   5. 如果用 interface 查找接口是否已被声明 的结果不为 true，返回 一个被拒绝的 promise，其拒因为 "InvalidStateError" DOMException。

4. 如果 setup.recipient 为 "endpoint"， 则运行以下步骤：

   1. 令 endpointAddress 为 setup.index。

   2. 令 endpoint 为用 endpointAddress 和 device 查找端点 的结果。

   3. 如果 endpoint 为 null，返回 一个被拒绝的 promise，其拒因为 "NotFoundError" DOMException。

   4. 令 alternate 为 endpoint.[[alternateInterface]]。

   5. 令 interface 为 alternate.[[interface]]。

   6. 如果用 interface 查找接口是否已被声明 的结果为 false，返回 一个被拒绝的 promise，其拒因为 "InvalidStateError" DOMException。

5. 返回 undefined。

1. 令 deviceDescriptor 为 查找已连接 USB 设备的设备描述符 的结果。

2. 令 numConfigurations 为 deviceDescriptor 的 bNumConfigurations。

3. 令 configurationIndex 为 0。

4. 当 configurationIndex 小于 numConfigurations 时：

   1. 令 descriptors 为通过执行 Get Descriptor、将 DescriptorType 设为 CONFIGURATION 且 DescriptorIndex 设为 configurationIndex 所得到的描述符列表。

   2. 如果 descriptors[0] 的 bDescriptorType 等于 CONFIGURATION 且 descriptors 的 bConfigurationValue 等于 configurationValue，则返回 descriptors。

   3. 将 configurationIndex 加 1。

5. 返回 空 结果。

1. 将 this.[[device]] 设为 device。

2. 将 this.[[configurationValue]] 设为 configurationValue。

3. 令 descriptors 为以 configurationValue 设为 configurationValue 来 查找配置的描述符列表 的结果。

4. 令 seen 为一个空的 有序集合。

5. 对 descriptors 中的每个 descriptor：

   1. 如果 descriptor 的 bDescriptorType 不等于 INTERFACE，跳过。

   2. 如果 descriptor 的 bInterfaceNumber 在 seen 中，跳过。

   3. 令 interface 为一个 新的 USBInterface 对象，使用 USBInterface(configuration,interfaceNumber)， 其中 configuration 设为 this， interfaceNumber 设为 descriptor 的 bInterfaceNumber。

   4. 将 interface 追加到 this.[[interfaces]]。

   5. 将 descriptor 的 bInterfaceNumber 追加到 seen。

1. 令 configuration 为 interface.[[configuration]]。

2. 令 device 为 configuration.[[device]]。

3. 如果 configuration 与用 device 查找当前配置 的结果不同，返回 false。

4. 令 interfaceIndex 为用 interface.[[interfaceNumber]] 和 configuration 查找接口索引 的结果。

5. 断言：interfaceIndex 不等于 -1。

6. 返回 device.[[claimedInterface]][interfaceIndex]。

1. 令 configuration 为 interface.[[configuration]]。

2. 令 device 为 configuration.[[device]]。

3. 令 alternateIndex 为 0。

4. 如果用 interface 查找接口是否已被声明 的结果为 true：

   1. 令 interfaceIndex 为用 interface.[[interfaceNumber]] 和 configuration 查找接口索引 的结果。

   2. 断言：interfaceIndex 不等于 -1。

   3. 将 alternateIndex 设为用 device.[[selectedAlternateSetting]][interfaceIndex] 和 interface 查找备选索引 的结果。

5. 断言：alternateIndex 不等于 -1。

6. 返回 interface.alternates[alternateIndex]。

注意： 根据 接口描述符 [USB31]，每个接口至少有一个备选设置， 因为在 接口描述符 中必须至少存在一个备选设置。

1. 将 this.[[configuration]] 设为 configuration。

2. 将 this.[[interfaceNumber]] 设为 interfaceNumber。

3. 令 descriptors 为以 configurationValue 设为 configuration.[[configurationValue]] 来 查找配置的描述符列表 的结果。

4. 对 descriptors 中的每个 descriptor：

   1. 如果 descriptor 的 bDescriptorType 不等于 INTERFACE，则继续。

   2. 如果 descriptor 的 bInterfaceNumber 不等于 interfaceNumber，则继续。

   3. 如果 具有受保护的接口类别，则将 this.[[isProtectedClass]] 设为 true。

   4. 令 alternate 为一个 新的 USBAlternateInterface 对象， 使用 USBAlternateInterface(deviceInterface,alternateSetting)， 其中 deviceInterface 设为 this， alternateSetting 设为 descriptor 的 bAlternateSetting。

   5. 将 alternate 追加到 this.[[alternates]]。

1. 令 descriptors 为以 configurationValue 来 查找配置的描述符列表 的结果。

2. 令 endpointDescriptors 为一个空的 列表。

3. 令 index 为 0。

4. 当 index 小于 descriptors 的 大小 时：

   1. 令 descriptor 为 descriptors[index]。

   2. 如果 descriptor 的 bDescriptorType 不等于 INTERFACE， 将 index 加 1 并继续。

   3. 如果 descriptor 的 bInterfaceNumber 不等于 interfaceNumber， 将 index 加 1 并继续。

   4. 如果 descriptor 的 bAlternateSetting 不等于 alternateSetting， 将 index 加 1 并继续。

   5. 如果 bNumEndpoints 等于 0，返回 endpointDescriptors。

   6. 令 numEndpoints 为 descriptor 的 bNumEndpoints。

   7. 令 indexEndpoints 为 0。

   8. 令 offset 为 index + 1。

   9. 当 indexEndpoints 小于 numEndpoints 时：

      1. 将 descriptors[indexEndpoints + offset] 追加到 endpointDescriptors。

      2. 将 indexEndpoints 加 1。

   10. 返回 endpointDescriptors。

1. 将 this.[[interface]] 设为 deviceInterface。

2. 将 this.[[alternateSetting]] 设为 alternateSetting。

3. 令 descriptors 为 查找端点描述符列表 的结果， 其中 interfaceNumber 设为 deviceInterface.interfaceNumber， alternateSetting 设为 alternateSetting， configurationValue 设为 deviceInterface.[[configuration]].[[configurationValue]]。

4. 对 descriptors 中的每个 descriptor：

   1. 如果 descriptor 的 bmAttributes 表明它是控制传输类型（即根据 端点描述符，位 0..1 为 00），则继续。

   2. 令 endpointAddress 为 descriptor 的 bEndpointAddress。

   3. 令 dir 为 "out" 如果 endpointAddress & 0x80 为 0， 否则为 "in"。

   4. 令 endpoint 为一个 新的 USBEndpoint 对象， 使用 USBEndpoint(alternate,endpointNumber,direction)， 其中 alternate 设为 this， endpointNumber 设为 endpointAddress & 0xF， direction 设为 dir。

   5. 将 endpoint 追加到 this.[[endpoints]]。

1. 令 alternateInterface 为 endpoint.[[alternateInterface]]。

2. 令 interface 为 alternateInterface.[[interface]]。

3. 令 configuration 为 interface.[[configuration]]。

4. 令 endpointDescriptors 为 查找端点描述符列表 的结果，其中 alternateSetting 设为 alternateInterface.alternateSetting， interfaceNumber 设为 interface.interfaceNumber， configurationValue 设为 configuration.configurationValue。

5. 对于 endpointDescriptors 中的每个 endpointDescriptor：

   1. 如果 endpoint.[[endpointAddress]] 等于 endpointDescriptor 的 bEndpointAddress，则返回 endpointDescriptor。

1. 将 this.[[alternateInterface]] 设为 alternate。

2. 若 direction 为 "in"，则将 endpointAddress 设为 endpointNumber | 0x80；否则设为 endpointNumber。

3. 将 this.[[endpointAddress]] 设为 endpointAddress。