Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The USBConfiguration interface of the WebUSB API provides information about a particular configuration of a USB device and the interfaces that it supports.
Constructor
USBConfiguration.USBConfiguration()- Creates a new
USBConfigurationobject which contains information about the configuration on the providedUSBDevicewith the given configuration value.
Properties
USBConfiguration.configurationValueRead only- Returns the configuration value of this configuration. This is equal to the
bConfigurationValuefield of the configuration descriptor provided by the device defining this configuration. USBConfiguration.configurationNameRead only- Returns the name provided by the device to describe this configuration. This is equal to the value of the string descriptor with the index provided in the
iConfigurationfield of the configuration descriptor defining this configuration. USBConfiguration.interfacesRead only- Returns an array containing instances of the
USBInterfacedescribing each interface supported by this configuration.
Specifications
| Specification | Status | Comment |
|---|---|---|
| WebUSB The definition of 'USBConfiguration' 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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
USBConfiguration | 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 |
USBConfiguration() 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 |
configurationName | 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 |
configurationValue | 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 |
interfaces | 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.