HIDDevice.forget()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

HIDDevice インターフェイスの forget() メソッドは、HID デバイスとの接続を閉じ、デバイスを忘れます。

構文

js
forget()

引数

なし。

返値

接続が閉じられ、デバイスが忘れられ、許可がリセットされた後 undefined で解決する Promise を返します。

例

この例では、Nintendo Switch Joy-Con Right HID デバイスに接続し、1 回点滅させ、切断します。

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();
  // 消灯させます
  await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
  await waitFor(100);
  // 点灯させます
  await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
  // 最後に、切断します
  await device.forget();
}
blink();

仕様書

Specification
WebHID API
# dom-hiddevice-forget

ブラウザーの互換性

BCD tables only load in the browser