USB: requestDevice() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die requestDevice() Methode des USB-Interfaces gibt ein Promise zurück, das mit einer Instanz von USBDevice aufgelöst wird, wenn das angegebene Gerät gefunden wird. Das Aufrufen dieser Funktion löst den Kopplungsablauf des Benutzeragents aus.
Syntax
requestDevice(options)
Parameter
options-
Ein Objekt, das Optionen zum Auswählen eines geeigneten Geräts festlegt. Die verfügbaren Optionen sind:
filters-
Ein Array von Filterobjekten für mögliche Geräte, die Sie koppeln möchten. Jedes Filterobjekt kann die folgenden Eigenschaften haben:
vendorIdproductIdclassCodesubclassCodeprotocolCodeserialNumber
Rückgabewert
Ein Promise, das mit einer Instanz von USBDevice aufgelöst wird.
Sicherheit
Transiente Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.
Beispiele
Im folgenden Beispiel wird nach einem von zwei USB-Geräten gesucht. Beachten Sie, dass zwei Produkt-IDs angegeben sind. Beide werden an requestDevice() übergeben. Dies löst einen Benutzeragentenablauf aus, der den Benutzer auffordert, ein Gerät zur Kopplung auszuwählen. Nur das ausgewählte Gerät wird an then() übergeben.
Die Anzahl der Filter bestimmt nicht die Anzahl der vom Benutzeragenten angezeigten Geräte. Zum Beispiel, wenn nur ein USB-Gerät mit der Produkt-ID 0xa800 gefunden wird, dann wird nur ein Gerät vom Benutzeragenten aufgelistet. Andererseits, wenn der Benutzeragent zwei Geräte des ersten gelisteten und eines des zweiten findet, dann werden alle drei Geräte aufgelistet.
const filters = [
{ vendorId: 0x1209, productId: 0xa800 },
{ vendorId: 0x1209, productId: 0xa850 },
];
navigator.usb
.requestDevice({ filters })
.then((usbDevice) => {
console.log(`Product name: ${usbDevice.productName}`);
})
.catch((e) => {
console.error(`There is no device. ${e}`);
});
Spezifikationen
| Specification |
|---|
| WebUSB API # dom-usb-requestdevice |