Draft
This page is not complete.
Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The USBInterface interface of the WebUSB API provides information about an interface provided by the USB device. An interface represents a feature of the device which implements a particular protocol and may contain endpoints for bidirectional communication.
Constructor
USBInterface.USBInterface- Creates a new
USBInterfaceobject which will be populated with information about the interface on the providedUSBConfigurationwith the given interface number.
Properties
USBInterface.interfaceNumberRead only- Returns the interface number of this interface. This is equal to the
bInterfaceNumberfield of the interface descriptor defining this interface. USBInterface.alternateRead only- Returns the currently selected alternative configuration of this interface. By default this is the
USBAlternateInterfacefromalternateswithalternateSettingequal to0. It can be changed by callingUSBDevice.selectAlternateInterface()with any other value found inalternates. USBInterface.alternatesRead only- Returns an array containing instances of the
USBAlternateInterfaceinterface describing each of the alternative configurations possible for this interface. USBInterface.claimedRead only- Returns whether or not this interface has been claimed by the current page by calling
USBDevice.claimInterface().
Specifications
| Specification | Status | Comment |
|---|---|---|
| WebUSB The definition of 'USBInterface' in that specification. |
Draft | Initial definition. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
USBInterface | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
USBInterface() constructor | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
alternate | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
alternates | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
claimed | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
interfaceNumber | Chrome Full support 61 | Edge Full support 79 | Firefox No support No | IE No support No | Opera Full support 48 | Safari No support No | WebView Android No support No | Chrome Android Full support 61 | Firefox Android No support No | Opera Android Full support 45 | Safari iOS No support No | Samsung Internet Android Full support 8.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
