USBDevice: claimInterface() メソッド

Limited availability

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

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

USBDevice インターフェイスの claimInterface() メソッドは、要求したインターフェイスの排他アクセスを獲得したら解決する Promise を返します。

構文

js
claimInterface(interfaceNumber)

引数

interfaceNumber

デバイスが対応しているインターフェイスのうち 1 個のインデックスです。インターフェイスはデバイス固有です。

返値

promise です。

例

以下の例では、USB デバイスへの接続時に使用される claimInterface() を示します。

js
async function connectDevice(usbDevice) {
  await usbDevice.open();
  if (usbDevice.configuration === null) await usbDevice.selectConfiguration(1);
  await usbDevice.claimInterface(0);
}

仕様書

Specification
WebUSB API
# ref-for-dom-usbdevice-claiminterface②

ブラウザーの互換性

BCD tables only load in the browser