Firefox Tomorrow

web api instance method

USBDevice: claimInterface() method

View on MDN ↗

Limited availabilitySecure contextAvailable in workers

The claimInterface() method of the USBDevice interface returns a Promise that resolves when the requested interface is claimed for exclusive access.

Syntax

claimInterface(interfaceNumber)

Parameters

  • interfaceNumber
    • : The index of one of the interfaces supported by the device. Interfaces are device specific.

Return value

A Promise.

Examples

The following example shows claimInterface() in the context of connecting to a USB device.

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

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.