Web/API/USBAlternateInterface

Draft This page is not complete.

Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The USBAlternateInterface interface of the WebUSB API provides information about a particular configuration of an interface provided by the USB device. An interface includes one or more alternate settings which can configure a set of endpoints based on the operating mode of the device.

Constructor

USBAlternateInterface.USBAlternateInterface

Creates a new USBAlternateInterface object which will be populated with information about the alternate interface of the provided USBInterface with the given alternate setting number.

Properties

USBAlternateInterface.alternateSettingRead only

Returns the alternate setting number of this interface. This is equal to the bAlternateSetting field of the interface descriptor defining this interface.

USBAlternateInterface.interfaceClassRead only

Returns the class of this interface. This is equal to the bInterfaceClass field of the interface descriptor defining this interface. Standardized values for this field are defined by the USB Implementers Forum. A value of 0xFF indicates a vendor-defined interface.

USBAlternateInterface.interfaceSubclassRead only

Returns the subclass of this interface. This is equal to the bInterfaceSubClass field of the interface descriptor defining this interface. The meaning of this value depends on the interfaceClass field.

USBAlternateInterface.interfaceProtocolRead only

Returns the protocol supported by this interface. This is equal to the bInterfaceProtocol field of the interface descriptor defining this interface. The meaning of this value depends on the interfaceClass and interfaceSubclass fields.

USBAlternateInterface.interfaceNameRead only

Returns the name of the interface, if one is provided by the device. This is the value of the string descriptor with the index specified by the iInterface field of the interface descriptor defining this interface.

USBAlternateInterface.endpointsRead only

Returns an array containing instances of the USBEndpoint interface describing each of the endpoints that are part of this interface.

Specifications

Specification	Status	Comment
WebUSBThe definition of 'USBAlternateInterface' 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.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
USBAlternateInterface Experimental'	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
USBAlternateInterface() constructor Experimental'	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
alternateSetting Experimental'	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
endpoints Experimental'	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
interfaceClass Experimental'	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
interfaceName Experimental'	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
interfaceProtocol Experimental'	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
interfaceSubclass Experimental'	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.

USBAlternateInterface by Mozilla Contributors is licensed under CC-BY-SA 2.5.