USBDevice

Limited availability

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

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

WebUSB APIUSBDevice インターフェイスは、ペアリングした USB デバイスのメタデータへのアクセスと、デバイスの制御用のメソッドを提供します。

インスタンスプロパティ

USBDevice.configuration 読取専用 Experimental

ペアリングした USB デバイスの現在選択されているインターフェイスを表す USBConfiguration オブジェクトです。

USBDevice.configurations 読取専用 Experimental

ペアリングした USB デバイスの制御用のデバイス固有のインターフェイスの array です。

USBDevice.deviceClass 読取専用 Experimental

デバイスとともに動く USB ドライバーのロード用に USB デバイスを特定する 3 個のプロパティのうちの 1 個です。他の 2 個のプロパティは USBDevice.deviceSubclassUSBDevice.deviceProtocol です。

USBDevice.deviceProtocol 読取専用 Experimental

デバイスとともに動く USB ドライバーのロード用に USB デバイスを特定する 3 個のプロパティのうちの 1 個です。他の 2 個のプロパティは USBDevice.deviceClassUSBDevice.deviceSubclass です。

USBDevice.deviceSubclass 読取専用 Experimental

デバイスとともに動く USB ドライバーのロード用に USB デバイスを特定する 3 個のプロパティのうちの 1 個です。他の 2 個のプロパティは USBDevice.deviceClassUSBDevice.deviceProtocol です。

USBDevice.deviceVersionMajor 読取専用 Experimental

セマンティックバージョニングスキームによるデバイスのメジャーバージョン番号です。

USBDevice.deviceVersionMinor 読取専用 Experimental

セマンティックバージョニングスキームによるデバイスのマイナーバージョン番号です。

USBDevice.deviceVersionSubminor 読取専用 Experimental

セマンティックバージョニングスキームによるデバイスのパッチバージョン番号です。

USBDevice.manufacturerName 読取専用 Experimental

この USB デバイスを製造した組織の名前です。

USBDevice.opened 読取専用 Experimental

ペアリングした USB デバイスとのセッションが開始しているかを表します。

USBDevice.productId 読取専用 Experimental

製造元が定義する、USB デバイスを識別するコードです。

USBDevice.productName 読取専用 Experimental

製造元が定義する、USB デバイスを識別する名前です。

USBDevice.serialNumber 読取専用 Experimental

製造元が定義する、特定の USB デバイスのシリアル番号です。

USBDevice.usbVersionMajor 読取専用 Experimental

デバイスが対応している USB のプロトコルバージョンを表す 3 個のプロパティのうちの 1個です。他の 2 個のプロパティは USBDevice.usbVersionMinorUSBDevice.usbVersionSubminor です。

USBDevice.usbVersionMinor 読取専用 Experimental

デバイスが対応している USB のプロトコルバージョンを表す 3 個のプロパティのうちの 1個です。他の 2 個のプロパティは USBDevice.usbVersionMajorUSBDevice.usbVersionSubminor です。

USBDevice.usbVersionSubminor 読取専用 Experimental

デバイスが対応している USB のプロトコルバージョンを表す 3 個のプロパティのうちの 1個です。他の 2 個のプロパティは USBDevice.usbVersionMajorUSBDevice.usbVersionMinor です。

USBDevice.vendorId 読取専用 Experimental

usb.org で割り当てられた公式なベンダー ID です。

インスタンスメソッド

USBDevice.claimInterface() Experimental

要求したインターフェイスの排他アクセスを獲得したら解決する Promise を返します。

USBDevice.clearHalt() Experimental

停止状態のクリアが完了したら解決する Promise を返します。

USBDevice.controlTransferIn() Experimental

コマンドまたは状態の操作の USB デバイスへの転送が完了したら USBInTransferResult で解決する Promise を返します。

USBDevice.controlTransferOut() Experimental

コマンドまたは状態の操作の USB デバイスからの転送が完了したら USBOutTransferResult で解決する Promise を返します。

USBDevice.close() Experimental

すべての開いているインターフェイスが解放され、デバイスのセッションが終了したら解決する Promise を返します。

USBDevice.forget() Experimental

すべての開いているインターフェイスが解放され、デバイスのセッションが終了し、許可をリセットしたら解決する Promise を返します。

USBDevice.isochronousTransferIn() Experimental

時間が重要な情報の USB デバイスへの転送が完了したら USBIsochronousInTransferResult で解決する Promise を返します。

USBDevice.isochronousTransferOut() Experimental

時間が重要な情報の USB デバイスからの転送が完了したら USBIsochronousOutTransferResult で解決する Promise を返します。

USBDevice.open() Experimental

デバイスのセッションが開始したら解決する Promise を返します。

USBDevice.releaseInterface() Experimental

要求済みのインターフェイスが排他アクセスから解放されたら解決する Promise を返します。

USBDevice.reset() Experimental

デバイスがリセットされ、アプリケーションによる操作がすべてキャンセルされ、それらのプロミスが拒否されたら解決する Promise を返します。

USBDevice.selectAlternateInterface() Experimental

指定のオルタナティブエンドポイントが選択されたら解決する Promise を返します。

USBDevice.selectConfiguration() Experimental

指定のコンフィギュレーションが選択されたら解決する Promise を返します。

USBDevice.transferIn() Experimental

USB デバイスからバルクまたはインタラプトデータを受信したら USBInTransferResult で解決する Promise を返します。

USBDevice.transferOut() Experimental

USB デバイスにバルクまたはインタラプトデータを送信したら USBOutTransferResult で解決する Promise を返します。

仕様書

Specification
WebUSB API
# device-usage

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
USBDevice
Experimental
claimInterface
Experimental
clearHalt
Experimental
close
Experimental
configuration
Experimental
configurations
Experimental
controlTransferIn
Experimental
controlTransferOut
Experimental
deviceClass
Experimental
deviceProtocol
Experimental
deviceSubclass
Experimental
deviceVersionMajor
Experimental
deviceVersionMinor
Experimental
deviceVersionSubminor
Experimental
forget
Experimental
isochronousTransferIn
Experimental
isochronousTransferOut
Experimental
manufacturerName
Experimental
open
Experimental
opened
Experimental
productId
Experimental
productName
Experimental
releaseInterface
Experimental
reset
Experimental
selectAlternateInterface
Experimental
selectConfiguration
Experimental
serialNumber
Experimental
transferIn
Experimental
transferOut
Experimental
usbVersionMajor
Experimental
usbVersionMinor
Experimental
usbVersionSubminor
Experimental
vendorId
Experimental
Available in workers
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
Has more compatibility info.