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 WebUSB API provides a way to expose non-standard Universal Serial Bus (USB) compatible devices services to the web, to make USB safer and easier to use.
Concepts and UsageUSB is the de-facto standard for wired peripherals. The USB devices that you connect to your computer are typically grouped into a number of device classesâsuch as keyboards, mice, video devices, and so on. These are supported using the operating system's class driver. Many of these are also web accessible via the WebHID API.
In addition to these standardized devices, there are a large number of devices that don't fit into any class. These need custom drivers, and are inaccessible from the web due to the native code required to take advantage of them. Installing one of these devices often involves searching on a manufacturer's website for drivers and, should you wish to use the device on another computer, repeating the process again.
WebUSB provides a way for these non-standardized USB device services to be exposed to the web. This means that hardware manufacturers will be able to provide a way for their device to be accessed from the web, without having to provide their own API.
When connecting a new WebUSB-compatible device, the browser displays a notification providing a link to the manufacturer's website. On arriving at the site the browser prompts for permission to connect to the device, then the device is ready for use. No drivers need be downloaded and installed.
InterfacesUSB
Provides attributes and methods for finding and connecting USB devices from a web page.
USBConnectionEvent
The event type passed to USB
connect
or disconnect
events when the user agent detects a new USB device has been connected to, or disconnected from the host.
USBDevice
Provides access to metadata about a paired USB device and methods for controlling it.
USBInTransferResult
Represents the result from requesting a transfer of data from the USB device to the USB host.
USBOutTransferResult
Represents the result from requesting a transfer of data from the USB host to the USB device.
USBIsochronousInTransferPacket
Represents the status of an individual packet from a request to transfer data from the USB device to the USB host over an isochronous endpoint.
USBIsochronousInTransferResult
Represents the result from requesting a transfer of data from the USB device to the USB host.
USBIsochronousOutTransferPacket
Represents the status of an individual packet from a request to transfer data from the USB host to the USB device over an isochronous endpoint.
USBIsochronousOutTransferResult
Represents the result from requesting a transfer of data from the USB host to the USB device.
USBConfiguration
Provides information about a particular configuration of a USB device and the interfaces that it supports.
USBInterface
Provides information about an interface provided by the USB device.
USBAlternateInterface
Provides information about a particular configuration of an interface provided by the USB device.
USBEndPoint
Provides information about an endpoint provided by the USB device.
The following example demonstrates how to access a connected Arduino device using USB.requestDevice()
, which has a vendorId of 0x2341
.
navigator.usb
.requestDevice({ filters: [{ vendorId: 0x2341 }] })
.then((device) => {
console.log(device.productName); // "Arduino Micro"
console.log(device.manufacturerName); // "Arduino LLC"
})
.catch((error) => {
console.error(error);
});
Finding all connected devices
You can find all connected devices with USB.getDevices()
. In the following example, with the Arduino device connected, product and manufacturer name are printed to the console.
navigator.usb.getDevices().then((devices) => {
devices.forEach((device) => {
console.log(device.productName); // "Arduino Micro"
console.log(device.manufacturerName); // "Arduino LLC"
});
});
Specifications See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4