La API de WebUSB expone dispositivos no estándar compatibles con el bus universal en serie (USB) en la Web. En esta página, se describen aspectos de la API específicos de las extensiones. Consulta MDN para obtener los detalles completos de la API de WebUSB.
Disponibilidad en las extensiones
Chrome 118 o versiones posteriores
Permisos
No se requieren permisos de archivos de manifiesto. Sin embargo, WebUSB activa el flujo de permisos del usuario del navegador.
Manifiesto
No se necesitan claves de manifiesto para esta API.
Contextos de asistencia
Esta API se puede usar en casi cualquier contexto. No se puede usar el método WebUSB.requestDevice() en service workers de extensiones. Consulte la siguiente sección para obtener más detalles.
Cuando se usa esta API en un service worker de extensión, la sesión de conexión de dispositivos mantiene activo el service worker.
Diferencias en la extensión de Chrome
Aunque WebUSB está disponible para los service workers de extensiones, no se puede llamar a WebUSB.requestDevice(), que muestra una promesa que se resuelve con una instancia de USBDevice, en un service worker de extensión. Para evitar esto, llama a requestDevice() desde una página de extensión que no sea el service worker de la extensión y envía un mensaje a este.
El siguiente código sigue un patrón típico llamando a requestDevice() como parte de un flujo de permisos que requiere un gesto del usuario. Cuando se adquiere el dispositivo, envía un mensaje al trabajador de servicio, que luego puede recuperarlo con getDevices().
popup.js:
myButton.addEventListener("click", async () => {
await navigator.usb.requestDevice({
filters: [{ vendorId: 0x1234, productId: 0x5678 }],
});
chrome.runtime.sendMessage("newDevice");
});
service-worker.js
chrome.runtime.onMessage.addListener(async (message) => {
if (message === "newDevice") {
const devices = await navigator.usb.getDevices();
for (const device of devices) {
// open device connection.
await device.open();
}
}
});