HID 设备：forget() 方法

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在一些或所有支持的浏览器中可用。

实验性：这是一个实验性技术
在生产环境中使用此功能之前，请仔细查看浏览器兼容性表。

HIDDevice 接口的 forget() 方法会关闭与 HID 设备的连接并忘记该设备。

语法

js
forget()

参数

无。

返回值

一个Promise，在连接关闭、设备被遗忘并重置权限后，该 Promise 将解析为 undefined。

示例

在以下示例中，我们将连接到 Nintendo Switch Joy-Con 右 HID 设备，闪烁一次，然后断开与它的连接。

js
async function blink() {
  const devices = await navigator.hid.requestDevice({
    filters: [
      {
        vendorId: 0x057e, // Nintendo Co., Ltd
        productId: 0x2007, // Joy-Con Right
      },
    ],
  });
  const device = devices[0];
  await device.open();
  // Turn off
  await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
  await waitFor(100);
  // Turn on
  await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
  // Finally, disconnect from it
  await device.forget();
}
blink();

规范

规范
WebHID API
# dom-hiddevice-forget

浏览器兼容性

BCD 表格仅在浏览器中加载