O que é a WebUSB API?

A WebUSB API é um padrão de navegador que permite que páginas web se comuniquem diretamente com dispositivos USB — sem instalar drivers nativos ou aplicações de desktop. Foi introduzida no Chrome 61 e oferece aos sites acesso controlado e autorizado a hardware como microcontroladores, placas de desenvolvimento, interfaces MIDI e outros periféricos USB.

Diferentemente do acesso USB tradicional (que requer drivers de nível de kernel), WebUSB funciona inteiramente na sandbox do navegador. Os usuários devem conceder explicitamente permissão para cada dispositivo através do seletor de dispositivos integrado do navegador, o que garante que nenhum site possa ler ou escrever silenciosamente em seu hardware.

Descrição da ferramenta

Esta ferramenta permite enumerar dispositivos USB que foram concedidos ao navegador via WebUSB API. Ao carregar, lista automaticamente qualquer dispositivo previamente permitido. Você também pode abrir o seletor USB nativo do navegador para conceder acesso a um dispositivo recém-conectado, ou atualizar a lista a qualquer momento.

Para cada dispositivo, a ferramenta exibe o nome do produto, fabricante, ID do fornecedor, ID do produto, número de série e versão do protocolo USB.

Recursos

  • Carrega automaticamente dispositivos USB previamente autorizados ao abrir a página
  • Abre o seletor nativo de dispositivos USB do navegador para conceder acesso a novos dispositivos
  • Exibe ID do fornecedor e ID do produto em notação hexadecimal padrão (ex: 0x1A2B)
  • Mostra versão do protocolo USB (ex: 2.0, 3.1) junto aos campos de identidade do dispositivo
  • Tabela de resultados ordenável com exportação para CSV e JSON

Como funciona

Quando você clica em Adicionar Dispositivo, o navegador chama navigator.usb.requestDevice() e exibe um seletor de nível do sistema listando dispositivos USB conectados. Se você selecionar um, o navegador armazena a permissão para essa origem. Em visitas subsequentes (ou após clicar em Atualizar), navigator.usb.getDevices() retorna todos os dispositivos previamente permitidos sem solicitar novamente.

ID do fornecedor e ID do produto são renderizados em hex maiúsculo de 4 dígitos (ex: 0x04D8) — o formato padrão usado em registros USB e datasheets.

Casos de uso

  • Desenvolvedores de firmware podem confirmar rapidamente que um microcontrolador ou placa de desenvolvimento conectada (Arduino, STM32, RP2040, etc.) está corretamente enumerada pelo navegador antes de escrever uma ferramenta de gravação baseada em WebUSB.
  • Desenvolvedores de aplicações web podem verificar que sua aplicação habilitada para WebUSB verá os campos de identidade do dispositivo esperados durante prototipagem em estágio inicial.

Limitações

  • WebUSB é suportada apenas em navegadores baseados em Chromium (Chrome, Edge, Opera). Firefox e Safari não implementam esta API.
  • A página deve ser servida via HTTPS (ou localhost) — WebUSB é bloqueada em origens HTTP simples.
  • Algumas combinações de sistema operacional e navegador restringem o acesso a certas classes de dispositivos (ex: HID, armazenamento em massa) mesmo quando as permissões são concedidas.
  • Esta ferramenta lê apenas metadados do dispositivo; não abre nenhuma interface USB nem transfere dados para/do dispositivo.