大网数据广告活动
Web 标准与前端开发

USBDevice: clearHalt() method

· 52CE 我爱测

The **`clearHalt()`** method of the USBDevice interface returns a Promise that resolves when a halt condition is cleared. A halt condition is when a data transfer to or from the device has a status of `'stall'`, which requires the web page (the _host_ system, in USB terminology)

WebUSB API

The clearHalt() method of the USBDevice interface returns a Promise that resolves when a halt condition is cleared. A halt condition is when a data transfer to or from the device has a status of 'stall', which requires the web page (the host system, in USB terminology) to clear that condition. See the for details.

Syntax

clearHalt(direction, endpointNumber)

Parameters

  • direction
    • : Indicates whether the devices input or output should be cleared. Valid values are 'in' or 'out'.
  • endpointNumber
    • : Indicates the number of the endpoint to clear. The promise will reject if an invalid endpoint is supplied.

Return value

A Promise.

Examples

The following example shows how to test for and clear a 'stall' condition in the result of a data transfer.

[!NOTE] What data can be passed to a USB device and how it is passed is particular and unique to each device.

while (true) {
  let result = await data.transferIn(1, 6);

  if (result.data && result.data.byteLength === 6) {
    console.log(`Channel 1: ${result.data.getUint16(0)}`);
    console.log(`Channel 2: ${result.data.getUint16(2)}`);
    console.log(`Channel 5: ${result.data.getUint16(4)}`);
  }

  if (result.status === "stall") {
    console.warn("Endpoint stalled. Clearing.");
    await device.clearHalt("in", 1);
  }
}

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。