HIDDevice: forget() method

Secure contextLimited availabilityAvailable in workers

The forget() method of the HIDDevice interface closes the connection to the HID device and forgets the device.

Syntax

forget()

Parameters

None.

Return value

A Promise that resolves with undefined once the connection is closed, the device is forgotten, and the permission is reset.

Example

In the following example we connect to a Nintendo Switch Joy-Con Right HID device, blink once, and disconnect from it.

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 new Promise((resolve) => setTimeout(resolve, 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();

Specifications

Browser compatibility