Поддерживаемые переключатели командной строки

Переключатели командной строки, поддерживаемые Electron.

Вы можете использовать app.commandLine.appendSwitch, чтобы добавить их в основной скрипт вашего приложения до срабатывания события ready модуля app:

const { app } = require('electron')
app.commandLine.appendSwitch('remote-debugging-port', '8315')
app.commandLine.appendSwitch('host-rules', 'MAP * 127.0.0.1')

app.whenReady().then(() => {
  // Your code here
})

Флаги Electron CLI​

--auth-server-whitelist=url​

Список серверов, для которых включена интегрированная аутентификация, разделённый запятыми.

Например:

--auth-server-whitelist='*example.com, *foobar.com, *baz'

тогда любые url, заканчивающиеся на example.com, foobar.com, baz будут учитываться для интегрированной аутентификации. Без префикса * URL должен точно совпадать.

--auth-negotiate-delegate-whitelist=url​

Список серверов, для которых требуется делегирование учетных данных пользователя, разделённый запятыми. Без префикса * URL должен точно совпадать.

--disable-ntlm-v2​

Отключает NTLM v2 для платформ POSIX, не оказывает влияния в других случаях.

--disable-http-cache​

Отключает кэш на диске для HTTP-запросов.

--disable-http2​

Отключить протоколы HTTP/2 и SPDY/3.1.

--disable-renderer-backgrounding​

Предотвращает снижение приоритета процесса рендеринга невидимых страниц в Chromium.

Этот флаг глобален для всех процессов рендеринга. Если вы хотите отключить ограничение только в одном окне, можно воспользоваться обходным способом воспроизведения негромкой аудиозаписи.

--disk-cache-size=size​

Задает максимальный объем дискового пространства, используемого кэшем на диске, в байтах.

--enable-logging[=file]​

Выводит журналы Chromium в stderr (или в файл журнала).

Переменная среды ELECTRON_ENABLE_LOGGING имеет тот же эффект, что и передача --enable-logging.

Передача --enable-logging приведет к выводу журналов в stderr. Передача --enable-logging=file приведет к сохранению журналов в файл, указанный --log-file=..., или в electron_debug.log в каталоге данных пользователя, если --log-file не указан.

Примечание: В Windows журналы дочерних процессов не могут быть отправлены в stderr. Запись в файл — наиболее надежный способ сбора журналов в Windows.

См. также --log-file, --log-level, --v, и --vmodule.

--force-fieldtrials=trials​

Эксперименты, которые необходимо принудительно включить или отключить.

Например: WebRTC-Audio-Red-For-Opus/Enabled/

--host-rules=rules​

Список правил, разделённый запятыми, которые управляют тем, как отображаются имена хостов.

Например:

• MAP * 127.0.0.1 Принудительно отображает все имена хостов на 127.0.0.1
• MAP *.google.com proxy Принудительно отображает все поддомены google.com на "proxy".
• MAP test.com [::1]:77 Принудительно отображает "test.com" на IPv6-петлю. Также принудительно установит порт результирующего адреса сокета на 77.
• MAP * baz, EXCLUDE www.google.com Переназначит всё на "baz", за исключением "www.google.com".

Эти сопоставления применяются к имени хоста конечной точки в запросе сети (TCP-соединение и разрешение имен хоста в прямом соединении, и CONNECT в соединении с HTTP-прокси, и имя хоста конечной точки в соединении с SOCKS прокси).

--host-resolver-rules=rules​

Подобно --host-rules, но эти rules применяются только к разрешителю имен хоста.

--ignore-certificate-errors​

Игнорирует ошибки, связанные с сертификатом.

--ignore-connections-limit=domains​

Игнорирует ограничение соединений для domains списка, разделённого ,.

--js-flags=flags​

Указывает флаги, передаваемые движку Node.js. Их необходимо передавать при запуске Electron, если вы хотите включить flags в основном процессе.

$ electron --js-flags="--harmony_proxies --harmony_collections" your-app

См. документацию Node.js или выполните node --help в вашей консоли для получения списка доступных флагов. Кроме того, выполните node --v8-options для просмотра списка флагов, относящихся к движку JavaScript V8 Node.js.

--lang​

Установить пользовательский язык.

--log-file=path​

Если --enable-logging указан, журналы будут записаны в указанный путь. Родительская директория должна существовать.

Установка переменной среды ELECTRON_LOG_FILE эквивалентна передаче этого флага. Если оба присутствуют, приоритет имеет переключатель командной строки.

--log-net-log=path​

Включает сохранение событий журнала сети и записывает их в path.

--log-level=N​

Устанавливает подробность ведения журнала при использовании вместе с --enable-logging. N должен быть одним из уровней серьезности журнала Chrome.

