USBInterface

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 USBInterface object which will be populated with information about the interface on the provided USBConfiguration with the given interface number.

Properties

USBInterface.interfaceNumberRead only

Returns the interface number of this interface. This is equal to the bInterfaceNumber field of the interface descriptor defining this interface.

USBInterface.alternateRead only

Returns the currently selected alternative configuration of this interface. By default this is the USBAlternateInterface from alternates with alternateSetting equal to 0. It can be changed by calling USBDevice.selectAlternateInterface() with any other value found in alternates.

USBInterface.alternatesRead only

Returns an array containing instances of the USBAlternateInterface interface 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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
USBInterface
61
79
No
No
48
No
No
61
No
45
No
8.0
USBInterface
61
79
No
No
48
No
No
61
No
45
No
8.0
alternate
61
79
No
No
48
No
No
61
No
45
No
8.0
alternates
61
79
No
No
48
No
No
61
No
45
No
8.0
claimed
61
79
No
No
48
No
No
61
No
45
No
8.0
interfaceNumber
61
79
No
No
48
No
No
61
No
45
No
8.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/USBInterface