Wat is de WebUSB API?

De WebUSB API is een browserstandaard die webpagina's in staat stelt om rechtstreeks met USB-apparaten te communiceren — zonder native stuurprogramma's of desktoptoepassingen te installeren. Het werd geïntroduceerd in Chrome 61 en geeft websites gecontroleerde, toestemmingsbeheerde toegang tot hardware zoals microcontrollers, ontwikkelingsborden, MIDI-interfaces en andere USB-randapparatuur.

In tegenstelling tot traditionele USB-toegang (waarvoor stuurprogramma's op kernelniveau vereist zijn), werkt WebUSB volledig in de browsersandbox. Gebruikers moeten expliciet toestemming verlenen voor elk apparaat via de ingebouwde apparaatkiezer van de browser, wat ervoor zorgt dat geen website stilletjes van uw hardware kan lezen of ernaar kan schrijven.

Hulpprogrammabeschrijving

Met dit hulpprogramma kunt u USB-apparaten opsommen die via de WebUSB API aan de browser zijn verleend. Bij het laden worden automatisch alle eerder toegestane apparaten weergegeven. U kunt ook de ingebouwde USB-kiezer van de browser openen om toegang tot een nieuw aangesloten apparaat toe te staan, of de lijst op elk moment vernieuwen.

Voor elk apparaat geeft het hulpprogramma de productnaam, fabrikant, leveranciers-ID, product-ID, serienummer en USB-protocolversie weer.

Functies

  • Laadt automatisch eerder verleende USB-apparaten bij het openen van de pagina
  • Opent de ingebouwde USB-apparaatkiezer van de browser om toegang tot nieuwe apparaten toe te staan
  • Geeft leveranciers-ID en product-ID weer in standaard hexadecimale notatie (bijv. 0x1A2B)
  • Toont USB-protocolversie (bijv. 2.0, 3.1) naast apparaatidentificatievelden
  • Sorteerbare resultatentabel met CSV- en JSON-export

Hoe het werkt

Wanneer u op Apparaat toevoegen klikt, roept de browser navigator.usb.requestDevice() aan en geeft een systeemkiezer weer met aangesloten USB-apparaten. Als u er een selecteert, slaat de browser de toestemming voor die oorsprong op. Bij volgende bezoeken (of na het klikken op Vernieuwen) retourneert navigator.usb.getDevices() alle eerder toegestane apparaten zonder opnieuw te vragen.

Leveranciers-ID en product-ID worden weergegeven in 4-cijferige hoofdletters hex (bijv. 0x04D8) — het standaardformaat dat in USB-registers en datasheets wordt gebruikt.

Gebruiksscenario's

  • Firmware-ontwikkelaars kunnen snel bevestigen dat een aangesloten microcontroller of ontwikkelingsbord (Arduino, STM32, RP2040, enz.) correct door de browser wordt opgesomd voordat een WebUSB-gebaseerd flashprogramma wordt geschreven.
  • Webappontwikkelaars kunnen verifiëren dat hun WebUSB-ingeschakelde toepassing de verwachte apparaatidentificatievelden ziet tijdens de vroege prototypefase.

Beperkingen

  • WebUSB wordt alleen ondersteund in op Chromium gebaseerde browsers (Chrome, Edge, Opera). Firefox en Safari implementeren deze API niet.
  • De pagina moet via HTTPS (of localhost) worden geleverd — WebUSB wordt geblokkeerd op gewone HTTP-oorsprongen.
  • Sommige combinaties van besturingssysteem en browser beperken de toegang tot bepaalde apparaatklassen (bijv. HID, massaopslag) zelfs wanneer toestemmingen zijn verleend.
  • Dit hulpprogramma leest alleen apparaatmetagegevens; het opent geen USB-interface en brengt geen gegevens naar/van het apparaat over.