Electron не выдаёт renderer произвольный доступ ко всем USB-устройствам. В цепочке участвуют операционная система, WebUSB-запрос страницы, событие `select-usb-device` и политика разрешений Session. Если проверять только `navigator.usb.getDevices()`, можно увидеть пустой список просто потому, что текущему origin ещё ничего не разрешали.
Сначала подтвердите, что устройство видно в ОС и не занято драйвером или другой программой. Затем выполняйте `navigator.usb.requestDevice()` из пользовательского действия в том же renderer, где будет дальнейшая работа. Параллельно регистрируйте обработчики Session до загрузки окна, иначе первое событие выбора можно пропустить.
Найдите этап, на котором исчезает устройство
| Этап | Признак | Что проверить |
|---|---|---|
| Операционная система | Устройства нет в системном списке | Кабель, питание, драйвер, другой порт и захват процессом |
| requestDevice | Список пуст или сразу NotFoundError | filters, user gesture и поддерживаемость WebUSB |
| select-usb-device | Событие приходит без нужного элемента | vendorId, productId и protected class |
| Permission handler | Выбор есть, open запрещён | deviceType, origin и возвращаемое решение |
| Повторный запуск | Ранее выбранное устройство забыто | Хранение разрешения и правильную partition Session |
Снимайте только технические идентификаторы. Серийный номер способен быть постоянным идентификатором физического устройства, поэтому не отправляйте его в общую аналитику без необходимости. Для большинства ошибок достаточно vendorId, productId, origin, partition и результата каждого обработчика.
Обработчики должны жить в правильной Session
const { app, BrowserWindow, session } = require('electron');
app.whenReady().then(() => {
const ses = session.fromPartition('persist:device-ui');
ses.on('select-usb-device', (event, details, callback) => {
event.preventDefault();
const match = details.deviceList.find((device) =>
device.vendorId === 0x1234 && device.productId === 0x5678
);
callback(match ? match.deviceId : '');
});
ses.setPermissionCheckHandler((_webContents, permission) =>
permission === 'usb'
);
ses.setDevicePermissionHandler((details) =>
details.deviceType === 'usb' && details.origin === 'app://device-ui'
);
new BrowserWindow({
webPreferences: { partition: 'persist:device-ui' },
}).loadURL('app://device-ui');
});Пример показывает саму связку, а не готовую универсальную политику. Разрешение по одному только типу `usb` слишком широко для production: ограничьте доверенный origin и список поддерживаемых устройств. Проверьте фактические поля `details` на вашей версии Electron по текущей документации, особенно если обновляете крупную версию.
Фильтр requestDevice может скрыть исправное устройство
На время локальной диагностики сравните точный фильтр с заведомо правильными vendorId и productId. Ошибка в шестнадцатеричном числе, интерфейсе или classCode приводит к пустому выбору. Не переходите в production на полностью открытый список: фильтр одновременно улучшает интерфейс и уменьшает область доступных устройств.
Некоторые USB-классы защищены Chromium и по умолчанию недоступны. Electron предоставляет `setUSBProtectedClassesHandler`, но снятие защиты — решение с последствиями для безопасности, а не обычный шаг «чтобы заработало». Разрешайте только требуемый класс для доверенного приложения и тестируйте, не конфликтует ли он с системным драйвером.
Разовое и сохранённое разрешение — не одно и то же
Документация Electron отмечает, что стандартное разрешение устройства хранится в течение жизни соответствующего WebContents. Если выбор должен переживать перезапуск, приложение может сохранить решение при выборе и восстановить его через `setDevicePermissionHandler`. Храните минимальные данные и дайте пользователю понятный способ отозвать доступ.
- Не считайте `getDevices()` сканером всех подключённых устройств.
- Не подменяйте проверку разрешений выключением USB blocklist на всех машинах.
- Регистрируйте usb-device-added только в рамках активного select-usb-device: это не общий монитор USB.
- Обрабатывайте отключение устройства без зависания renderer и с понятным сообщением.
Контрольный тест без лишних переменных
Создайте отдельное окно с той же partition и одной кнопкой requestDevice. Подключите одно тестовое устройство, убедитесь, что оно попало в deviceList, было выбрано callback и прошло permission handlers. Затем отключите его во время безопасной тестовой операции и проверьте обработку ошибки. После перезапуска отдельно проверьте заявленную политику сохранения доступа.
Для отчёта нужны версия Electron, ОС, origin, partition, фильтры и обезличенный журнал решений обработчиков. Не прикладывайте пользовательские файлы с устройства и секреты приложения. Эта информация позволяет отличить проблему драйвера от неверной Session за несколько шагов.