USB

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{SecureContext_Header}}{{AvailableInWorkers}}

The USB interface of the WebUSB API provides attributes and methods for finding and connecting USB devices from a web page.

Use {{domxref("navigator.usb")}} to get access to the USB object.

The USB interface inherits from {{domxref("EventTarget")}}.

{{InheritanceDiagram}}

Instance properties

None.

Instance methods

• {{domxref("USB.getDevices()")}} {{Experimental_Inline}}
  • : Returns a {{jsxref("Promise")}} that resolves with an array of {{domxref("USBDevice")}} objects for paired attached devices.
• {{domxref("USB.requestDevice()")}} {{Experimental_Inline}}
  • : Returns a {{jsxref("Promise")}} that resolves with an instance of {{domxref("USBDevice")}} if the specified device is found. Calling this function triggers the user agent's pairing flow.

Events

• {{domxref("USB.connect_event", "connect")}} {{Experimental_Inline}}
  • : Fired whenever a previously paired device is connected.
• {{domxref("USB.disconnect_event", "disconnect")}} {{Experimental_Inline}}
  • : Fired whenever a paired device is disconnected.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}