Electron не выдаёт renderer произвольный доступ ко всем USB-устройствам. В цепочке участвуют операционная система, WebUSB-запрос страницы, событие `select-usb-device` и политика разрешений Session. Если проверять только `navigator.usb.getDevices()`, можно увидеть пустой список просто потому, что текущему origin ещё ничего не разрешали.

Сначала подтвердите, что устройство видно в ОС и не занято драйвером или другой программой. Затем выполняйте `navigator.usb.requestDevice()` из пользовательского действия в том же renderer, где будет дальнейшая работа. Параллельно регистрируйте обработчики Session до загрузки окна, иначе первое событие выбора можно пропустить.

Найдите этап, на котором исчезает устройство

ЭтапПризнакЧто проверить
Операционная системаУстройства нет в системном спискеКабель, питание, драйвер, другой порт и захват процессом
requestDeviceСписок пуст или сразу NotFoundErrorfilters, 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 за несколько шагов.

Проверенные источники