Обратите внимание, что две взаимодополняющие механизмы ведения журнала в Chromium — LOG() и VLOG() — управляются различными переключателями. --log-level управляет сообщениями LOG(), а --v и --vmodule управляют сообщениями VLOG(). Таким образом, вы можете использовать комбинацию этих трех переключателей в зависимости от желаемой точности и вызовов ведения журнала, которые делает код, который вы хотите отслеживать.

См. исходный код Chromium Logging для получения дополнительной информации о том, как LOG() и VLOG() взаимодействуют. Грубо говоря, VLOG() можно рассматривать как подуровни/уровни по модулям внутри LOG(INFO) для управления потоком данных LOG(INFO).

См. также --enable-logging, --log-level, --v, и --vmodule.

--no-proxy-server​

Не использовать прокси-сервер и всегда создавать прямые соединения. Переопределяет любые другие флаги прокси-сервера, которые были переданы.

--no-sandbox​

Отключает песочницу Chromium sandbox. Принудительно запускает процессы рендеринга и вспомогательные процессы Chromium без песочницы. Следует использовать только для тестирования.

--proxy-bypass-list=hosts​

Инструктирует Electron обойти прокси-сервер для данного списка хостов, разделённого точкой с запятой. Этот флаг действует только при использовании вместе с --proxy-server.

Например:

const { app } = require('electron')
app.commandLine.appendSwitch('proxy-bypass-list', '<local>;*.google.com;*foo.com;1.2.3.4:5678')

Будет использовать прокси-сервер для всех хостов, кроме локальных адресов (localhost, 127.0.0.1 и т. д.), поддоменов google.com, хостов, содержащих суффикс foo.com, и всего, что находится на 1.2.3.4:5678.

--proxy-pac-url=url​

Использует скрипт PAC по указанному url.

--proxy-server=address:port​

Использует указанный прокси-сервер, что переопределяет системные настройки. Этот переключатель влияет только на запросы с протоколом HTTP, включая HTTPS и WebSocket-запросы. Также следует отметить, что не все прокси-серверы поддерживают HTTPS и WebSocket-запросы. Прокси-адрес не поддерживает аутентификацию по имени пользователя и паролю согласно проблеме Chromium.

--remote-debugging-port=port​

Включает удаленное отладку по HTTP на указанном port.

--v=log_level​

Устанавливает максимальный уровень активности V-логирования; 0 — значение по умолчанию. Обычно для уровней V-логирования используются положительные значения.

Этот переключатель работает только при --enable-logging.

См. также --enable-logging, --log-level, и --vmodule.

--vmodule=pattern​

Устанавливает максимальные уровни V-логирования на модуль, чтобы переопределить значение, заданное --v. Например, my_module=2,foo*=3 изменит уровень ведения журнала для всего кода в исходных файлах my_module.* и foo*.*.

Любой шаблон, содержащий прямую или обратную косую черту, будет проверяться по всему пути, а не только по модулю. Например, */foo/bar/*=2 изменит уровень логирования для всего кода в исходных файлах в каталоге foo/bar.

Этот переключатель работает только при --enable-logging.

См. также --enable-logging, --log-level, и --v.

--force_high_performance_gpu​

Принудительное использование дискретной графической карты, если доступно несколько графических карт.

--force_low_power_gpu​

Принудительное использование интегрированной графической карты, если доступно несколько графических карт.

Флаги Node.js​

Electron поддерживает некоторые из флагов командной строки, поддерживаемых Node.js.

Примечание: Передача неподдерживаемых переключателей командной строки в Electron, когда он не работает в ELECTRON_RUN_AS_NODE , не окажет никакого влияния.

--inspect-brk[=[host:]port]​

Активирует инспектор на host:port и останавливает выполнение в начале пользовательского скрипта. Значение по умолчанию host:port — 127.0.0.1:9229.

Алиас для --debug-brk=[host:]port.

--inspect-port=[host:]port​

Устанавливает host:port для использования при активации инспектора. Полезно при активации инспектора отправкой сигнала SIGUSR1. Значение по умолчанию host — 127.0.0.1.

Алиас для --debug-port=[host:]port.

--inspect[=[host:]port]​

Активирует инспектор на host:port. Значение по умолчанию — 127.0.0.1:9229.

Интеграция V8 инспектора позволяет таким инструментам, как Chrome DevTools и IDE, отлаживать и профилировать экземпляры Electron. Инструменты подключаются к экземплярам Electron через TCP-порт и взаимодействуют с помощью протокола Chrome DevTools.

Для получения дополнительной информации см. руководство Отладка основного процесса.

Алиас для --debug[=[host:]port.

--inspect-publish-uid=stderr,http​

Указывает способы экспонирования URL веб-сокета инспектора.

По умолчанию URL веб-сокета инспектора доступен в stderr и по адресу /json/list на http://host:port/json/list.