Посмотрите, какой путь использует ссылка: переход в текущем окне, запрос нового окна или вызов узкого API приложения. Они могут обрабатываться разными механизмами. Начните с фиксированного разрешённого HTTPS-адреса и проверьте журнал решения main-процесса. Если намерение открыть ссылку не дошло до него, проблема ещё не в браузере по умолчанию.
Не исправляйте отказ открытием всех схем и адресов подряд. Electron предупреждает, что shell.openExternal нельзя вызывать с недоверенными данными без безопасной политики. Документация проверена 22 октября 2026 года. URL из страницы, сообщения или импортированного файла не становится доверенным от того, что пользователь нажал на него.
Три пути открытия требуют явного решения
| Путь | Какой результат определить |
|---|---|
| Навигация текущего окна | Разрешённый внутренний переход или отказ |
| Запрос нового окна | Запрет лишнего окна и разрешённый внешний переход |
| Кнопка приложения | Узкий bridge API с проверкой в main |
| Нестандартная схема | Отдельная явно разрешённая возможность, не общий fallback |
Официальный пример Electron показывает setWindowOpenHandler с решением deny и отдельным открытием безопасного адреса. Но это не автоматически обрабатывает все навигации текущего окна. Составьте карту реально используемых путей. Внешний сайт не следует просто загружать в привилегированное рабочее окно вместо системного браузера, чтобы кнопка перестала казаться сломанной.
Проверка URL выполняется до передачи ОС
Условная политика, не готовый валидатор:
получить намерение открыть адрес
разобрать URL библиотекой
проверить разрешённую схему и назначение
отклонить неоднозначный или запрещённый ввод
в main -> передать только одобренный адрес
сбой открытия -> понятная ошибка без исполнения обходной командыДля ссылок справки удобен ограниченный список назначений. Если продукт разрешает произвольные веб-сайты, сформулируйте отдельную политику HTTPS-переходов и обработку подтверждений. Проверка подстроки в исходном тексте адреса ненадёжна: сравнивайте разобранные компоненты. Не включайте командную оболочку как резервный способ открыть неподходящий протокол.
Ограничьте данные, доступные renderer. Ему не нужен универсальный метод запуска произвольных системных действий. Передайте конкретное намерение, например открыть разрешённую справку, а окончательное решение оставьте main. Ошибку логируйте без приватных query-параметров и токенов. Полный адрес из авторизационного потока нельзя бездумно писать в общий журнал.
Проверка отказа так же важна, как успешное открытие
- Обычная ссылка на разрешённую справку.
- Ссылка с пробелами и некорректной структурой.
- Запрещённая схема без запуска внешнего обработчика.
- Запрос нового окна без появления лишнего BrowserWindow.
- Отсутствие подходящего системного обработчика с понятным сообщением.
Проверяйте установленную сборку на каждой поддерживаемой платформе. Успех метода означает выполнение его документированного контракта, но не доказывает, что сайт загрузился или пользователь прочитал страницу. Интерфейсу полезнее сообщить об ошибке открытия и предложить безопасное копирование разрешённого адреса, чем зависнуть в ожидании несуществующего подтверждения посещения.
Для разбора подготовьте тип ссылки, путь её обработки и обезличенное решение проверки. Сохраните защитные настройки renderer и контекстную изоляцию. Если переход блокируется правилами продукта, исправлять нужно правило для конкретного допустимого назначения, а не отключать защиту всего приложения.