USBDevice: configuration property

Limited availability

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

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Note: This feature is available in Web Workers.

The configuration read only property of the USBDevice interface returns a USBConfiguration object for the currently selected interface for a paired USB device.

Value

A USBConfiguration object.

Examples

The following example uses this property to test for the existence of a USBConfiguration property to select a configuration before claiming an interface.

js
async function connectDevice(usbDevice) {
  await usbDevice.open();
  if (usbDevice.configuration === null) await usbDevice.selectConfiguration(1);
  await usbDevice.claimInterface(0);
}

Specifications

Specification
WebUSB API
# ref-for-dom-usbdevice-configuration①

Browser compatibility

BCD tables only load in the browser