USBDevice
Ограниченная доступность
Эта функция не является базовой, так как она не работает в некоторых из наиболее широко используемых браузеров.
Экспериментальная: Это экспериментальная технология
Перед использованием в производстве внимательно изучите таблицу совместимости браузеров таблица совместимости браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.
Примечание: Эта функция доступна в Web Workers.
Интерфейс USBDevice API WebUSB предоставляет доступ к метаданным о сопряжённом USB-устройстве и методам для его управления.
Свойства экземпляра
-
USBDevice.configurationТолько для чтения Экспериментальная -
Объект
USBConfigurationдля текущего выбранного интерфейса сопряжённого USB-устройства. -
USBDevice.configurationsТолько для чтения Экспериментальная -
Массив
arrayспецифичных для устройства интерфейсов для управления сопряжённым USB-устройством. -
USBDevice.deviceClassТолько для чтения Экспериментальная -
Одна из трёх характеристик, определяющих USB-устройства для загрузки USB-драйвера, который будет работать с этим устройством. Две другие характеристики —
USBDevice.deviceSubclassиUSBDevice.deviceProtocol. -
USBDevice.deviceProtocolТолько для чтения Экспериментальная -
Одна из трёх характеристик, определяющих USB-устройства для загрузки USB-драйвера, который будет работать с этим устройством. Две другие характеристики —
USBDevice.deviceClassиUSBDevice.deviceSubclass. -
USBDevice.deviceSubclassТолько для чтения Экспериментальная -
Одна из трёх характеристик, определяющих USB-устройства для загрузки USB-драйвера, который будет работать с этим устройством. Две другие характеристики —
USBDevice.deviceClassиUSBDevice.deviceProtocol. -
USBDevice.deviceVersionMajorТолько для чтения Экспериментальная -
Основной номер версии устройства в схеме семантического версионирования.
-
USBDevice.deviceVersionMinorТолько для чтения Экспериментальная -
Дополнительный номер версии устройства в схеме семантического версионирования.
-
USBDevice.deviceVersionSubminorТолько для чтения Экспериментальная -
Номер патча версии устройства в схеме семантического версионирования.
-
USBDevice.manufacturerNameТолько для чтения Экспериментальная -
Название организации, которая произвела USB-устройство.
-
USBDevice.openedТолько для чтения Экспериментальная -
Указывает, начата ли сессия с сопряжённым USB-устройством.
-
USBDevice.productIdТолько для чтения Экспериментальная -
Определяемый производителем код, идентифицирующий USB-устройство.
-
USBDevice.productNameТолько для чтения Экспериментальная -
Определяемое производителем имя, идентифицирующее USB-устройство.
-
USBDevice.serialNumberТолько для чтения Экспериментальная -
Определяемый производителем серийный номер конкретного USB-устройства.
-
USBDevice.usbVersionMajorТолько для чтения Экспериментальная -
Одна из трёх характеристик, которые объявляют версию USB-протокола, поддерживаемого устройством. Две другие характеристики —
USBDevice.usbVersionMinorиUSBDevice.usbVersionSubminor. -
USBDevice.usbVersionMinorТолько для чтения Экспериментальная -
Одна из трёх характеристик, которые объявляют версию USB-протокола, поддерживаемого устройством. Две другие характеристики —
USBDevice.usbVersionMajorиUSBDevice.usbVersionSubminor. -
USBDevice.usbVersionSubminorТолько для чтения Экспериментальная -
Одна из трёх характеристик, которые объявляют версию USB-протокола, поддерживаемого устройством. Две другие характеристики —
USBDevice.usbVersionMajorиUSBDevice.usbVersionMinor. -
USBDevice.vendorIdТолько для чтения Экспериментальная -
Официально назначенный usb.org идентификатор поставщика.
Методы экземпляра
-
USBDevice.claimInterface()Экспериментально -
Возвращает
Promise, который разрешается, когда запрошенный интерфейс затребован для эксклюзивного доступа. -
USBDevice.clearHalt()Экспериментально -
Возвращает
Promise, который разрешается, когда состояние «остановка» очищено. -
USBDevice.controlTransferIn()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBInTransferResult, когда команда или операция статуса переданы USB-устройству. -
USBDevice.controlTransferOut()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBOutTransferResult, когда команда или операция статуса переданы от USB-устройства. -
USBDevice.close()Экспериментально -
Возвращает
Promise, который разрешается, когда все открытые интерфейсы освобождены, и сессия устройства завершена. -
USBDevice.forget()Экспериментально -
Возвращает
Promise, который разрешается после того, как все открытые интерфейсы освобождены, сессия устройства завершена, и разрешение сброшено. -
USBDevice.isochronousTransferIn()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBIsochronousInTransferResult, когда информация, требующая высокой скорости передачи, передана USB-устройству. -
USBDevice.isochronousTransferOut()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBIsochronousOutTransferResult, когда информация, требующая высокой скорости передачи, передана от USB-устройства. -
USBDevice.open()Экспериментально -
Возвращает
Promise, который разрешается, когда сессия устройства запущена. -
USBDevice.releaseInterface()Экспериментально -
Возвращает
Promise, который разрешается, когда затребованный интерфейс освобождён от эксклюзивного доступа. -
USBDevice.reset()Экспериментально -
Возвращает
Promise, который разрешается, когда устройство сброшено, и все приложения с их обещаниями отменены. -
USBDevice.selectAlternateInterface()Экспериментально -
Возвращает
Promise, который разрешается, когда указанный альтернативный конечный пункт выбран. -
USBDevice.selectConfiguration()Экспериментально -
Возвращает
Promise, который разрешается, когда указанная конфигурация выбрана. -
USBDevice.transferIn()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBInTransferResult, когда данные пакетной или прерывистой передачи получены от USB-устройства. -
USBDevice.transferOut()Экспериментально -
Возвращает
Promise, который разрешается со значениемUSBOutTransferResult, когда данные пакетной или прерывистой передачи отправлены USB-устройству.
Спецификации
| Спецификация |
|---|
| API WebUSB # device-usage |
Совместимость с браузерами
| Настольные компьютеры | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
USBDevice |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | НетWebView предоставляет этот интерфейс, но не поддерживает WebUSB. См. ошибку 41441927. |
claimInterface |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
clearHalt |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
close |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
configuration |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
configurations |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
controlTransferIn |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
controlTransferOut |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceClass |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceProtocol |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceSubclass |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceVersionMajor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceVersionMinor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
deviceVersionSubminor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
forget |
101 | 101 | Нет | 87 | Нет | 101 | Нет | 70 | Нет | 19.0 | Нет |
isochronousTransferIn |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
isochronousTransferOut |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
manufacturerName |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
open |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
opened |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
productId |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
productName |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
releaseInterface |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
reset |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
selectAlternateInterface |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
selectConfiguration |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
serialNumber |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
|---|---|---|---|---|---|---|---|---|---|---|---|
transferIn |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
transferOut |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
usbVersionMajor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
usbVersionMinor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
usbVersionSubminor |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
vendorId |
61 | 79 | Нет | 48 | Нет | 61 | Нет | 45 | Нет | 8.0 | Нет |
worker_support |
118Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.70–118Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
118Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.79–118Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
Нет |
104Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.57–104Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
Нет |
118Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.70–118Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
Нет |
79Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.49–79Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
Нет |
25.0Доступно в выделенных работниках и работниках службы WebExtension, недоступно в общих работниках и обычных работниках службы.10.0–25.0Доступно в выделенных работниках, недоступно в общих работниках и работниках службы. |
НетWebView предоставляет этот интерфейс, но не поддерживает WebUSB. |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/USBDevice